WordPress
Hiérarchie de modèles

Remarques

introduction

Une des choses les plus importantes à apprendre lorsque vous créez un thème WordPress est la hiérarchie WordPress Template pour les thèmes. La hiérarchie de modèles définit quel fichier de modèle sera chargé pour chaque demande et dans quel ordre. Si le premier modèle n'existe pas dans la hiérarchie, WordPress essaiera de charger le suivant et ainsi de suite jusqu'à ce que vous vous index.php dans index.php .

Pour décrire la hiérarchie du modèle en détail, le mieux est bien sûr d’utiliser une image avec la structure complète:

La hiérarchie de modèles commence par les principaux types de pages comme l'archive, la page singulière ou la page d'accueil, puis les sous-types tels que l'archive d'auteur, l'archive de balises, la page ou le blog.

Après cela, nous trouverons les modèles réels qui seront chargés. D'abord, il existe les modèles les plus spécifiques qui utilisent des slugs ou des ID pour cibler des types d'archives ou des publications spécifiques.

Par exemple category-$slug.php qui ne cible que la catégorie avec un slug spécifique, par exemple category-books.php ne serait utilisé que pour la catégorie avec le slug book . Un autre exemple est page-$id.php qui ne cible qu'une page avec un identifiant spécifique, par exemple page-41.php ne ciblerait que la page avec l'ID 41.

Après les modèles qui ciblent des types ou des publications spécifiques, nous arrivons aux modèles de type générique, comme archive.php pour toutes les pages d'archive ou page.php pour toutes les pages. Mais souvenez-vous que ceux-ci ne seront utilisés que si la page en cours ne correspond à aucun des modèles les plus élevés de la hiérarchie.

Enfin, si WordPress n'a pu trouver aucun modèle correspondant dans le répertoire du modèle, le dernier repli est toujours index.php qui est le seul fichier de modèle requis dans un thème WordPress.

Le débogage

Il est facile de se perdre lors du débogage de la hiérarchie. Vous pouvez utiliser la commande debug_backtrace .

Mettez l'extrait de code suivant dans n'importe quel modèle que vous souhaitez déboguer et affichez la page générée:

<!--
<?php print_r( debug_backtrace() ) ?>
-->