# Gabarit d’article unique

> Le gabarit responsable de l'affichage détaillé d'un article individuel, incluant son titre, son contenu complet et ses métadonnées.

- Auteur : Clément Hadrot
- Publié le : 2026-09-25
- Mis à jour le : 2026-09-25
- URL : https://wpmoderne.dev.wordpress-developpement.fr/lexique/gabarit-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.