16.2 Les fichiers modèles (template files)

Avec un thème WordPress traditionnel, chaque page d'un site WordPress est bâtie à l'aide de fichiers modèles. Il s'agit de fichiers contenant des balises HTML et du code PHP et qui permettent d'afficher une section particulière de la page Web.

Remarquez qu'avec un thème WordPress basé sur des blocs, l'approche est complètement différente.

Regardons tout de même comment fonctionnent les fichiers modèles avec un thème traditionnel.

Les fichiers modèles sont placés dans le dossier du thème :

     www\monsite\wp-content\themes\nomdutheme

Les thèmes ne définissent pas tous les même fichiers modèles. Voici quelques fichiers modèles pouvant faire partie d'un thème WordPress :

• index.php
• home.php
• page.php
• content.php
• header.php
• footer.php
• sidebar.php
• searchform.php
• search.php
• 404.php
• etc.

Le fichier index.php doit obligatoirement être présent dans le thème ou dans son thème parent.

À titre indicatif, les images suivantes montrent les fichiers présents dans différents thèmes.

Il s'agit de thèmes qui n'ont pas hérité d'un autre thème.

Si on avait un thème enfant, il pourrait n'y avoir aucun fichier modèle.

Hiérarchie des fichiers modèles

Le noyau WordPress se basera sur l'URL de la page à afficher pour déterminer le type de page à afficher : page d'accueil, page d'un article, page de catégorie, etc. Il saura ainsi quel fichier modèle il doit appeler.

Notez que tous les fichiers modèles ne sont pas nécessairement appelés par le noyau WordPress. Certains sont appelés par un autre fichier modèle. Par exemple, le fichier index.php pourra appeler header.php, footer.php et sidebar.php. Dans plusieurs thèmes, le fichier sidebar.php appellera searchform.php et ainsi de suite.

Il existe une hiérarchie dans les fichiers modèles WordPress. Voici quelques exemples de la logique que WordPress suivra pour choisir le fichier à exécuter :

• Si WordPress comprend qu'il doit afficher la page d'accueil :
  • il recherchera la présence du fichier modèle home.php;
  • s'il ne le trouve pas, il recherchera index.php. 
• Si WordPress détecte que la page à afficher correspond à un article :
  • il recherchera le fichier single.php;
  • s'il ne le trouve pas, il exécutera le code de index.php.
• Lorsqu'il doit afficher une page (rappel : on peut créer des pages et des articles) :
  • il tentera de retrouver le modèle précis pour lequel la page a été bâtie (on pourrait par exemple avoir un modèle à deux colonnes et un autre à une seule colonne);
  • si c'est impossible, il exécutera page.php;
  • en son absence, il exécutera index.php.
• Si WordPress doit afficher les articles d'une catégorie :
  • il recherchera category.php;
  • en son absence, il recherchera archive.php;
  • si ce fichier n'est pas présent lui non plus, c'est encore une fois index.php qui sera exécuté.

Le schéma suivant, tiré de https://codex.wordpress.org/fr:Hi%C3%A9rarchie_des_fichiers_mod%C3%A8les, montre la hiérarchie des fichiers modèles :

Pour plus d'information

« Stepping into Templates ». WordPress. https://codex.wordpress.org/Stepping_Into_Templates

« fr:Hiérarchie des fichiers modèles ». Codex WordPress. http://codex.wordpress.org/fr:Hi%C3%A9rarchie_des_fichiers_mod%C3%A8les