Toutes les pages d’un site n’ont pas besoin de la même disposition : une page de contact peut vouloir masquer la barre latérale, une page d’accueil peut réclamer une largeur pleine sans en-tête classique. Le modèle de page permet ce choix, page par page, sans dupliquer tout le thème.
Déclaration dans un thème classique
Un fichier PHP devient sélectionnable comme modèle de page grâce à un commentaire d’en-tête spécifique, puis apparaît dans le sélecteur « Modèle » du panneau latéral de l’éditeur :
<?php
/**
* Template Name: Pleine largeur
*/
get_header(); ?>
<main class="pleine-largeur"><?php the_content(); ?></main>
<?php get_footer(); ?>Équivalent dans un thème bloc
Les thèmes blocs déclarent leurs modèles de page comme des fichiers HTML classés dans templates/, avec un en-tête de métadonnées au format commentaire de bloc précisant le nom affiché à l’utilisateur. La sélection se fait toujours depuis le même panneau « Modèle » dans l’éditeur, quel que soit le type de thème.
Bon à savoir
- Un modèle de page ne s’applique qu’à la page qui l’utilise explicitement : les autres pages continuent d’utiliser le gabarit générique de page issu de la hiérarchie des gabarits.
- Changer de thème fait perdre l’accès au modèle de page choisi si le nouveau thème ne propose pas de modèle portant le même nom ; la page retombe alors sur le gabarit par défaut.
- Un modèle de page reste distinct d’un gabarit d’article unique : le premier concerne les pages, le second les articles et types de contenu similaires.