Ajouter du code personnalisé dans WordPress, Cela peut être intéressant : une petite fonction trouvée sur un forum, un snippet conseillé dans une vidéo, ou un correctif rapide pour adapter votre thème.
Mais un copier-coller mal placé peut suffire à casser votre site. Il existe des méthodes simples et sûres pour personnaliser WordPress sans prendre de risques.
Voyons ensemble les bonnes pratiques à adopter en 2025.
1. Les erreurs les plus fréquentes
Avant de voir comment faire correctement, voyons d’abord ce qu’il vaut mieux éviter.
Modifier le fichier functions.php du thème parent
C’est l’erreur de base.
Le fichier functions.php gère le bon fonctionnement du thème : la moindre faute de syntaxe (une virgule, une accolade manquante…) peut rendre le site inaccessible. Et surtout, à la prochaine mise à jour du thème, vos ajouts disparaîtront.
Autre cas : certains modifient l’en-tête du fichier style.css pour renommer le thème.
Mauvaise idée : WordPress ne reconnaît plus la liaison avec le thème d’origine, ce qui bloque les mises à jour automatiques.
Copier-coller du code sans vérification
Tous les extraits trouvés sur Internet ne sont pas fiables. Certains datent de plusieurs années ou utilisent des fonctions obsolètes. Avant d’ajouter du code, prenez le temps de vérifier sa source et sa compatibilité avec votre version de WordPress.
Tester directement en production
Modifier un site en ligne, c’est risquer l’écran blanc de la mort à tout moment. Un site de préproduction ou un environnement local permet d’éviter bien des mauvaises surprises.
En cas de panne, il faudra souvent passer par FTP (ou le gestionnaire de fichiers d’o2switch) pour supprimer le code fautif. Si cela vous arrive, notre article Les erreurs WordPress fréquentes (et comment les corriger) pourra vous aider.
2. Les bonnes méthodes pour ajouter du code en 2025
Voici trois façons simples et sûres d’ajouter du code personnalisé selon vos besoins, des classique et des plus modernes.
Le thème enfant : pour les petites personnalisations
Si votre code concerne uniquement l’apparence de votre site (design, affichage d’un élément, comportement visuel) ou une petite fonctionnalité à ajouter, le thème enfant reste la meilleure option.
Il permet de modifier functions.php sans toucher au thème parent, ce qui préserve vos ajouts lors des mises à jour.
Pour découvrir comment créer un thème enfant, vous pouvez lire notre article Comment créer et installer un thème enfant dans WordPress.
L’extension d’extraits de code : pour tester facilement et rapidement
C’est la solution la plus pratique.
Les extensions comme Code Snippets ou WPCode permettent d’ajouter, d’activer ou de désactiver du code sans toucher aux fichiers du site. Autre avantage : plus besoin de thème enfant !
Avantages :
- interface claire et structurée ;
- gestion des snippets par catégories (tests, production, visuel, etc.) ;
- possibilité d’enregistrer et de réutiliser ses snippets sur plusieurs sites grâce à la sauvegarde cloud (selon l’extension utilisée).
c. Le mu-plugin : pour les fonctions essentielles
Pour les utilisateurs un peu plus à l’aise, les mu-plugins (ou must-use plugins) sont idéaux pour les fonctions indispensables qui doivent se charger à chaque fois que WordPress démarre. Ces fichiers PHP sont placés dans le dossier /wp-content/mu-plugins/.
Ils se chargent automatiquement, sans activation manuelle.
Exemples concrets :
- un mu-plugin qui désactive le mode plein écran de l’éditeur Gutenberg pour tous les utilisateurs ;
- un autre qui protège les adresses e-mail affichées sur le site grâce à la fonction native
antispambot()de WordPress.
Ces fonctions restent actives même si une autre extension est désactivée ou si vous changez de thème. Pour en savoir plus et apprendre à les utiliser, vous pouvez lire l’article : MU-plugins WordPress : à quoi servent-ils et comment les utiliser ?
3. Les réflexes d’un code propre
Même si WordPress pardonne beaucoup, quelques réflexes simples évitent bien des soucis.
Préfixez vos fonctions
Deux fonctions portant le même nom peuvent entrer en conflit.
Prenez l’habitude d’ajouter un préfixe personnel à vos fonctions, par exemple :
function em_custom_footer_message() {
echo 'Merci de votre visite !';
}Par exemple, j’utilise em_ pour mes fonctions, mais vous pouvez choisir ce que vous voulez : vos initiales, celles de votre site ou du client. Cela évite les collisions avec le code d’un thème ou d’une extension.
Protégez vos fichiers
Avant d’exécuter du code, vérifiez toujours que WordPress est bien chargé :
if ( ! defined( 'ABSPATH' ) ) exit;Cette simple ligne empêche l’accès direct au fichier PHP depuis un navigateur.
Échappez les données
Pour éviter les failles XSS ou les erreurs d’affichage, utilisez les fonctions d’échappement :
esc_html()pour le texte ;esc_url()pour les liens ;wp_kses()pour autoriser uniquement certaines balises HTML.
Et surtout : n’insérez jamais directement du code HTML dans une variable non échappée.
4. Testez votre code avant la mise en ligne
Même avec toutes les précautions du monde, une erreur peut se glisser. Avant de modifier un fichier ou d’ajouter une fonction :
- testez votre code sur un site local : MAMP, XAMPP, Local ou Studio by WordPress.com (le nouvel outil d’Automattic) permettent de créer facilement un environnement de test ;
- gardez toujours une sauvegarde à portée de main ;
- si possible, travaillez d’abord sur une préproduction avant la mise en ligne.
Et si vous aimez la ligne de commande, WP-CLI peut vous sauver la mise :
wp plugin deactivate code-snippetsSi un snippet provoque un blocage, cette commande le désactive proprement via SSH. Pour vous connecter rapidement en ssh, voir cet https://blog.o2switch.fr/se-connecter-ssh-o2switch/#toc-3 et si vous souhaitez en savoir plus sur WP-CLI, vous pouvez aller lire cet article : https://blog.o2switch.fr/wp-cli-guide-ligne-de-commande/.
Conclusion
Ajouter du code dans WordPress n’a rien de dangereux… à condition de savoir où le placer.
Entre le thème enfant, l’extension de snippets et les mu-plugins, vous disposez aujourd’hui de solutions fiables pour personnaliser votre site en toute sérénité. Alors oui, n’hésitez pas à personnaliser votre site, mais faites-le proprement, pour ne jamais avoir à dire : « J’ai tout cassé ! »
Image mise en avant : merci à Markus Spiske
