Templates d’archives par taxonomie : taxonomy-{tax}.html et variantes par terme

Un client possédant un site de recettes de cuisine voulait un rendu différent pour l’archive de sa taxonomie « Type de plat » (entrée, plat, dessert) et pour celle de « Régime alimentaire » (végétarien, sans gluten). Deux taxonomies personnalisées, deux besoins visuels distincts — largement au-delà de ce qu’un unique archive.html générique pouvait raisonnablement couvrir.

La hiérarchie de templates pour une taxonomie, du plus précis au plus général

Un thème bloc suit, pour une page d’archive de taxonomie, une hiérarchie de fichiers dans le dossier templates/, du plus spécifique au plus général :

1. taxonomy-{taxonomie}-{terme}.html — un gabarit dédié à un terme précis d’une taxonomie donnée, par exemple taxonomy-type-de-plat-dessert.html.
2. taxonomy-{taxonomie}.html — un gabarit pour l’ensemble des termes d’une taxonomie donnée, par exemple taxonomy-type-de-plat.html.
3. taxonomy.html — un gabarit générique pour toute taxonomie ne disposant pas de fichier plus spécifique.
4. archive.html — le repli final, partagé avec les archives d’auteur et de type de contenu si aucun gabarit plus ciblé n’existe.

Cette logique reproduit, au format bloc, la hiérarchie de templates PHP historique de WordPress — la fonction interne qui détermine le fichier à charger reste la même, seule la nature des fichiers cherchés (HTML plutôt que PHP) change avec un thème bloc.

Étape par étape : déclarer une variante par terme précis

1. Dans l’éditeur de site, ouvrez Templates > Ajouter un nouveau template.
2. Choisissez Archive de taxonomie puis sélectionnez la taxonomie concernée, ici « Type de plat ».
3. Un second choix apparaît, listant les termes existants de cette taxonomie — sélectionnez « Dessert » pour créer un gabarit propre à ce seul terme.
4. WordPress enregistre alors ce template avec la bonne cible de spécificité (visible dans la zone Modèle des réglages du template), ce qui correspond, une fois exporté, au fichier taxonomy-type-de-plat-dessert.html.
5. Composez ce gabarit avec, par exemple, une image d’illustration adaptée aux desserts et un bloc Requête filtré sur ce terme précis, distinct de ce que proposerait le gabarit générique des autres types de plat.

Où l’export range effectivement les fichiers

mon-theme/
├── templates/
│   ├── taxonomy-type-de-plat-dessert.html
│   ├── taxonomy-type-de-plat.html
│   ├── taxonomy-regime-alimentaire.html
│   ├── taxonomy.html
│   └── archive.html
└── theme.json

Notez que taxonomy-type-de-plat.html couvre déjà tous les autres termes de cette même taxonomie (entrée, plat) sans qu’il soit nécessaire de créer un fichier par terme si seul le dessert a besoin d’un traitement à part.

Piège fréquent : un slug de taxonomie trop long ou modifié après coup

Le nom de fichier reprend le slug technique de la taxonomie et du terme, pas leur libellé affiché. Renommer un terme depuis l’interface ne renomme pas automatiquement le fichier de template déjà exporté, qui continue de cibler l’ancien slug tant qu’il n’est pas mis à jour manuellement — un décalage qui peut faire disparaître silencieusement le gabarit dédié après un renommage de terme fait sans y prêter attention.

Bonnes pratiques pour un site à plusieurs taxonomies personnalisées

• Créer systématiquement le niveau taxonomy-{taxonomie}.html, même quand un seul terme a, pour l’instant, besoin d’un traitement spécifique — cela évite de retomber sur le générique taxonomy.html, souvent trop pauvre, pour les autres termes.
• Garder archive.html suffisamment neutre puisqu’il sert aussi de repli pour les archives d’auteur et de date, pas uniquement pour les taxonomies.
• Documenter, en commentaire dans le thème ou dans la documentation projet, la correspondance entre chaque fichier et le terme ou la taxonomie visée — un développeur qui reprend le projet plus tard n’a autrement aucun moyen simple de deviner cette intention.

En résumé

La hiérarchie de templates par taxonomie d’un thème bloc offre quatre niveaux de spécificité, du gabarit générique archive.html jusqu’au gabarit dédié à un terme précis. Bien exploitée, elle évite la multiplication de conditions dans un unique template générique — au prix d’une vigilance particulière sur la stabilité des slugs de taxonomie et de terme dans le temps.