« This template is not a supported template » : ce message, affiché dans la console du navigateur au moment de générer un thème bloc via l’extension Create Block Theme, tout juste publiée par l’équipe du projet Gutenberg pour faciliter le passage d’un site construit visuellement à un vrai thème exportable, a interrompu net l’export d’un projet client en cours de finalisation.
Le site, un blog culinaire construit entièrement dans le Site Editor à partir d’un thème de démarrage minimal, devait être exporté sous forme de thème autonome pour être versionné dans un dépôt Git et déployé sur l’environnement de production du client. L’export, qui fonctionnait sans problème la veille sur un test similaire, échouait désormais systématiquement, sans qu’aucune modification majeure n’ait été apportée entre-temps.
Symptôme : un blocage total, sans indication du fichier fautif
Le message d’erreur, générique, ne précisait ni le nom du template concerné, ni la raison exacte du rejet. L’export s’interrompait avant même de générer la moindre archive, ce qui rendait impossible toute inspection du résultat partiel pour identifier la cause.
Diagnostic : un template personnalisé au nom de fichier non conforme
La méthode retenue a consisté à retirer, un par un, les templates personnalisés créés récemment dans l’éditeur, en relançant l’export après chaque retrait, jusqu’à isoler le fichier fautif. Le coupable s’est révélé être un template personnalisé nommé « Page Recette détail », créé directement depuis l’interface du Site Editor pour les pages de recettes du blog, et enregistré automatiquement avec un slug généré à partir de ce libellé, contenant des espaces convertis en tirets de façon incohérente.
Create Block Theme, au moment de l’export, vérifie que chaque nom de fichier de template correspond à une convention reconnue par la hiérarchie de templates de WordPress : un fichier destiné à un usage personnalisé doit respecter le préfixe attendu et un format de nommage précis, faute de quoi l’extension refuse de le considérer comme un fichier de template valide à exporter, plutôt que de risquer de générer un thème dont le fichier ne serait jamais retrouvé par WordPress lui-même.
Correctif : renommer le template avant nouvel export
La correction n’a pas nécessité de filtre PHP ni de contournement technique : il a suffi de renommer le template directement depuis l’écran de gestion des templates du Site Editor, en respectant cette fois un slug simple, sans caractère spécial ni espace mal converti, avant de relancer l’export.
Avant : page-recette-détail—copie.html
Après : page-recette-detail.html
- Identifier le template fautif en retirant les templates personnalisés un par un jusqu’à export réussi.
- Renommer ce template avec un slug simple, en minuscules, sans accent ni caractère spécial.
- Relancer l’export complet du thème depuis Create Block Theme.
- Vérifier, une fois le thème téléchargé, que le fichier généré porte bien le nom attendu dans le dossier
templates.
Pourquoi ne pas simplement contourner la vérification
Un contournement aurait été possible, en modifiant directement le nom de fichier généré via un filtre sur le processus d’export de l’extension. Cette option a été écartée volontairement : la vérification effectuée par Create Block Theme reflète une contrainte réelle de la hiérarchie de templates de WordPress elle-même, pas une limite arbitraire de l’extension. Contourner la vérification aurait simplement déplacé le problème vers un futur incident, une fois le thème exporté et déployé, où WordPress n’aurait tout simplement pas reconnu le fichier concerné au moment de résoudre le bon template à afficher.
- Vérifier systématiquement les slugs des templates personnalisés avant tout export.
- Éviter de renommer un template directement depuis un champ de titre libre sans contrôler le slug généré.
- Tester l’export régulièrement pendant la construction, plutôt qu’une seule fois à la fin du projet.
Une erreur d’export qui semble toucher l’ensemble du thème cache très souvent un seul fichier mal nommé : mieux vaut isoler méthodiquement plutôt que suspecter l’extension elle-même en premier réflexe.
Ce que ce billet ne couvre pas
Ce billet ne traite pas l’export de patterns via cette même extension, sujet voisin mais distinct, ni la création d’un thème bloc entièrement de zéro sans passer par le Site Editor visuel, deux approches qui dépassent le périmètre de ce diagnostic ciblé sur un blocage d’export précis.
En résumé
Le message « This template is not a supported template » de Create Block Theme signale presque toujours un nom de fichier de template ne respectant pas la convention attendue par la hiérarchie de WordPress, souvent hérité d’un slug généré automatiquement à partir d’un titre contenant des caractères problématiques. Isoler le fichier fautif par élimination, puis le renommer proprement, résout le blocage sans nécessiter aucun contournement technique risqué.
