Apprendre WordPress

Thème enfant WordPress : pourquoi le créer avant de personnaliser son site ?

Le thème enfant protège vos personnalisations

Un thème enfant WordPress est un thème distinct qui s’appuie sur un thème parent. Le thème parent fournit la structure, les modèles et les fonctionnalités générales. Le thème enfant permet d’ajouter ou de modifier certains éléments sans intervenir directement dans les fichiers d’origine.

Cette organisation répond à un problème courant : une personnalisation enregistrée dans le thème principal peut être remplacée lors de sa prochaine mise à jour. Une mise à jour installe en effet de nouvelles versions des fichiers concernés. Si un fichier modifié localement est remplacé, les changements peuvent disparaître, parfois sans message explicite.

Le thème enfant crée une séparation entre le code fourni par le thème principal et les ajustements propres au site. Cette séparation n’empêche pas les erreurs, mais elle rend leur gestion plus prévisible. Elle aide aussi à identifier la source d’un changement lorsque le site ne s’affiche plus comme prévu.

Le principe peut être résumé ainsi : le thème parent reste la base fonctionnelle, tandis que le thème enfant contient les adaptations. Quand WordPress cherche un fichier, il utilise en priorité la version présente dans le thème enfant lorsqu’elle existe, puis se reporte sur le thème parent pour les fichiers qui n’ont pas été remplacés.

Quelles personnalisations placer dans un thème enfant ?

Le thème enfant est adapté aux modifications qui concernent l’apparence ou le comportement du thème. Il peut notamment accueillir :

Cette liste ne signifie pas que toutes les fonctions d’un site doivent être placées dans le thème enfant. Une fonctionnalité indépendante du design, comme un type de contenu personnalisé ou une règle métier, a généralement davantage sa place dans une extension dédiée. Le thème doit rester consacré à la présentation et aux comportements étroitement liés à cette présentation.

La distinction est importante pour la maintenance. Si une fonction est liée au thème, son déplacement vers un autre thème peut demander une adaptation. Si elle est conservée dans une extension conçue pour cela, elle reste en principe indépendante du changement de présentation.

Thème enfant ou personnalisateur WordPress : quelle différence ?

WordPress propose des outils de personnalisation intégrés. Selon le thème utilisé, les réglages peuvent se trouver dans le menu Apparence, dans le Personnalisateur, dans l’Éditeur ou dans une interface propre au thème. Les modifications enregistrées dans la base de données, comme un logo, une couleur ou un menu, ne sont généralement pas perdues quand le thème est mis à jour.

Le thème enfant devient pertinent lorsque les réglages disponibles ne couvrent plus le besoin. Il intervient notamment dans les situations suivantes :

Avant de créer un thème enfant, il est donc utile de vérifier les possibilités natives du thème. Une modification gérée par les réglages prévus à cet effet est souvent plus durable et demande moins de maintenance. À l’inverse, ajouter du code dans un fichier du thème principal pour éviter de chercher une solution adaptée crée une dépendance fragile aux futures mises à jour.

Les éléments indispensables d’un thème enfant

Un thème enfant fonctionnel comporte au minimum un fichier de feuille de style et un fichier de fonctions. Dans les thèmes classiques, ces fichiers sont généralement placés dans un dossier situé dans wp-content/themes. Le nom du dossier peut être choisi librement, à condition de respecter les conventions habituelles : lettres minuscules, chiffres et tirets, sans espace ni caractère accentué.

La feuille de style contient un en-tête qui déclare le thème enfant et indique le thème parent. Un exemple de commentaire d’en-tête peut être écrit ainsi :

Theme Name: Mon thème enfant
Template: dossier-du-theme-parent

La valeur de Template doit correspondre au nom exact du dossier du thème parent, et non au nom affiché dans l’administration. Une différence entre ces deux valeurs empêche WordPress d’établir correctement la relation entre les thèmes.

Le fichier de fonctions peut contenir le chargement de la feuille de style du thème enfant, des fonctions personnalisées et des déclarations nécessaires à la présentation. Le code doit être ajouté sans recopier automatiquement le fichier de fonctions du parent. Le fonctionnement de functions.php diffère d’un modèle : le fichier du parent et celui de l’enfant peuvent tous deux être chargés. Copier tout le contenu du fichier parent dans l’enfant peut provoquer des déclarations en double et des erreurs PHP.

Créer un thème enfant depuis l’administration ou les fichiers du site

La méthode dépend de l’accès disponible. Une installation WordPress peut être administrée avec un gestionnaire de fichiers fourni par l’hébergement, un accès SFTP ou un outil de gestion de fichiers local. L’éditeur intégré des fichiers de thème est déconseillé pour les modifications importantes, car une erreur de syntaxe peut rendre l’administration difficile à utiliser et cet éditeur ne remplace pas une sauvegarde.

Préparer la sauvegarde
Avant toute intervention, sauvegardez les fichiers du site et la base de données. Une sauvegarde exploitable doit pouvoir être restaurée, et ne pas rester stockée au même endroit que les fichiers originaux. Notez également le nom du thème parent actif, son numéro de version et les personnalisations déjà réalisées.

