Modèles

1

Les modèles, ou en anglais templates, sont certains des fichiers .php se trouvant à la racine d'un thème.

Ces fichiers permettent de changer l'apparence de vos pages.

Création

Pour créer un modèle, il suffit de créer un fichier .php à la racine du thème. Dans ce fichier, immédiatement après la déclaration <?php, un commentaire permet d'indiquer à Wordpress le nom du modèle.

Par exemple:

/**
 * 	Template Name: Nom du template
 */

Wordpress sera ainsi en mesure de détecter ce fichier. Par la suite, lors de l'édition d'une page, dans la barre latérale de droite, dans la section:

Attributs de page ➡️ Modèle

Le nom donné au modèle dans le commentaire apparaîtra comme option de modèle dans le menu déroulant.

Idéalement, un nom similaire entre le modèle et le fichier .php permet de simplifier le débogage.

Hiérarchie

Wordpress tente de déterminer quel modèle afficher lors de l'appel d'une page en suivant une hiérarchie particulière 👑.

Pages 📄

Par exemple, avec l'url exemple.com/portfolio

Wordpress tentera de valider en ordre si:

  1. Un modèle a été attribué via le tableau de bord.
  2. page-portfolio.php existe à la racine du thème.
  3. page-7.php existe. (Si l'id de la page est 7).
  4. Le fichier générique page.php est présent.
  5. singular.php existe.
  6. index.php existe.

Accueil

La page d'accueil est particulière. Par défaut, WordPress lui attribue son propre modèle affichant normalement les plus récents articles. Il est néanmoins possible de changer cette configuration dans le tableau de bord via:

Réglage ➡️ Lecture

  • home.php
  • index.php

404

  1. 404.php
  2. index.php

Articles (Posts)

Les articles suivent une hiérarchie légèrement différente.

Par exemple, avec l'url exemple.com/bonjour-tout-le-monde

Wordpress tente de valider en ordre si:

  1. single-post-bonjour-tout-le-monde.php existe.
    Ce nom de fichier provient:
    • du préfixe single.
    • du type de post, dans cet exemple celui par défaut post.
    • et du slug de l'article bonjour-tout-le-monde
  2. single-post.php existe. Ce nom, comme le précédent, provient du préfix single et du type de post. Par exemple: si ce type avait été superhero, le fichier appelé aurait été single-superhero.php.
  3. single.php si aucun modèle spécifique n'est trouvé.
  4. ensuite singular.php
  5. et finalement index.php

Le fichier index.php est en quelque sorte le fichier de la dernière chance.

Pour plus d'informations sur toutes les hiérarchies de Wordpress, consulter developer.wordpress.org/themes/basics/template-hierarchy

Donnez votre opinion
sur les notes de cours sur cette page.
Merci d'avoir partagé ton opinion 😎
Pssst, c'est 💯 anonyme