# Gabarit d’archive

> Le gabarit utilisé pour afficher une liste d'articles regroupés par catégorie, étiquette, auteur, date ou type de contenu personnalisé.

- Auteur : Clément Hadrot
- Publié le : 2026-09-25
- Mis à jour le : 2026-09-25
- URL : https://wpmoderne.dev.wordpress-developpement.fr/lexique/gabarit-archive/

Consulter tous les articles d'une même catégorie, tous les billets d'un auteur donné, ou tout le contenu publié en un mois précis : ces pages de listing partagent une même logique de rendu, prise en charge par le gabarit d'archive plutôt que par un fichier différent pour chaque cas.

## Sélection dans la hiérarchie des gabarits

Dans un thème classique, WordPress cherche d'abord un fichier spécifique comme `category-{slug}.php` ou `author-{nicename}.php`, avant de retomber sur `archive.php` puis `index.php` si rien de plus précis n'existe. Dans un thème bloc, le fichier `templates/archive.html` joue ce rôle générique, avec des variantes possibles comme `archive-{post_type}.html` pour un type de contenu personnalisé.

## Requête WordPress typique en coulisses

```
// Boucle utilisée dans archive.php
if ( have_posts() ) {
    while ( have_posts() ) {
        the_post();
        the_title();
    }
}
```

## À ne pas confondre avec

- Un gabarit d'article unique affiche un seul contenu en détail ; un gabarit d'archive affiche une liste d'extraits ou de résumés de plusieurs contenus.
- La page définie comme « Page d'accueil statique » dans les réglages de lecture n'utilise pas le gabarit d'archive même si elle liste des articles : elle passe par le gabarit de page.
- Une taxonomie personnalisée peut nécessiter son propre gabarit d'archive (`taxonomy-{taxonomie}.php` ou équivalent bloc) si l'affichage par défaut ne convient pas.