WordPress.org (Français)

Les modèles de page sont un type spécifique de fichier modèle qui peut être appliqué à une page ou à des groupes de pages spécifiques.

Puisquun modèle de page est un type spécifique de fichier modèle, voici quelques caractéristiques distinctives des modèles de page:

• Les modèles de page sont utilisés pour changer lapparence dune page.
• Un modèle de page peut être appliqué à une seule page, une section de page ou une classe de pages .
• Les modèles de page ont généralement un haut niveau de spécificité, ciblant une page individuelle ou un groupe de pages. Par exemple, un modèle de page nommé page-about.php est plus spécifique que les fichiers modèles page.php ou index.php car cela naffectera quune page avec le slug «about».
• Si un modèle de page a un nom de modèle, les utilisateurs de WordPress éditant la page ont le contrôle sur le modèle qui sera utilisé pour rendre la page.

Utilisations pour les modèles de page #Utilisations pour les modèles de page

Les modèles de page affichent le contenu dynamique de votre site sur une page, par exemple, des articles, des mises à jour dactualités, des événements dagenda, des fichiers multimédias , etc. Vous pouvez décider que vous voulez que votre page d’accueil ait un aspect spécifique, qui est assez différent des autres parties de votre site. Ou, vous pouvez afficher une image en vedette qui renvoie à un article sur une partie de la page, avoir une liste des derniers articles ailleurs et utiliser une navigation personnalisée. Vous pouvez utiliser des modèles de page pour réaliser ces tâches.

Cette section vous montre comment créer des modèles de page qui peuvent être sélectionnés par vos utilisateurs via leur écrans dadministration.

Par exemple, vous pouvez créer des modèles de page pour:

• pleine largeur, une colonne
• deux colonnes avec une barre latérale à droite
• deux colonnes avec une barre latérale à gauche
• trois colonnes

Haut

Modèles de page dans la hiérarchie des modèles # Modèles de page dans la hiérarchie des modèles

Lorsquune personne navigue sur votre site Web, WordPress sélectionne le modèle à utiliser pour afficher cette page. Comme nous lavons appris précédemment dans la hiérarchie des modèles, WordPress recherche les fichiers de modèle dans lordre suivant:

1. Modèle de page – Si la page a un modèle personnalisé attribué, WordPress recherche ce fichier et, sil est trouvé , lutilise.
2. page-{slug}.php – Si aucun modèle personnalisé na été attribué, WordPress recherche et utilise un modèle spécialisé contenant le slug de la page.
3. page-{id}.php – Si un modèle spécialisé qui inclut le slug de la page nest pas trouvé, WordPress recherche et utilise un modèle spécialisé nommé avec lID de la page.
4. page.php – Si un modèle spécialisé incluant lID de la page nest pas trouvé, WordPress recherche et utilise le modèle de page par défaut du thème.
5. singular.php – Si page.php nest pas trouvé, WordPress recherche et utilise le modèle de thème utilisé pour une seule publication, quel que soit le type de publication.
6. index.php – Si aucun élément spécifique des modèles de page sont attribués ou trouvés, WordPress utilise par défaut le fichier dindex du thème pour afficher les pages.

Haut

Modèles de page Objectif & Contrôle utilisateur #Page Templates Objectif & Contrôle utilisateur

Si vous prévoyez de créer un modèle de page personnalisé pour votre thème, vous devez décider de plusieurs choses avant de continuer:

• Si le modèle de page sera pour une page spécifique ou pour nimporte quelle page; et
• Le type de contrôle utilisateur que vous souhaitez voir disponible pour le modèle.

Chaque modèle de page doté dun nom de modèle peut être sélectionné par un utilisateur lors de sa création ou de sa modification une feuille. La liste des modèles disponibles se trouve sur Pages > Ajouter un nouveau modèle > > . Par conséquent, un utilisateur WordPress peut choisir nimporte quel modèle de page avec un nom de modèle, ce qui nest peut-être pas votre intention.

