La hiérarchie des templates

Le principe

Quand un visiteur accède à une URL, WordPress détermine quel type de contenu est demandé, puis cherche le template le plus spécifique disponible dans ton thème. Si ce template n'existe pas, il descend vers quelque chose de plus générique — jusqu'à index.php en dernier recours.

C'est ce qu'on appelle la hiérarchie des templates. C'est la règle la plus importante à connaître pour développer des thèmes.

Les grandes familles de pages

Page d'accueil

WordPress cherche dans cet ordre :

1. front-page.php — si une page d'accueil statique est définie dans Réglages
2. home.php — page de blog (liste des articles récents)
3. index.php

Page statique (ex. "À propos")

1. page-{slug}.php — ex. page-a-propos.php pour la page au slug "a-propos"
2. page-{id}.php — ex. page-42.php
3. page.php
4. singular.php
5. index.php

Article de blog (single post)

1. single-{post-type}-{slug}.php
2. single-{post-type}.php
3. single.php
4. singular.php
5. index.php

Archive (catégorie, tag, auteur…)

1. category-{slug}.php ou tag-{slug}.php
2. category-{id}.php ou tag-{id}.php
3. category.php ou tag.php
4. archive.php
5. index.php

Page de recherche

1. search.php
2. index.php

Page 404

1. 404.php
2. index.php

Exemple concret

Un visiteur accède à la catégorie "Tutoriels" (slug : tutoriels, ID : 5). WordPress cherche :

1. category-tutoriels.php — pas trouvé
2. category-5.php — pas trouvé
3. category.php — pas trouvé
4. archive.php — trouvé ! → utilise ce fichier

Si tu veux une mise en page spéciale pour cette catégorie uniquement, crée category-tutoriels.php. Pour toutes les catégories, category.php. Pour toutes les archives, archive.php.

Templates de parties : get_template_part()

Pour éviter la duplication de code, on peut découper les templates en parties réutilisables avec get_template_part() :

<?php get_template_part( 'template-parts/content', get_post_type() ); ?>

<!--
  Cherche d'abord : template-parts/content-post.php
  Puis :           template-parts/content.php
-->

C'est la même logique de hiérarchie, mais pour des parties de template. On l'utilise pour factoriser l'affichage d'un article dans index.php, archive.php et search.php.

Comment savoir quel template est utilisé ?

Installe le plugin Query Monitor (gratuit, dans le dépôt WordPress). Il affiche dans la barre admin le template actuellement utilisé, les hooks déclenchés et les requêtes SQL. Indispensable pour déboguer un thème.