Gabarit d’article unique

Un extrait dans une liste d’archives et le contenu complet d’un article ne se ressemblent pas : le second exige un gabarit distinct, capable d’afficher le texte intégral, l’image mise en avant en grand format, les métadonnées de l’auteur et de la date, et la zone de commentaires.

Comment WordPress le détermine

Dans un thème classique, la hiérarchie descend depuis single-{post_type}-{slug}.php jusqu’à single.php puis singular.php en dernier recours partagé avec les pages. Un thème bloc procède de façon comparable avec templates/single.html, éventuellement décliné par type de contenu comme single-produit.html pour une extension e-commerce.

Fonctions clés utilisées dans ce gabarit

the_title();
the_content();
the_post_thumbnail( 'large' );
comments_template();

Chaque fonction récupère une donnée précise de l’article en cours de traitement dans la boucle WordPress.

Pièges fréquents

• Utiliser the_excerpt() plutôt que the_content() dans un gabarit d’article unique tronque le texte, alors que l’inverse dans un gabarit d’archive alourdit inutilement la page de listing.
• Un type de contenu personnalisé sans gabarit single-{post_type} dédié retombe sur le gabarit générique, ce qui peut afficher des champs non pertinents pour ce type de contenu.
• Les commentaires ne s’affichent que si le thème appelle explicitement comments_template() et si l’article les autorise dans ses réglages de discussion.