Parmi les nombreux fichiers que l’on peut modifier dans une installation WordPress standard figurent les modèles et les feuilles de style du thème.
L’Éditeur de thème vous permet de le faire.
Cet écran est accessible depuis le Tableau de bord, puis Apparence, Éditeur de fichiers des thèmes.
L’Éditeur de thème
L’Éditeur de thème vous permet de visualiser ou de modifier (voir paragraphe suivant) n’importe quel code appartenant à un modèle ou une feuille de style du thème. Le contenu du fichier est alors affiché dans la grande zone de saisie qui remplit majoritairement l’écran.
Si un fichier est accessible en écriture, vous pouvez effectuer des modifications et les enregistrer. Si ce n’est pas le cas, vous verrez un message vous demandant de rendre ce fichier accessible en écriture afin de pouvoir sauvegarder vos modifications.
Le nom du fichier du thème en cours de modification apparaît en haut de la zone de saisie. Étant donné que le code d’un thème n’est composé que de texte, il n’est donc pas possible d’insérer des images dans la zone de saisie.
Menu de sélection du thème à modifier
Vous pouvez sélectionner le thème à modifier dans la liste déroulante et cliquer sur le bouton Sélectionner se trouvant à droite. Une fois que vous avez cliqué sur ce bouton, les modèles et feuilles de style du thème s’affichent sur la partie droite et la feuille de style principale du thème (style.css
) est placée en modification dans la zone de saisie.
Fichiers du thème
Vous pouvez sélectionner dans la liste se trouvant à droite de l’écran n’importe quel modèle ou feuille de style du thème pouvant être modifiée. Cliquer sur l’un de ces fichiers le placera dans la zone de saisie.
Soyez très prudent si vous modifiez des fichiers PHP du thème actif. L’éditeur de thème ne fait aucune copie de sauvegarde. Si vos modifications génèrent une erreur qui fait planter votre site, vous ne pourrez pas utiliser à nouveau l’éditeur pour la corriger. Si cela vous arrive, connectez-vous en FTP pour téléverser une sauvegarde fonctionnelle du fichier modifié ou pour renommer le nom du dossier du thème actif ce qui forcera WordPress à utiliser un autre thème.
Documentation
Lorsque vous modifiez un fichier PHP, une liste déroulante apparait sous la zone de saisie répertoriant toutes les fonctions présentes dans le fichier. En sélectionnant une fonction et en cliquant sur le bouton Consulter vous pouvez lire la documentation en rapport avec cette fonction sur developer.wordpress.org/reference (en anglais) (fonctions WordPress) ou sur php.net (en anglais) (fonctions PHP).
Mettre à jour le fichier
N’oubliez pas de cliquer sur le bouton Mettre à jour le fichier pour enregistrer les modifications que vous avez apportées. Après avoir cliqué sur ce bouton, vous devriez voir une notice affichant le message suivant « Le fichier a bien été modifié. ». Si vous ne voyez pas ce message, c’est que vos modifications ne sont pas enregistrées ! Notez que si ce fichier n’est pas en écriture, le bouton Mettre à jour le fichier ne sera pas disponible.
Note : modifier les fichiers de cette manière n’est pas recommandé. Si vous mettez à jour le thème, toutes vos modifications seront perdues. Le meilleur moyen pour éviter ceci est d’utiliser un thème enfant (en anglais).
Désactiver l’éditeur de thème
La modification du code d’un thème pouvant être risquée, vous voudrez peut-être désactiver cette fonctionnalité. Rien de plus simple ! En vous connectant par FTP pour modifier le fichier wp-config.php, descendez juste avant la ligne :
/* C'est tout, ne touchez pas à ce qui suit ! Bon blogging ! */
Et rajoutez celle-ci qui demande à WordPress d’interdire toute modification des fichiers via l’administration :
define( 'DISALLOW_FILE_EDIT', true );
Pensez à enregistrer le fichier wp-config.php
que vous avez modifié. Deux menus disparaîtront alors de l’administration : le menu Éditeur de fichiers des thèmes sous Apparence et le menu Éditeur de fichiers des extensions sous Extensions.
Traduit par Loïc Antignac
Relu par Jenny Dupuy & Marie Comet
Dernière mise à jour le 25 janvier 2022
Contribuer à la documentation en français de WordPress
Journal des modifications
25 janvier 2022 – Jenny Dupuy – Remplacement des menus Éditeur de thème par Éditeur de fichiers des thèmes.