Écran Modifier les thèmes

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.

Écran Modifier les thèmes
Avertissement Modifier les 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.

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 2022Jenny Dupuy – Remplacement des menus Éditeur de thème par Éditeur de fichiers des thèmes.