Une question revient régulièrement de la part de développeurs qui découvrent les thèmes bloc : pourquoi, en modifiant front-page.html, rien ne change sur la page d’accueil du site ? La réponse tient presque toujours dans les réglages de lecture, une source de confusion qui existait déjà avec les thèmes classiques mais que l’absence de fichiers PHP familiers rend parfois plus difficile à diagnostiquer.
Ce billet ne couvre volontairement que ce cas précis de la page d’accueil : la hiérarchie complète de résolution des templates dans un thème bloc mériterait, à elle seule, un article bien plus long.
Les deux configurations possibles des réglages de lecture
Tout commence dans Réglages > Lecture, où deux options s’offrent à l’administrateur du site : afficher « Vos derniers articles » en page d’accueil, ou afficher « Une page statique », avec un choix explicite de la page d’accueil et, éventuellement, d’une page distincte pour les articles.
Cas 1 : affichage des derniers articles
Quand l’option « Vos derniers articles » est sélectionnée, WordPress cherche en priorité un fichier home.html. En son absence, il se rabat sur index.html. Dans cette configuration, le fichier front-page.html, même s’il existe dans le thème, n’est tout simplement jamais utilisé.
Cas 2 : une page statique définie comme page d’accueil
Quand une page statique est choisie comme page d’accueil, la hiérarchie change de priorité : WordPress cherche d’abord front-page.html. C’est ce fichier, et lui seul, qui détermine alors l’apparence de la page d’accueil, indépendamment du contenu réel de la page statique sélectionnée — sauf si ce template inclut explicitement le bloc Contenu de la publication pour afficher ce contenu.
Et la page des articles dans ce cas ?
Si une page distincte a été désignée pour afficher les articles récents, c’est le fichier home.html qui prend le relais pour cette page précise, avec le même mécanisme de repli vers index.html en son absence.
Tableau récapitulatif
| Réglage de lecture | Template recherché en priorité | Repli si absent |
|---|---|---|
| Derniers articles en accueil | home.html | index.html |
| Page statique en accueil | front-page.html | index.html |
| Page statique + page d’articles distincte | home.html (pour la page d’articles) | index.html |
Les erreurs les plus fréquentes rencontrées
- Modifier
front-page.htmlalors que le site affiche encore les derniers articles en accueil, sans effet visible. - Oublier de créer
home.htmlquand une page d’articles distincte a été définie, ce qui fait retomber surindex.htmlsans qu’on comprenne pourquoi. - Confondre le contenu de la page statique choisie en accueil avec le contenu du template
front-page.html, qui sont deux choses distinctes.
Vérifier rapidement quel template est réellement utilisé
Pour lever le doute sans deviner, l’éditeur de site indique, lors de l’édition d’un template, le contexte auquel il s’applique. Une astuce plus rapide encore consiste à consulter l’écran Apparence > Éditeur > Templates, où chaque entrée précise, sous son nom, un court descriptif de son usage (« Utilisé comme page d’accueil du site », par exemple). C’est souvent le moyen le plus direct de confirmer quel fichier gouverne réellement l’apparence de la page d’accueil, sans avoir à tester chaque combinaison de réglages manuellement.
En résumé
Le nombre de fichiers impliqués peut sembler excessif pour un seul emplacement du site, mais chacun répond à une configuration précise des réglages de lecture. Avant de chercher un bug dans le code d’un thème bloc dont la page d’accueil semble ignorer les modifications, un simple coup d’œil à ces réglages permet souvent de résoudre le mystère en quelques secondes.