Par exemple, si vous souhaitez avoir un modèle spécifique pour votre page « À propos de », il se peut que ce ne soit pas le cas convient de nommer ce modèle de page «À propos du modèle» car il serait globalement disponible pour toutes les pages (cest-à-dire que lutilisateur pourrait lappliquer à nimporte quelle page). Au lieu de cela, créez un modèle à usage unique et WordPress affichera la page avec le modèle approprié, chaque fois quun utilisateur visite la page « À propos de ».

À linverse, de nombreux thèmes incluent la possibilité de choisir le nombre de colonnes quune page Chacune de ces options est un modèle de page disponible dans le monde entier.Pour donner à vos utilisateurs WordPress cette option globale, vous devrez créer des modèles de page pour chaque option et donner à chacun un nom de modèle.

Dicter si un modèle est à usage global par rapport à une utilisation singulière est obtenu en passant le fichier est nommé et sil contient ou non un commentaire spécifique.

Top

Organisation des fichiers des modèles de page # Organisation des fichiers des modèles de page

Comme indiqué dans Organisation des fichiers de thème, WordPress reconnaît les modèles de page de sous-dossier. Par conséquent, cest une bonne idée de stocker vos modèles de page globale dans ce dossier pour les aider à rester organisés.

Top

Création de modèles de page personnalisés pour une utilisation globale #Création de modèles de page personnalisés pour une utilisation globale

Parfois, vous voudrez un modèle qui peut être utilisé globalement par nimporte quelle page, ou par plusieurs pages. Certains développeurs regrouperont leurs modèles avec un préfixe de nom de fichier, tel que page_two-columns.php

Pour plus dinformations sur les conventions de dénomination des fichiers de thème et les noms de fichiers que vous ne pouvez pas utiliser, consultez les noms de fichiers de thème réservés.

Pour créer un modèle global, écrivez un commentaire PHP douverture en haut de le fichier qui indique le nom du modèle.

<?php /* Template Name: Example Template */ ?>

Cest une bonne idée de choisissez un nom qui décrit ce que fait le modèle car le nom est visible par les utilisateurs de WordPress lorsquils modifient la page. Par exemple, vous pouvez nommer votre modèle de page daccueil, de blog ou de portfolio.

Cet exemple du thème TwentyFourteen crée un modèle de page appelé Page pleine largeur:

<?php/*** Template Name: Full Width Page** @package WordPress* @subpackage Twenty_Fourteen* @since Twenty Fourteen 1.0*/

Une fois que vous téléchargez le fichier dans le dossier de votre thème (par exemple, page- templates), accédez à la page > Modifier lécran de votre tableau de bord dadministration.

On the right hand side under attributes you"ll see template. This is where users are able to access your global page templates.

Tip: The select list has a maximum width of 250px, so longer names may be cut off.

Haut

Création dun modèle de page personnalisé pour une page spécifique #Création dun modèle de page personnalisé pour une page spécifique

Comme mentionné dans la page Hiérarchie des modèles, vous pouvez créer un modèle pour une page spécifique. Pour créer un modèle pour une page spécifique, copiez votre fichier page.php existant et renommez-le avec le slug ou lID de votre page:

1. page-{slug}.php
2. page-{ID}.php

Par exemple: votre page À propos contient un slug » à propos de  » et un ID de 6. Si le dossier de votre thème actif a un fichier nommé page-about.php ou page-6.php, WordPress trouvera et utilisera automatiquement ce fichier pour afficher la page À propos.

Pour être utilisés, les modèles de page spécialisés doivent se trouver dans le dossier de votre thème (cest-à-dire / wp-content / themes / mon-nom-thème /).

Haut

Création de modèles de page pour des types de publication spécifiques #Création de modèles de page pour des types de publication spécifiques

Par défaut, un modèle de page personnalisé sera disponible pour le type de publication « page ».

Pour créer un modèle de page pour des types darticles spécifiques, ajoutez une ligne sous le nom du modèle avec les types darticles que vous souhaitez que le modèle prenne en charge.

Exemple:

