Mémos

M é m o - l a b .

Template hierarchy

Il s’agit du processus WordPress permettant de définir quel fichier (template) du thème est choisi pour l’affichage du site à l’appel d’une requête. Un schéma en ligne du template hierarchy est disponible ici. Afin de le rendre plus digest, le schéma du template hiérarchy abordé dans ce chapitre est un modèle simplifié.

Cas de figure où l’appel de l’url du site affiche les derniers articles (configuration par défaut dans Admin > Réglages > Lecture). Je demande l’affichage de mon site (https://nom_de_domaine ou localhost/mon_site).
Quel template sera affiché ?
Dans un premier temps, le fichier front-page.php sera appelé. S’il n’existe pas, le fichier home.php sera appelé. S’il n’existe pas, le fichier index.php sera appelé.
Rqe : dans ce cas de figure, la loop de WP affiche la liste des articles.

Cas de figure où l’appel de l’url du site affiche une page d’accueil (dans admin, créer une page dont le titre sera Accueil par exemple, puis aller dans Réglages > Lecture et choisir Accueil comme « page d’accueil »). Je demande l’affichage de mon site (https://nom_de_domaine ou localhost/mon_site).
Quel template sera affiché ?
Dans un premier temps, le fichier front-page.php sera appelé. S’il n’existe pas, le fichier page-{slug}.php (page-accueil.php dans notre cas) sera appelé. S’il n’existe pas, le fichier page.php sera appelé. S’il n’existe pas, le fichier index.php sera appelé.
Rqe : dans ce cas de figure, la loop de WP affiche le contenu de la page.

Cas de figure où l’appel de l’url du site affiche une page dédiée aux articles (dans admin, créer une page dont le titre sera Blog par exemple, puis aller dans Réglages > Lecture et choisir Blog comme « page des articles »). Je demande l’affichage de cette page choisie comme page des articles.
Quel tempate sera affiché ?
Dans un premier temps, le fichier home.php sera appelé. S’il n’existe pas, le fichier index.php sera appelé.
Rqe: dans ce cas de figure, la loop de WP affiche la liste des articles.

Page

Lorsque l’on affiche une page, autre que les pages définies comme « page d’accueil » ou « page des articles », la hiérarchie des templates est la suivante : page-$slug.php > page-$slug.php > page.php > index.php.

Single

Lorsque l’on souhaite afficher un article à partir d’un lien dont la valeur de l’attribut href est the_permalink(), la hiérarchie des templates est la suivante : single-$posttype-$slug > single-$posttype.php > single.php > index.php.
Dans le cas de l’utilisation d’un CPT (Custom Post Type), le fichier appelé est single-nom_du_cpt.php.

Search

Les résultats liés au moteur de recherche WP s’affichent dans le template search.php.

Catégorie

Un chapitre est dédié aux taxonomies. La hiérarchie du template cible sera : category-$slug.php > category-$id.php > category.php > archive.php > index.php.

Taxonomie

Un chapitre est dédié aux taxonomies. La hiérarchie du template cible sera : taxonomie-$taxonomy-$term.php > taxonomy-$taxonomy.php > taxonomy.php > archive.php > index.php.

Auteur

L’affichage de l’auteur d’un article sous forme de lien dans la loop WordPress se fait en utilisant la fonction the_author_posts_link(). Le click sur ce lien a pour but d’afficher tous les articles écrits par cet auteur. La hiérarchie du template cible sera : author-$authorname.php > author-$authorid.php > author.php > archive.php > index.php.

CPT

Pour l’affichage de la liste d’un type de contenu personnalisé (cpt), la hiérarchie du template cible sera : archive-$nomducpt.php > archive.php > index.php.

Date

L’affichage de la date d’un article sous forme de lien dans la loop WordPress se fait en utilisant la fonction get_day_link(get_the_time(‘Y’), get_the_time(‘m’), get_the_time(‘d’)). Le click sur ce lien a pour but d’afficher tous les articles correspondant à cette date. La hiérarchie du template cible sera : date.php > archive.php > index.php.

Erreur 404

L’erreur 404 s’affiche dans le template 404.php.