WordPress.org (Français)

comme discuté, les fichiers de modèle sont des fichiers modulaires, réutilisables, utilisés pour générer les pages web sur votre site WordPress. Certains fichiers de modèle (tels que le modèle d’en-tête et de pied de page) sont utilisés sur toutes les pages de votre site, tandis que d’autres ne sont utilisés que dans des conditions spécifiques.

Cet article explique comment WordPress détermine quel(S) fichier (s) Modèle (s) utiliser sur des pages individuelles. Si vous souhaitez personnaliser un thème WordPress existant, il vous aidera à décider quel fichier de modèle doit être modifié.,

la hiérarchie des fichiers Modèles #la hiérarchie des fichiers modèles

aperçu #aperçu

WordPress utilise la chaîne de requête pour décider quel modèle ou ensemble de Modèles doit être utilisé pour afficher la page. La chaîne de requête est une information contenue dans le lien vers chaque partie de votre site web. Il vient après le point d’interrogation initial et peut contenir un certain nombre de paramètres séparés par des esperluettes.,

en termes simples, WordPress recherche dans la hiérarchie des modèles jusqu’à ce qu’il trouve un fichier de modèle correspondant. Pour déterminer quel fichier de modèle utiliser, WordPress:

1. associe chaque chaîne de requête à un type de requête pour décider quelle page est demandée (par exemple, une page de recherche, une page de catégorie, etc.);
2. sélectionne le modèle dans l’ordre déterminé par la hiérarchie des modèles;
3. recherche les fichiers de modèle avec des noms spécifiques dans le répertoire du thème actuel et utilise le premier fichier de modèle correspondant tel que spécifié par la hiérarchie.,

à l’exception du fichier modèle de baseindex.php, vous pouvez choisir si vous souhaitez implémenter un fichier modèle particulier ou non.

Si WordPress ne trouve pas de fichier modèle avec un nom correspondant, il passera au fichier suivant dans la hiérarchie. Si WordPress ne trouve aucun fichier de modèle correspondant, le fichier index.php du thème sera utilisé.,

Top

Examples #Examples

Si votre blog se trouve à et qu’un visiteur clique sur un lien vers une page de catégorie telle que, WordPress recherche un fichier modèle dans le répertoire du thème actuel qui correspond à l’ID de la catégorie pour générer la bonne page. Plus précisément, WordPress suit cette procédure:

1. recherche un fichier modèle dans le répertoire du thème actuel qui correspond au slug de la catégorie. Si la catégorie slug est « licornes”, WordPress recherche un fichier modèle nommé category-unicorns.php.,
2. Sicategory-unicorns.php est manquant et que L’ID de la catégorie est 4, WordPress recherche un fichier modèle nommécategory-4.php.
3. Si category-4.php est manquant, WordPress va chercher une catégorie générique fichier de modèle, category.php.
4. Si category.php n’existe pas, WordPress va chercher un générique archive modèle, archive.php.
5. Si archive.php fait également défaut, WordPress va retomber le thème principal fichier de modèle, index.php.,

Top

aperçu visuel #aperçu visuel

le diagramme suivant montre quels fichiers de modèle sont appelés pour générer une page WordPress basée sur la hiérarchie des modèles WordPress.

Top

la hiérarchie des modèles en détail #la hiérarchie des modèles en détail

bien que la hiérarchie des modèles soit plus facile à comprendre comme un diagramme, les sections suivantes décrivent l’ordre dans lequel les fichiers de modèles sont appelés par WordPress pour un certain nombre de types

haut

affichage de la page D’Accueil #Affichage de la page D’accueil

par défaut, WordPress définit la page d’accueil de votre site pour afficher vos derniers articles de blog. Cette page s’appelle l’index des articles de blog. Vous pouvez également définir vos articles de blog pour qu’ils s’affichent sur une page statique distincte., Le fichier modèle home.php est utilisé pour rendre l’index des articles de blog, qu’il soit utilisé comme page d’accueil ou sur une page statique séparée. Si home.php n’existe pas, WordPress va utiliser la balise index.php.

1. home.php
2. index.php

Top

Front Page display #Front page display

le fichier modèlefront-page.php est utilisé pour afficher la front page de votre site, que la front page affiche l’index des articles de blog (mentionné ci-dessus) ou une page statique. Le modèle de page d’accueil a priorité sur le modèle d’index des articles de blog (home.php). Si le fichierfront-page.php n’existe pas, WordPress utilisera les fichiershome.php oupage.php en fonction de la configuration dans Paramètres → lecture., Si aucun de ces fichiers n’existe, il utilisera le fichier index.php.

1. front-page.php – utilisé à la fois pour « vos derniers messages” ou « une page statique” comme défini dans la première page affiche section de paramètres → lecture.
2. home.php – si WordPress ne trouve pasfront-page.php et que « vos derniers messages” est défini dans la section des affichages de première page, il rechercherahome.php. De plus, WordPress recherchera ce fichier lorsque la page posts sera définie dans la section front page displays.,
3. page.php – Lorsque le « front page” est défini dans la première page affiche la section.
4. index.php – Quand « vos derniers messages” est défini dans la première page affiche la section mais home.php n’existe pas ou lorsque la page de couverture est fixé, mais page.php n’existe pas.