Créer le dossier
Dans le répertoire des thèmes, créez un dossier consacré au thème enfant. Utilisez un nom distinct du parent, par exemple mon-theme-enfant. Ne modifiez pas le dossier du thème parent pour y ajouter les fichiers de l’enfant.

Ajouter la feuille de style
Créez un fichier nommé style.css et ajoutez-y l’en-tête qui identifie le thème enfant et son parent. Vous pourrez ensuite y placer les règles CSS propres au site.

Ajouter le fichier de fonctions
Créez un fichier nommé functions.php. Il doit commencer par la balise PHP et contenir uniquement le code nécessaire. Évitez la balise de fermeture PHP lorsque le fichier ne contient que du PHP, car des espaces ajoutés après cette balise peuvent provoquer des sorties inattendues.

Activer le thème enfant
Dans l’administration, ouvrez Apparence, puis Thèmes. Le thème enfant devrait apparaître parmi les thèmes disponibles. Activez-le après avoir vérifié que le thème parent est toujours installé. Un thème enfant ne remplace pas le parent : il en dépend pour une partie de ses fichiers et de ses ressources.

Charger correctement les styles du thème parent et de l’enfant

Le chargement des styles mérite une attention particulière. Une méthode ancienne consiste à importer la feuille de style du parent depuis celle de l’enfant avec une règle CSS. Cette approche peut fonctionner, mais elle ne constitue pas toujours la meilleure méthode pour gérer l’ordre de chargement et les dépendances.

Dans un thème classique, le chargement des feuilles de style peut être déclaré dans functions.php avec la fonction prévue par WordPress pour enregistrer et mettre en file les scripts et les styles. Le style de l’enfant doit être chargé après celui du parent afin que ses règles puissent le compléter ou le remplacer.

Un exemple de principe, à adapter au thème utilisé, consiste à déclarer une feuille de style enfant avec la feuille du parent comme dépendance. Le nom du fichier et l’identifiant du style parent varient selon le thème. Il est donc nécessaire d’examiner la manière dont le parent charge ses ressources avant de copier une solution trouvée ailleurs.

Après activation, vérifiez plusieurs pages dans une fenêtre privée du navigateur. Si les styles semblent absents, videz le cache du navigateur, puis celui d’une éventuelle extension de mise en cache ou d’un service de diffusion. Contrôlez aussi le chemin des fichiers et les erreurs affichées dans les outils de développement du navigateur.

Modifier un modèle sans perdre les mises à jour

Pour modifier un modèle, commencez par identifier le fichier utilisé par la page concernée. Un article, une page, une archive ou une page de recherche peut s’appuyer sur des fichiers différents. La hiérarchie des modèles de WordPress détermine le fichier retenu selon le type de contenu et le contexte d’affichage.

Une fois le fichier identifié, copiez-le dans le thème enfant en conservant sa structure de répertoires lorsque le thème en utilise une. Par exemple, une copie destinée à remplacer un modèle situé dans un sous-dossier doit rester au même emplacement relatif dans l’enfant. La copie devient alors prioritaire, tandis que les autres modèles continuent d’être lus dans le parent.

Cette priorité constitue un outil puissant, mais elle crée aussi une responsabilité de maintenance. Une copie de modèle ne reçoit pas automatiquement les améliorations du parent. Si le parent modifie la structure HTML, corrige une faille ou ajoute une compatibilité, la copie présente dans l’enfant peut rester ancienne.

Pour limiter ce risque :

Le fichier functions.php demande des précautions particulières

Le fichier functions.php permet d’ajouter des fonctions, des filtres et des actions. Il est aussi capable de provoquer une erreur bloquante si une parenthèse manque, si une fonction porte un nom déjà utilisé ou si une syntaxe incompatible avec la version de PHP est introduite.

Avant d’ajouter du code, vérifiez son objectif et son emplacement. Une fonction ayant un nom générique peut entrer en conflit avec une extension ou avec le thème parent. Préférez des noms préfixés par un identifiant propre au site, sans utiliser un nom susceptible d’être déjà déclaré par un autre composant.

Évitez de modifier directement une fonction du parent en la redéclarant dans l’enfant. Pour retirer un comportement, il faut parfois utiliser une fonction de retrait avec le même crochet et la même priorité que l’ajout original. La méthode dépend du code du parent et ne doit pas être appliquée sans lecture de ce code.

Lorsque le code devient volumineux, regroupez-le par fonction et documentez chaque bloc. Une extension dédiée peut devenir préférable si le code concerne des contenus, des utilisateurs, des traitements administratifs ou des règles qui doivent rester actifs après un changement de thème.

Thème enfant et éditeur de site basé sur les blocs

Les thèmes basés sur les blocs utilisent une logique différente des thèmes classiques. La mise en page peut être gérée par l’éditeur de site, des modèles en HTML et des parties de modèles. Les modifications enregistrées dans l’éditeur peuvent être stockées dans la base de données et prendre le dessus sur les fichiers du thème.

