templates/index.html

Définition : Le fichier templates/index.html est le modèle de repli obligatoire d’un thème de blocs WordPress. Il décrit une structure de page au moyen du balisage des blocs reconnus par le Core.

Terminologie

Nom technique : templates/index.html

Appellations : Nom principal utilisé

À quoi cela sert, concrètement

Il garantit une base de rendu lorsqu’aucun modèle plus précis ne correspond à la requête. C’est également l’un des fichiers déterminants pour que WordPress reconnaisse un thème comme thème à blocs.

Fonctionnement détaillé

La hiérarchie des templates cherche d’abord les variantes adaptées au contexte : page, article, archive ou résultat de recherche. Si aucun fichier plus spécifique ne s’applique, le modèle index sert de dernière possibilité.

Quand l’utiliser : contexte et choix techniques

Créer ce fichier dans un thème de blocs minimal et y poser seulement la structure globale indispensable. Ajouter ensuite des templates ciblés pour éviter de rendre toutes les pages avec une mise en page identique.

Situation professionnelle réaliste

Un thème expérimental possède un modèle unique qui affiche le titre et le contenu d’une publication, ainsi que l’en-tête et le pied de page partagés.

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.

<!-- templates/index.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

La première et la dernière instruction chargent les parties partagées. Le bloc Groupe matérialise l’élément main ; post-title et post-content sont des blocs dynamiques dépendants de la requête courante.

Résultat observable

Lorsque ce template est effectivement choisi, une page possède une structure commune et affiche les données disponibles. Un vrai thème doit fournir les parties et les règles de style appropriées.

Exercice de vérification pratique

Dans une installation locale, créer une page et un article, observer leur affichage puis ajouter templates/single.html. Vérifier que le nouvel article utilise le template plus spécifique.

Pièges, limites et sécurité

Ne pas traiter un fichier HTML de thème de blocs comme un fichier HTML arbitraire : les marqueurs de blocs doivent être valides. Les modifications enregistrées dans l’éditeur de site peuvent remplacer le modèle du fichier.

Différences avec les notions voisines

index.php est le repli classique en PHP ; templates/index.html est le repli d’un thème à blocs.

Diagnostic avancé et cas de maintenance

Cas avancé : un article utilise soudain un autre affichage après l’ajout de single.html. Le problème n’est pas nécessairement dans index.html : la hiérarchie privilégie le modèle spécifique. Reconstituer le chemin de sélection du template avant d’éditer le fichier de repli général.