Comparons deux hiérarchies : celle, bien connue, des thèmes classiques avec leurs fichiers PHP en cascade, et celle des thèmes hybrides, qui reprend exactement la même logique mais avec des fichiers HTML stockés dans un dossier templates. La question qui suit s’applique aux deux, mais se pose avec une acuité particulière sur une taxonomie personnalisée profondément imbriquée.
Ce billet s’adresse à un intégrateur qui doit faire correspondre un gabarit d’archive à une taxonomie sur mesure comportant plusieurs niveaux de sous-catégories. Il ne traite pas de la Query Loop qui affichera ensuite ces contenus à l’intérieur du gabarit sélectionné.
Le cas concret
Prenons une taxonomie personnalisée nommée filiere, utilisée pour classer des formations professionnelles, avec trois niveaux d’imbrication : « Industrie » contient « Métallurgie », qui contient elle-même « Soudure ». Sur la page d’archive du terme « Soudure », quel gabarit le thème sélectionne-t-il réellement parmi tous ceux disponibles ?
La hiérarchie applicable, du plus spécifique au plus général
Pour une taxonomie personnalisée, WordPress applique une hiérarchie de sélection qui reste identique, que le thème soit classique ou hybride :
taxonomy-filiere-soudure.html, ciblant précisément le terme « Soudure ».taxonomy-filiere.html, ciblant l’ensemble de la taxonomie « Filière », tous termes confondus.taxonomy.html, générique à toute taxonomie sans distinction.archive.html, générique à toute page d’archive du site.index.html, le filet de sécurité ultime, toujours présent dans un thème hybride valide.
La profondeur d’imbrication du terme, aussi importante soit-elle dans l’arborescence de la taxonomie, ne modifie en rien cette logique : WordPress ne cherche jamais un gabarit portant le nom d’un terme parent intermédiaire, comme taxonomy-filiere-metallurgie.html.
Ce qui surprend souvent
L’erreur fréquente consiste à créer un gabarit portant le nom du terme parent, « Métallurgie », en imaginant qu’il s’appliquera aux sous-termes comme « Soudure » par héritage. Ce n’est pas le cas : seul un gabarit portant exactement le slug du terme consulté, ou l’un des gabarits plus génériques de la liste ci-dessus, sera sélectionné.
// Ne fonctionne PAS pour le terme "soudure",
// même si "soudure" est un enfant de "metallurgie"
templates/taxonomy-filiere-metallurgie.html
// Fonctionne précisément pour le terme "soudure"
templates/taxonomy-filiere-soudure.htmlVérifier la sélection réelle
Sur un thème hybride, l’inspecteur de gabarit de l’éditeur de site indique, pour chaque page consultée, quel gabarit a été effectivement sélectionné. Cette information reste le moyen le plus fiable de vérifier une hypothèse, plutôt que de déduire la sélection uniquement à partir de la liste des fichiers présents dans le thème.
Une hiérarchie de gabarits bien comprise théoriquement mérite toujours d’être vérifiée concrètement sur le terme le plus profond de l’arborescence — c’est là que les suppositions erronées se révèlent le plus souvent.
Une stratégie pour les taxonomies profondément imbriquées
Plutôt que de multiplier les gabarits spécifiques à chaque terme, ce qui devient vite ingérable sur une taxonomie à plusieurs niveaux, une approche plus robuste consiste à s’appuyer sur un unique gabarit générique taxonomy-filiere.html, puis à adapter son contenu dynamiquement selon le terme consulté, à l’intérieur même du gabarit, via les blocs disponibles.
- Un seul gabarit à maintenir, plutôt qu’un par terme de la taxonomie.
- Une adaptation du contenu au niveau du bloc plutôt qu’au niveau du gabarit.
- Une gestion simplifiée le jour où de nouveaux termes sont ajoutés à la taxonomie.
En résumé
La hiérarchie de sélection d’un gabarit d’archive ne tient jamais compte des relations parent-enfant à l’intérieur d’une taxonomie : seul le slug exact du terme consulté, ou l’un des niveaux plus génériques de la hiérarchie, entre en jeu. Comprendre cette règle évite de multiplier inutilement les fichiers de gabarit sur une taxonomie profondément imbriquée.