Dans ce contexte, créer un thème enfant reste possible, mais sa structure et ses possibilités varient selon le thème. Il faut vérifier le type de thème actif avant de suivre une procédure conçue pour un thème classique. Les fichiers de modèles, les compositions, le fichier de configuration et les réglages de styles peuvent avoir des rôles différents.

Une personnalisation réalisée dans l’éditeur de site ne se comporte pas nécessairement comme un fichier copié dans le thème enfant. Avant une mise à jour, exportez ou documentez les réglages importants lorsque l’interface le permet. Après la mise à jour, contrôlez les modèles, les styles globaux, les en-têtes, les pieds de page et les parties réutilisées.

Le bon choix dépend donc de l’objectif. Pour une modification visuelle prévue par l’éditeur, utilisez les outils du thème. Pour une adaptation nécessitant un contrôle des fichiers ou une logique particulière, étudiez la documentation technique du thème et testez le résultat sur une copie du site.

Comparer les méthodes de personnalisation

MéthodeUsage adaptéPoint de vigilance
Réglages du thèmeLogo, couleurs, menus, mise en page prévueLes options dépendent du thème et peuvent changer
CSS additionnelAjustements visuels limitésUne règle trop générale peut toucher d’autres éléments
Thème enfantModèles, styles et fonctions liés au thèmeLes modèles copiés doivent être suivis dans le temps
Extension dédiéeFonctionnalité indépendante de l’apparenceLe code doit rester compatible avec WordPress et les autres composants
Modification du thème parentCas exceptionnel dans un environnement contrôléLes changements peuvent être remplacés par une mise à jour

Cette comparaison permet de choisir le niveau de personnalisation approprié. Le thème enfant n’est pas une solution obligatoire pour chaque changement de couleur et ne remplace pas une extension lorsque la fonction doit survivre à un changement de thème.

Tester et maintenir le thème enfant dans le temps

L’activation du thème enfant ne marque pas la fin du travail. Elle inaugure une méthode de maintenance. Après chaque modification, contrôlez la page d’accueil, les articles, les pages, les archives, le menu, les formulaires et les zones visibles sur mobile. Le périmètre dépend du site, mais les tests doivent couvrir les modèles réellement utilisés.

Travaillez de préférence sur un environnement de préproduction ou une copie de test. Si le site ne dispose pas de cet environnement, choisissez une période de faible activité et réalisez une sauvegarde vérifiée avant toute opération. Ne mettez pas à jour plusieurs composants à la fois lorsqu’un diagnostic précis est nécessaire, car il devient plus difficile d’identifier l’origine d’un problème.

Conservez un journal des modifications avec la date, le fichier touché, la raison du changement et le résultat du test. Ce document peut rester très court, mais il évite de supprimer un fichier utile ou de répéter une correction déjà effectuée.

Après une mise à jour du thème parent, vérifiez en priorité les fichiers copiés dans l’enfant. Comparez les différences lorsqu’une nouvelle version apporte une correction dans le même modèle. Une mise à jour du parent ne modifie pas automatiquement le contenu du fichier enfant, ce qui explique pourquoi une personnalisation ancienne peut devenir incompatible avec une structure récente.

Erreurs fréquentes à éviter

Ces précautions réduisent les interventions improvisées et rendent le diagnostic plus lisible lorsqu’un affichage ou une fonction ne répond plus comme prévu.

FAQ sur le thème enfant WordPress

Le thème enfant est-il obligatoire pour personnaliser un site ?

Non. Les réglages du thème, le CSS additionnel ou l’éditeur de site peuvent répondre à certains besoins sans thème enfant. Il devient pertinent dès qu’un fichier du thème doit être modifié ou qu’un code lié au thème doit être ajouté.

Une mise à jour du thème parent met-elle à jour le thème enfant ?

Non. Le thème enfant utilise les fichiers du parent lorsqu’il ne possède pas sa propre version, mais les fichiers copiés dans l’enfant restent inchangés. Ces copies doivent être contrôlées après la mise à jour du parent.

Peut-on supprimer le thème parent après avoir activé l’enfant ?

Non. Le thème enfant dépend du parent pour les fichiers qu’il ne contient pas. Supprimer le parent peut provoquer des erreurs ou un affichage incomplet.

Faut-il créer un thème enfant pour ajouter du CSS ?

Pas dans tous les cas. Le champ de CSS additionnel prévu par WordPress ou par le thème peut convenir aux ajustements visuels. Un thème enfant offre davantage de contrôle lorsque les règles doivent être versionnées avec d’autres fichiers ou accompagnées de modifications de modèles.

Que faire si le site affiche une erreur après l’activation ?

Restaurez la sauvegarde si nécessaire, vérifiez le nom du dossier parent, examinez la syntaxe des fichiers PHP et désactivez temporairement le thème enfant depuis les fichiers du site si l’administration est inaccessible. Effectuez ensuite les corrections sur une copie de test avant une nouvelle activation.

En savoir plus à ce sujet :