# Partie de gabarit

> Un fragment de gabarit réutilisable, propre aux thèmes blocs, qui peut être inséré dans plusieurs gabarits différents sans duplication.

- Auteur : Clément Hadrot
- Publié le : 2026-09-25
- Mis à jour le : 2026-09-25
- URL : https://wpmoderne.dev.wordpress-developpement.fr/lexique/partie-de-gabarit/

Découper un gabarit complet en petits morceaux réutilisables plutôt que de tout écrire en un seul bloc massif : c'est exactement le rôle des parties de gabarit, qui isolent des sections comme l'en-tête ou le pied de page pour les injecter dans autant de gabarits que nécessaire.

## Fonctionnement technique

Chaque partie de gabarit est un fichier HTML au format blocs, stocké dans le dossier `parts/` d'un thème bloc, et déclaré dans `theme.json` sous `templateParts` avec une zone associée (`header`, `footer` ou `uncategorized`). Elle s'insère dans un gabarit via le bloc *Partie de gabarit*, et devient modifiable directement depuis l'éditeur de site sans quitter la page en cours d'édition.

## Déclaration dans theme.json

```
"templateParts": [
  { "name": "header", "title": "En-tête", "area": "header" },
  { "name": "footer", "title": "Pied de page", "area": "footer" }
]
```

## À ne pas confondre avec

- Un gabarit complet (`templates/single.html` par exemple) représente une page entière ; une partie de gabarit n'en est qu'un fragment destiné à être inséré à l'intérieur d'un ou plusieurs gabarits.
- Dans un thème classique, l'équivalent le plus proche reste les fichiers inclus via `get_template_part()`, mais ceux-ci restent des fragments PHP, non éditables visuellement depuis l'éditeur de site.
- Modifier une partie de gabarit affecte instantanément tous les gabarits qui l'utilisent, ce qui en fait un point de modification très efficace mais aussi potentiellement risqué si le changement n'est pas anticipé partout.