Hiérarchie des templates

La hiérarchie des templates dans WordPress est un mécanisme qui détermine l’ordre d’affichage des fichiers modèles géré par le moteur de thème de WordPress.

Lorsqu’une page est chargée, WordPress suit un processus de recherche spécifique pour trouver le fichier de modèle approprié à utiliser.

Comment fonctionne la hiérarchie des templates ?

Les 10 personnalisations principales sont les suivant par ordre de priorité :

  1. Template de page personnalisé : Si vous avez défini un modèle de page personnalisé pour une page spécifique dans l’éditeur de page de WordPress, WordPress utilisera ce modèle en priorité. Le fichier de modèle sera nommé en fonction du slug de la page, par exemple page-mapage.php.
  2. Template de page par identifiant : Si vous avez créé un modèle de page personnalisé basé sur l’identifiant de la page, WordPress utilisera ce modèle s’il existe. Le fichier de modèle sera nommé en fonction de l’identifiant de la page, par exemple page-10.php pour la page avec l’identifiant 10.
  3. Template de page par slug : Si vous avez créé un modèle de page personnalisé basé sur le slug de la page, WordPress utilisera ce modèle s’il existe. Le fichier de modèle sera nommé en fonction du slug de la page, par exemple page-a-propos.php pour une page avec le slug « a-propos ».
  4. Template de page par type de page : Si aucun modèle de page personnalisé n’est trouvé, WordPress recherche un modèle basé sur le type de page. Par exemple, si la page est une page d’archives, WordPress utilisera archive.php. Si c’est une page de recherche, WordPress utilisera search.php.
  5. Template de page par hiérarchie parente : Si aucun des modèles précédents n’est trouvé, WordPress recherche un modèle basé sur la hiérarchie parente de la page. Par exemple, si la page enfant est rattachée à une page parente ayant le slug « services », WordPress utilisera page-services.php.
  6. Template d’article par défaut : Si aucun des modèles précédents n’est trouvé, WordPress utilisera le modèle par défaut single.php.
  7. Template de page par défaut : Si aucun des modèles précédents n’est trouvé, WordPress utilisera le modèle par défaut page.php.
  8. Page d’accueil statique : Si vous avez défini une page d’accueil statique dans les paramètres de lecture de WordPress, WordPress recherche d’abord un fichier de modèle spécifique pour cette page. Le fichier de modèle sera nommé front-page.php
  9. Blog d’accueil : Si vous avez choisi d’afficher les articles de blog sur la page d’accueil dans les paramètres de lecture, WordPress recherche un fichier appelé home.php.
  10. Template d’index : Si aucun des modèles spécifiques de page n’est trouvé, WordPress utilisera le fichier index.php qui sert de modèle par défaut pour l’affichage du contenu.

Ressources

Documentation officielle

Aperçu visuel de la hiérarchie de templates WordPress