<?php/*Template Name: Full-width layoutTemplate Post Type: post, page, event*/// Page code here...

Lorsquil existe au moins un modèle pour un type de publication, la méta-boîte « Attributs de publication » sera affichée dans le back-end, sans avoir besoin dajouter un support de type de publication pour les «attributs de page» ou quoi que ce soit dautre. Le libellé « Attributs de publication » peut être personnalisé par type de publication en utilisant le libellé « attributs » lors de lenregistrement dun type de publication.

Compatibilité descendante:

Supposons que vous souhaitiez publier un thème publiquement avec prise en charge des modèles de type de publication. Les versions de WordPress antérieures à 4.7 ignoreront len-tête Template Post Type et afficheront le modèle dans la liste des modèles de page, même si cela ne fonctionne que pour les publications régulières.Pour éviter cela, vous pouvez vous connecter au filtre theme_page_templates pour lexclure de la liste. Voici un exemple:

Développer le code source completRéduire le code source complet

De cette façon, vous pouvez prendre en charge la publication personnalisée tapez des modèles dans WordPress 4.7 et au-delà tout en conservant une compatibilité descendante complète.

Notez que theme_page_templates est en fait un filtre de thème dynamique _ {$ post_type} _templates. La partie dynamique du nom du hook, $ post_type, fait référence au type de publication pris en charge par les modèles. Par exemple. vous pouvez vous connecter à theme_product_templates pour filtrer la liste des modèles pour le type de publication de produit.

Haut

Utilisation de balises conditionnelles dans les modèles de page #Utilisation de balises conditionnelles dans les modèles de page

Vous pouvez apporter des modifications plus petites et spécifiques à la page avec les balises conditionnelles dans le fichier page.php de votre thème. Par exemple, lexemple de code ci-dessous charge le fichier header-home.php pour votre page daccueil, mais charge un autre fichier (header-about.php) pour votre page À propos, puis applique la valeur par défaut header.php pour toutes les autres pages.

if ( is_front_page() ) :get_header( "home" );elseif ( is_page( "About" ) ) :get_header( "about" );else:get_header();endif;

Pour en savoir plus sur les balises conditionnelles, cliquez ici.

Top

Identification dun modèle de page #Identification dun modèle de page

Si votre modèle utilise la fonction body_class(), WordPress imprimera les classes dans la balise body pour le nom de classe de type de publication (page), lID de la page (page-id-{ID}) et le modèle de page utilisé. Pour le page.php par défaut, le nom de classe généré est page-template-default:

<body class="page page-id-6 page-template-default">

Lors de lutilisation dun modèle de page personnalisé, la classe page-template print, avec une classe nommant le modèle spécifique. Par exemple, si votre fichier de modèle de page personnalisé est nommé comme suit:

<?php/* Template Name: My Custom Page */?gt;

Ensuite, le HTML généré sera comme suit:

<body class="page page-id-6 page-template page-template-my-custom-page-php">

Notez le page-template-my-custom-page-php Classe appliquée à la balise body.

Haut

Fonctions des modèles de page #Fonctions du modèle de page

Ces fonctions et méthodes WordPress intégrées peuvent vous aider à travailler avec des modèles de page:

• get_page_template() renvoie le chemin du modèle de page utilisé pour afficher la page.
• wp_get_theme()->get_page_templates() renvoie tous les modèles de page personnalisés disponibles pour le thème actuellement actif (get_page_templates() est une méthode de la classe WP_Theme).
• is_page_template() renvoie vrai ou faux selon si un modèle de page personnalisé a été utilisé pour afficher la page.
• get_page_template_slug() r et renvoie la valeur du champ personnalisé _wp_page_template (null lorsque la valeur est vide ou « par défaut »). Si une page a reçu un message personnalisé template, le nom de fichier de ce modèle est stocké en tant que valeur dun champ personnalisé nommé "_wp_page_template" (dans la table de base de données wp_postmeta). (Les champs personnalisés commençant par un trait de soulignement ne saffichent pas dans le module des champs personnalisés de lécran dédition.)