Hiérarchie des modèles

La hiérarchie des modèles de WordPress est le système utilisé pour déterminer quel(s) fichier(s) modèle(s) utiliser pour afficher une page donnée sur un site web. Cette hiérarchie permet une grande flexibilité et une personnalisation de l’affichage des différents types de contenu, des pages, des articles et des catégories sur votre site. Comprendre le fonctionnement de la hiérarchie des modèles vous aidera à personnaliser efficacement votre thème WordPress.

Voici un aperçu détaillé du fonctionnement de la hiérarchie des modèles WordPress:

Qu’est-ce que la hiérarchie des modèles WordPress ?

La hiérarchie des modèles est un ensemble de règles que WordPress suit pour choisir le(s) fichier(s) modèle(s) à utiliser lors du rendu d’une page. Ces modèles sont stockés dans le dossier de votre thème et permettent à WordPress de générer dynamiquement la bonne mise en page et le bon design en fonction du type de contenu affiché.

En voici un exemple :

• Lors de l’affichage d’un seul article de blog, WordPress cherchera d’abord un modèle appelé single.php. S’il ne le trouve pas, il descend dans la hiérarchie, cherchant des alternatives comme index.php.
• Lors de l’affichage d’une page de catégorie, WordPress cherchera d’abord category-slug.php ou category-ID.php, et ainsi de suite.

Fichiers modèles de base dans WordPress

Chaque thème WordPress possède quelques fichiers modèles essentiels. Voici les plus courants :

• index.php : Le modèle de repli pour toutes les pages si aucun autre modèle plus spécifique n’est disponible.
• header.php : Définit la section de l’en-tête de votre site (par exemple, le logo, la navigation).
• footer.php : Définit la section du pied de page de votre site (par exemple, informations sur les droits d’auteur, widgets de pied de page).
• single.php : Affiche un seul article de blog.
• page.php : Affiche des pages individuelles.
• archive.php : Affiche les pages d’archives (par exemple, les catégories, les tags, les auteurs).
• category.php : Affiche les pages d’archives des catégories : Affiche les pages d’archives des catégories.
• tag.php : Affiche les pages d’archives des tags : Affiche les pages d’archives des tags.
• search.php : Affiche les pages d’archives des tags : Affiche les pages de résultats de recherche.
• 404.php : Affiche une page d’erreur 404 lorsqu’une page n’est pas trouvée : Affiche une page d’erreur 404 lorsqu’une page n’est pas trouvée.

Comment fonctionne la hiérarchie des modèles WordPress

WordPress détermine le modèle à utiliser en fonction du type de contenu demandé. Passons en revue quelques types de pages courantes et la manière dont WordPress sélectionne le modèle :

1. Article unique (single.php)

Lors de l’affichage d’un article unique, WordPress recherchera les modèles suivants dans cet ordre :

1. single-{post-type}.php (pour les types d’articles personnalisés, par exemple, single-product.php)
2. single.php
3. index.php

2. Page (page.php)

Lors de l’affichage d’une page individuelle (comme une page “A propos de nous” ou “Contact”), WordPress suivra cet ordre :

1. custom-page-slug.php (si la page a un modèle personnalisé)
2. page-{slug}.php (par exemple, page-about.php)
3. page-{ID}.php (par exemple, page-2.php)
4. page.php
5. index.php

3. Archives des catégories (category.php)

Pour les pages d’archives de catégories (par exemple, une liste d’articles dans une catégorie spécifique), la hiérarchie est la suivante :

1. category-{slug}.php (par exemple, category-news.php)
2. category-{ID}.php (par exemple, category-3.php)
3. catégorie.php
4. archive.php
5. index.php

4. Archives des balises (tag.php)

Pour les pages d’archives de balises, WordPress utilise :

1. tag-{slug}.php (par exemple, tag-recipes.php)
2. tag-{ID}.php
3. tag.php
4. archive.php
5. index.php

5. Types d’articles personnalisés

Les types d’articles personnalisés peuvent avoir leurs propres modèles. WordPress recherche :