comme vous pouvez le voir, il y a beaucoup de règles sur le chemin emprunté par WordPress. L’utilisation du graphique ci-dessus est la meilleure façon de déterminer ce que WordPress affichera.,

haut

affichage de la page de la Politique de confidentialité #affichage de la page de la Politique de confidentialité

le fichier modèle privacy-policy.php est utilisé pour afficher la page de la Politique de confidentialité de votre site. Le modèle de page de politique de Confidentialité A priorité sur le modèle de page statique (page.php). Si le fichier privacy-policy.php n’existe pas, WordPress utilisera les fichiers page.php ou singular.php en fonction des modèles disponibles. Si aucun de ces fichiers n’existe, il utilisera le fichier index.php.,

1. privacy-policy.php – utilisé pour la page de politique de confidentialité définie dans la section Modifier votre page de politique de confidentialité de paramètres → Confidentialité.
2. custom template file – Le modèle de page affectés à la page. Voir get_page_templates().
3. page-{slug}.php – Si la page slug est privacy, WordPress va chercher à utiliser des page-privacy.php.
4. page-{id}.php – Si l’ID de la page 6, WordPress va chercher à utiliser des page-6.php.,
5. page.php
6. singular.php
7. index.php

Haut de page

un Seul Post #Post

Le seul poste de fichier de modèle est utilisé pour effectuer le rendu d’un seul poste. WordPress utilise le chemin suivant:

Top

Single Page #Single Page

le fichier modèle utilisé pour rendre une page statique (page post-type).,page est spécial pour WordPress et utilise le chemin suivant:

Top

Category #Category

Rendering category archive index pages utilise le chemin suivant dans WordPress:

Top

Tag #Tag

pour afficher une page d’index d’archive de balises, WordPress utilise>

taxonomies personnalisées #taxonomies personnalisées

les taxonomies personnalisées utilisent un chemin de fichier modèle légèrement différent:

top

types de publication personnalisés #types de publication personnalisés

les types de publication personnalisés utilisent le chemin suivant pour afficher la page d’index d’archive appropriée.,

1. archive-{post_type}.php – Si le poste est de type product, WordPress va chercher les archive-product.php.
2. archive.php
3. index.php

(Pour le rendu d’un seul poste type de modèle, reportez-vous à la poste section d’affichage ci-dessus.,s suivent le même modèle que les autres types de modèle:

1. search.php
2. index.php

Haut de page

404 (Non Trouvé) #404 (Non Trouvé)

de Même, 404 fichiers de modèle sont appelées dans l’ordre:

1. 404.php
2. index.php

Haut de page

pièce Jointe #pièce Jointe

le Rendu d’une pièce jointe page (attachment post-type) utilise le chemin d’accès suivant:

Haut de page

Incorpore #Incorpore

L’incorporer fichier de modèle est utilisé pour rendre un message qui est incorporé., Depuis la version 4.5, WordPress utilise le chemin suivant:

1. embed-{post-type}-{post_format}.php – tout d’abord, WordPress recherche un modèle pour le post spécifique. Par exemple, si son type de publication est post et qu’il a le format audio, WordPress rechercherait embed-post-audio.php.
2. embed-{post-type}.php – Si le poste est de type product, WordPress serait à la recherche de: embed-product.php.
3. embed.php – WordPress puis revient à intégrer.php.,
4. enfin, WordPress revient finalement à son propre modèlewp-includes/theme-compat/embed.php.

Top

non-ASCII Character Handling #non-ASCII Character Handling

Depuis WordPress 4.7, toute partie dynamique d’un nom de modèle qui inclut des caractères non-ASCII dans son nom prend en charge à la fois la forme non codée et la forme codée, dans cet ordre. Vous pouvez choisir lequel utiliser.,

Voici le modèle de page de la hiérarchie pour une page nommée « Hello World 😀” avec un ID de la balise 6:

• page-hello-world-😀.php
• page-hello-world-%f0%9f%98%80.php
• page-6.php
• page.php
• singular.php

Le même comportement s’applique au poste de limaces, de la durée des noms, et l’auteur nicenames.

Haut de page

Filtre Hiérarchie #Hiérarchie du Filtre

Le système de template WordPress vous permet de filtrer la hiérarchie., Cela signifie que vous pouvez insérer et modifier des choses, à des points spécifiques de la hiérarchie. Le filtre (situé dans le get_query_template() function) utilise ce nom de filtre: "{$type}_template" où $type est le type de modèle.,category_template

Top

Example #Example

For example, let’s take the default author hierarchy:

• author-{nicename}.php
• author-{id}.php
• author.php

To add author-{role}.php before author.php, we can manipulate the actual hierarchy using the ‘author_template’ template type., Cela permet une requête pour / author / username où username a le rôle d’éditeur à afficher en utilisant author-editor.php s’il est présent dans le répertoire des thèmes en cours.