Template Part

Définition : Un Template Part WordPress est une portion réutilisable d’un modèle, comme un en-tête, un pied de page ou une barre latérale. Dans un thème de blocs, il utilise notamment le bloc core/template-part.

Terminologie

Nom technique : Template Part

Appellations : Partie de modèle

À quoi cela sert, concrètement

Il évite de répéter la même structure sur toutes les pages. Une modification de la partie commune peut se répercuter sur les templates qui la référencent, sous réserve des personnalisations enregistrées.

Fonctionnement détaillé

Un template principal insère la partie réutilisable par son slug. WordPress localise les définitions concernées, notamment dans le dossier parts du thème de blocs ou dans les contenus sauvegardés, puis rend les blocs associés.

Quand l’utiliser : contexte et choix techniques

À utiliser pour les régions stables communes à plusieurs modèles. Lorsque le site repose sur des templates PHP classiques, get_template_part() répond à une logique apparentée mais utilise des fichiers PHP.

Situation professionnelle réaliste

Un thème à blocs partage le même en-tête avec sa page d’accueil, ses articles et ses archives, sans recopier le bloc Navigation dans chaque fichier.

Exemple pratique — HTML / balisage de blocs

Exemple pédagogique : adapter le nom du thème, les fichiers et les conditions à un environnement de développement. Il ne constitue pas une preuve d’exécution sur ATOOLPHA.

<!-- Dans templates/page.html -->
<!-- wp:template-part {"slug":"header","area":"header"} /-->
<!-- wp:group {"tagName":"main"} -->
<main class="wp-block-group">
  <!-- wp:post-title /-->
  <!-- wp:post-content /-->
</main>
<!-- /wp:group -->
<!-- wp:template-part {"slug":"footer","area":"footer"} /-->

Décryptage de l’exemple, étape par étape

Les deux références template-part recherchent respectivement les parties header et footer. Le modèle décrit uniquement leur emplacement ; la structure propre de chaque partie reste définie ailleurs.

Résultat observable

Toutes les pages qui utilisent ce modèle affichent les zones communes, pour autant que les Template Parts existent et soient compatibles avec le thème actif.

Exercice de vérification pratique

Dans l’éditeur de site, ouvrir un modèle, sélectionner son en-tête puis accéder à la partie réutilisable. Modifier un texte de test et observer les autres modèles qui partagent cette partie.

Pièges, limites et sécurité

Une modification de Template Part enregistrée en base peut prendre priorité sur le fichier du thème. Éviter de multiplier des fragments identiques avec des slugs différents.

Différences avec les notions voisines

Template Part est un composant de thème de blocs ; get_template_part() désigne une fonction PHP surtout utilisée dans les thèmes classiques.

Diagnostic avancé et cas de maintenance

Cas avancé : le pied de page est différent entre deux modèles alors qu’ils mentionnent le même slug. Vérifier les parties enregistrées dans l’éditeur et leur association au thème actif. L’existence d’un fichier du même nom dans parts ne garantit pas qu’il soit la version actuellement utilisée.