« On va faire un pattern pour ça » entend-on parfois alors que la solution la plus adaptée serait en réalité une template part, ou une variation de style. Ces mots se ressemblent, s’emploient parfois indifféremment dans des conversations d’équipe, et pourtant recouvrent des mécanismes de stockage et de comportement très différents. Ce glossaire fixe les définitions et les relations entre ces cinq notions.
Template
Un template définit la structure complète d’un type de page (page, article, archive, résultat de recherche). Il est stocké comme fichier HTML dans le dossier templates/ du thème, et suit sa propre hiérarchie de résolution (du gabarit le plus spécifique au plus générique) héritée de la logique historique de WordPress. Une fois personnalisé depuis l’éditeur, il génère une entrée en base dans le post type wp_template, qui prend le pas sur le fichier sans jamais l’écraser.
Template part
Une template part est un fragment de template réutilisable à travers plusieurs templates — typiquement un en-tête ou un pied de page. Elle est insérée via le bloc wp:template-part, référencé par un slug, et stockée en fichier dans le dossier parts/ du thème, avec le même mécanisme de surcouche en base (wp_template_part) qu’un template complet en cas de personnalisation.
Pattern (et pattern synchronisé)
Un pattern est un assemblage de blocs prêt à l’emploi, inséré depuis l’inserter ou proposé comme point de départ de page. Un pattern classique se copie dans le contenu au moment de l’insertion, sans lien conservé avec son origine. Un pattern synchronisé, à l’inverse, conserve ce lien : toute modification se répercute sur toutes ses instances, car son contenu vit dans un article unique du post type wp_block, référencé par identifiant plutôt que copié.
Variation de style
Une variation de style est un jeu alternatif de réglages visuels (palette de couleurs, typographie, espacement) déclaré dans le dossier styles/ du thème sous forme de fichiers JSON, sélectionnable globalement depuis le Style Book. Une fois choisie et éventuellement ajustée par l’utilisateur, elle est enregistrée dans l’article wp_global_styles, qui devient alors la source de vérité active, prioritaire sur les fichiers du thème.
Section style
Le style de section désigne un jeu de styles nommé, applicable non pas à l’ensemble du site mais à une portion précise d’une page — un bloc Groupe représentant une section, par exemple, auquel on applique un style de fond sombre alterné avec les sections claires environnantes. Contrairement à une variation de style globale, un style de section reste local à l’endroit où il est appliqué ; contrairement à un pattern, il ne fige pas la structure des blocs, seulement leur apparence.
| Notion | Ce qu’elle définit | Stockage par défaut |
|---|---|---|
| Template | Structure complète d’un type de page | Fichier thème, surcouche wp_template |
| Template part | Fragment réutilisable entre templates | Fichier thème, surcouche wp_template_part |
| Pattern synchronisé | Contenu réutilisable lié à toutes ses instances | Article wp_block unique |
| Variation de style | Jeu de réglages visuels alternatif pour tout le site | Fichier JSON, surcouche wp_global_styles |
| Style de section | Apparence appliquée localement à une portion de page | Attributs du bloc concerné, dans le contenu |
Comment ces notions se combinent entre elles
- Un template peut contenir des template parts, des patterns (synchronisés ou non), et des blocs porteurs d’un style de section.
- Une variation de style s’applique par-dessus tout le reste : elle change l’apparence par défaut des blocs, y compris ceux à l’intérieur des patterns et des template parts.
- Un style de section prend le pas localement sur la variation de style globale active, uniquement pour le bloc auquel il est appliqué.
- Un pattern synchronisé peut lui-même contenir des blocs porteurs d’un style de section, indépendamment du reste du contenu où il est inséré.
Pièges de vocabulaire les plus fréquents
Confondre pattern synchronisé et template part revient à confondre un mécanisme piloté par identifiant (le pattern) avec un mécanisme piloté par slug et hiérarchie de fichiers (la template part) — deux logiques de résolution différentes, abordées plus en détail dans un comparatif dédié. Confondre variation de style et style de section revient à confondre une portée globale avec une portée locale : la variation change tout le site d’un coup, le style de section ne change qu’un seul endroit précis.
En résumé
Ces cinq notions se distinguent moins par leur apparence dans l’éditeur que par leur portée (globale ou locale) et leur lieu de stockage (fichier de thème, article dédié, ou attributs de bloc). Les connaître précisément évite bien des choix d’architecture pris à l’instinct, sur la seule ressemblance de nom entre deux mécanismes qui ne se comportent pas du tout pareil une fois en production.