1. single-{post-type}.php (par exemple, single-product.php)
2. single.php
3. index.php

De même, pour les archives de types d’articles personnalisés :

1. archive-{post-type}.php (par exemple, archive-produit.php)
2. archive.php
3. index.php

6. Archives des auteurs (author.php)

Pour les pages d’auteur, WordPress suit cette hiérarchie :

1. auteur-{nom de famille}.php (par exemple, auteur-john.php)
2. auteur-{ID}.php
3. author.php
4. archive.php
5. index.php

7. Résultats de la recherche (search.php)

Lors de l’affichage des résultats de la recherche, WordPress utilise l’ordre suivant :

1. search.php
2. index.php

8. page d’erreur 404 (404.php)

Lorsqu’une page n’est pas trouvée, WordPress utilise :

1. 404.php
2. index.php

9. Archive des dates (date.php)

Pour les archives basées sur la date, WordPress utilise :

1. date.php
2. archive.php
3. index.php

10. Page d’accueil

WordPress propose deux options pour la page d’accueil : l’index du blog ou une page statique.

• Pour l’index du blog :
  1. home.php
  2. index.php
• Pour une page d’accueil statique :
  1. front-page.php
  2. home.php
  3. page.php
  4. index.php

Représentation visuelle de la hiérarchie des modèles

Voici un flux visuel simplifié pour mieux comprendre la hiérarchie :

• Article unique : single-{post-type}.php → single.php → index.php
• Page : custom-page-slug.php → page-{slug}.php → page.php → index.php
• Category Archive : category-{slug}.php → category.php → archive.php → index.php
• Tag Archive : tag-{slug}.php → tag.php → archive.php → index.php
• Author Archive : author-{nicename}.php → author.php → archive.php → index.php
• Résultats de la recherche : search.php → index.php
• erreur 404 : 404.php → index.php
• Page d’accueil : front-page.php → home.php → index.php

Personnalisation de la hiérarchie des modèles

Vous pouvez créer des modèles personnalisés en suivant les conventions de dénomination de la hiérarchie. Par exemple, pour créer un modèle personnalisé pour une catégorie spécifique (par exemple, “Actualités”), créez un fichier nommé category-news.php et placez-le dans le dossier de votre thème. WordPress utilisera automatiquement ce modèle pour afficher les articles de la catégorie “Actualités”.

En outre, vous pouvez remplacer les modèles par défaut en créant des fichiers de modèles plus spécifiques, tels que single-product.php pour un type d’article personnalisé ou page-about.php pour une page spécifique.

Conseils pour travailler avec la hiérarchie des modèles

1. Utiliser des balises conditionnelles : Vous pouvez utiliser des balises conditionnelles telles que is_single(), is_page() ou is_category() dans le fichier index.php ou dans d’autres modèles pour appliquer un code spécifique à certains types de contenu.
2. Parties de modèles : Utilisez get_template_part() pour inclure des extraits de code réutilisables (par exemple, un en-tête ou un pied de page commun) dans plusieurs modèles.
3. Thèmes enfants : Si vous apportez des modifications à un thème existant, créez un thème enfant afin de pouvoir modifier les modèles sans affecter les fichiers du thème original.
4. Débogage : Si vous n’êtes pas sûr du modèle utilisé par WordPress pour une page particulière, vous pouvez utiliser des plugins comme What The File pour le découvrir.

Conclusion

La hiérarchie des modèles WordPress est un système puissant qui donne aux développeurs la possibilité de créer des mises en page personnalisées pour différents types de contenu. En comprenant la hiérarchie, vous pouvez contrôler la façon dont votre site WordPress affiche les différents types de contenu, assurant ainsi une expérience utilisateur cohérente et unique. Que vous créiez des modèles personnalisés pour des pages spécifiques ou que vous personnalisiez la mise en page des archives, la maîtrise de la hiérarchie des modèles vous donnera le contrôle nécessaire pour peaufiner votre site WordPress.