thème enfant

Créer un thème enfant WordPress

Toute modification faite dans les fichiers d’un thème disparaît à sa prochaine mise à jour. Le thème enfant existe pour ça : c’est un thème miniature qui s’appuie sur le vôtre et contient uniquement vos personnalisations. Deux fichiers suffisent à le créer. Mais avant de vous lancer, une question doit être tranchée : selon votre thème, vous n’en avez peut-être pas besoin du tout.

En avez-vous vraiment besoin ?

Cette question, presque aucun tutoriel ne la pose, et elle vous fera gagner du temps.

  • Vous utilisez un thème à blocs, avec une entrée Apparence > Éditeur : vos modifications de modèles et de styles sont enregistrées en base de données, pas dans les fichiers. Elles survivent donc aux mises à jour sans thème enfant. Il ne devient utile que pour ajouter du code PHP ou des fichiers de modèle sur mesure.
  • Vous utilisez un thème classique, avec Apparence > Personnaliser : les réglages de l’outil de personnalisation et le CSS additionnel sont également conservés en base. Le thème enfant devient nécessaire dès que vous touchez à un fichier de modèle ou à functions.php.

Autrement dit : pour changer une couleur ou masquer un élément, le CSS additionnel de l’outil de personnalisation suffit. Pour modifier la structure d’une page ou ajouter une fonction, il faut un thème enfant.

Créer le thème enfant en deux fichiers

Par FTP, créez un nouveau dossier dans wp-content/themes/. Nommez-le d’après le thème parent suivi d’un suffixe, par exemple montheme-enfant, sans espace ni accent.

Le fichier style.css

/* Theme Name: Mon thème enfant Template: montheme Version: 1.0 */

La ligne Template est la seule qui ne tolère aucune approximation. Elle doit reprendre exactement le nom du dossier du thème parent, pas son nom affiché, en respectant majuscules et minuscules. Une erreur ici et WordPress refusera d’activer le thème enfant, avec un message peu explicite. C’est la cause d’échec numéro un.

Le fichier functions.php

<?php add_action( 'wp_enqueue_scripts', function () {     wp_enqueue_style(         'parent-style',         get_template_directory_uri() . '/style.css'     ); } );

Ce fichier charge la feuille de styles du thème parent. Beaucoup de thèmes récents chargent déjà correctement leurs propres styles : dans ce cas, un functions.php vide ou même absent fonctionne. Testez sans, et n’ajoutez ce code que si votre site s’affiche sans mise en forme.

Vous pouvez enfin déposer un fichier screenshot.png dans le dossier : c’est la vignette affichée dans la liste des thèmes. Purement cosmétique, mais pratique quand plusieurs thèmes coexistent.

Activez ensuite le thème enfant dans Apparence > Thèmes. Le site doit rester strictement identique : c’est le signe que tout est correct.

Le point que tout le monde comprend de travers

Les fichiers du thème enfant se comportent de deux façons opposées selon leur nature, et confondre les deux produit des résultats incompréhensibles.

  • Les fichiers de modèle remplacent ceux du parent. Copiez footer.php dans le thème enfant et modifiez-le : c’est votre version qui sera utilisée, à la place de l’originale. Respectez l’arborescence — un fichier situé dans un sous-dossier du parent doit se retrouver dans le même sous-dossier chez l’enfant.
  • Le fichier functions.php s’ajoute, il ne remplace pas. Celui de l’enfant est chargé avant celui du parent, et les deux s’exécutent. Ne copiez donc jamais le functions.php du parent dans l’enfant : vous déclareriez deux fois les mêmes fonctions et le site planterait immédiatement.

Cette asymétrie est la source de la plupart des erreurs critiques rencontrées lors de la création d’un thème enfant.

Modifier une fonction du parent

Puisque le functions.php de l’enfant est chargé en premier, vous ne pouvez pas simplement redéfinir une fonction du parent : vous obtiendriez une erreur de déclaration en double.

Deux voies existent. Si le thème parent a prévu le coup, sa fonction est déclarée de façon conditionnelle — vous pouvez alors la définir dans l’enfant et la vôtre sera retenue. Sinon, passez par les crochets : retirez l’action ou le filtre du parent, puis branchez la vôtre. C’est la méthode propre, et celle que les thèmes sérieux documentent.

Ce que le thème enfant ne fait pas

  • Il ne vous protège pas d’un thème parent abandonné. Si le parent cesse d’être maintenu, vous héritez de ses failles. Le thème enfant protège vos modifications, pas le socle.
  • Il ne survit pas à un changement de thème parent. Passer d’un thème à un autre rend les modèles copiés inopérants, car ils reposaient sur la structure de l’ancien.
  • Il ne remplace pas une extension. Une fonction qui doit survivre à un changement de thème — un code de suivi, un type de contenu sur mesure — n’a rien à faire dans un thème enfant. Placez-la dans une extension maison ou dans une extension de gestion d’extraits de code.

Questions fréquentes

Vais-je perdre mes réglages en activant le thème enfant ?

Certains, oui. Les menus, les widgets et une partie des réglages de personnalisation sont associés au thème actif et ne suivent pas automatiquement. Prévoyez de les reconfigurer après activation : notez ou capturez vos réglages avant, l’opération est rapide mais surprend si l’on ne s’y attend pas. Vos contenus, eux, ne bougent pas.

Mon thème enfant n’apparaît pas dans la liste

Trois causes, par ordre de fréquence. La ligne Template ne correspond pas exactement au nom du dossier parent. L’en-tête du fichier style.css est mal formé, souvent parce que le bloc de commentaire n’est pas en tout début de fichier. Ou le dossier n’est pas directement dans wp-content/themes/ mais dans un sous-dossier. Vérifiez ces trois points dans cet ordre.

Le site s’affiche sans mise en forme après activation

La feuille de styles du parent n’est pas chargée. Ajoutez le code d’appel dans le functions.php de l’enfant. Évitez la méthode par importation CSS que l’on trouve encore dans de vieux tutoriels : elle fonctionne mais dégrade nettement les performances, car le navigateur doit charger un fichier avant de découvrir qu’il en faut un second.

Faut-il un thème enfant pour du CSS uniquement ?

Non. Le champ CSS additionnel de l’outil de personnalisation enregistre vos styles en base de données : ils survivent aux mises à jour du thème. C’est plus simple, plus rapide, et modifiable avec un aperçu en direct. Le thème enfant ne se justifie que si votre CSS devient volumineux ou si vous voulez le versionner comme du code.

Mon thème fournit déjà un thème enfant, dois-je le créer moi-même ?

Utilisez le sien. Beaucoup de thèmes commerciaux en fournissent un, préconfiguré pour charger correctement les styles et parfois enrichi de fonctions spécifiques. C’est du temps gagné et une source d’erreur en moins. Vérifiez seulement qu’il est bien à jour par rapport à la version actuelle du thème parent.

Le site est cassé depuis que j’ai modifié functions.php

C’est le scénario classique : une erreur de syntaxe, ou une fonction déclarée deux fois. Renommez le dossier du thème enfant par FTP pour revenir au parent, corrigez tranquillement, puis renommez à l’identique. Ne modifiez jamais ce fichier depuis l’éditeur intégré de WordPress. Le cas est traité dans notre guide sur l’erreur critique WordPress.