Le fichier WordPress functions.php permet de personnaliser son site et son thème WordPress. Mais il est très particulièrement délicat. Découvrez comment bien l’utiliser sans planter votre site.
Le fichier WordPress functions.php est un fichier important de WordPress.
Il vous ouvre bien des possibilités de personnalisation, de configuration et d’optimisation de votre site WordPress.
Mais c’est aussi un fichier particulièrement délicat.
Car si vous l’utilisez mal ou faites des erreurs, vous pouvez planter votre site.
Connaitre le fichier WordPress functions.php et comment bien l’utiliser est essentiel. Suivez le guide.
Présentation du fichier WordPress functions.php
Le fichier functions.php est un fichier utilisé par les thèmes WordPress. Dont celui que vous utilisez sur votre site.
Il est automatiquement chargé par WordPress et fonctionne comme un plugin (ou un ensemble de plugins dans un seul fichier) sans être lui-même un plugin WordPress.
Généralement, ce fichier est utilisé pour définir des fonctions, des classes, des hooks et des filtres, au moyen de PHP, pour ajouter des fonctionnalités ou modifier les fonctionnalités par défaut d’un site WordPress.
Dans le jargon informatique, on parle souvent de bout de code, voire de fragment de code. C’est à dire quelques lignes de code pour effectuer une tâche simple et spécifique. Dans le jargon WordPress, on parle de snippet, voire de code snippet.
Bien que faisant partie du thème WordPress de votre site, ce fichier n’est pas limité à la personnalisation de votre thème.
Comme le fichier functions.php vous permet d’ajouter du code PHP plutôt que du simple HTML, les possibilités de modification sont illimitées. Bien sûr, à travers ce code PHP, vous pouvez ajouter du HTML, du CSS ou du Javascript à votre site.
Ainsi, vous pouvez apporter des modifications à n’importe quelle partie de votre site, comme le font les plugins WordPress. D’où sa puissance et sa sensibilité.
Où trouver le fichier functions.php
Le fichier WordPress functions.php se trouve dans le dossier de votre thème.
Pour le trouver, vous pouvez vous connecter à votre serveur en utilisant un client FTP et naviguer jusqu’à …/wp-content/themes/[nom-du-theme-actif]/functions.php.
Consulter cet article pour maîtriser l’arborescence WordPress et ses principaux fichiers et répertoires.
Comment modifier le fichier functions.php
Il y a 2 méthodes principales pour modifier le fichier functions.php.
La première est d’utiliser l’éditeur intégré à WordPress, disponible sur la page Apparence » Editeur. Cet éditeur permet de modifier les fichiers qui composent le thème WordPress de votre site.
Certains remontent avoir eu des problèmes avec cet éditeur. Je n’ai jamais rencontré ce genre de souci.
Par contre, désactiver cet éditeur fait partie des recommandations de sécurité WordPress. De plus, cet éditeur ne permet pas une gestion de fichier aussi fine qu’un éditeur traditionnel.
Je vous conseille donc de passer à l’autre méthode.
Elle consiste à utiliser un client FTP, comme FileZilla ou WinSCP, et d’utiliser votre éditeur de texte préféré, idéalement un éditeur comprenant la syntaxe PHP, idéal pour repérer les erreurs de frappe.
Comment bien utiliser le fichier WordPress functions.php
Comme je l’ai indiqué plus haut, ce fichier est particulièrement sensible.
Travailler avec le fichier WordPress functions.php implique d’ajouter du code PHP à votre site web. La moindre erreur, comme une bête virgule manquante ou au mauvais endroit, peut déclencher une erreur sur votre site.
WordPress est de plus en plus efficace dans la gestion de ces erreurs. Mais le mieux est encore d’essayer d’éviter tout problème, non ?
Suivez donc ces bonnes pratiques avant la moindre modification.
Sauvegardez votre site
Sauvegarder votre site est la méthode de base.
Il s’agit de la pratique essentielle et incontournable à faire avant toute intervention sur votre site. Et à faire régulièrement.
Si quoique ce soit tourner mal avec votre modification, vous pouvez toujours restaurer cette sauvegarde pour que votre site fonctionne de nouveau.
Sauvegardez le fichier functions.php actuel
Un complément à la recommandation précédente.
Pourquoi ce complément ?
Parce que la restauration d’un seul fichier est toujours plus rapide que la restauration d’un site dans son ensemble.
Parce que si tout se passe bien, vous aurez un historique du fichier functions.php, de ses différentes versions sur votre site et des modifications apportées. Ce n’est pas obligatoire. Mais selon la nature des modifications apportées et leur portée, cela pourrait vous être utile à l’avenir. Croyez-en l’expérience d’un ancien développeur :-)
Utilisez toujours un thème enfant
Le fichier functions.php de WordPress est stocké dans le répertoire du thème WordPress de votre site. À la mise à jour de ce thème, le fichier functions.php sera écrasé par la mise à jour.
Et les modifications que vous y aurez apportées seront perdues.
Vous voulez éviter ça ? J’en étais sûr.
Vous devez alors créer et utiliser un thème enfant WordPress et ajouter votre code au fichier functions.php du thème enfant.
En utilisant un thème enfant, vous êtes ainsi en mesure de mettre à jour le thème parent (et de profiter de cette mise à jour) sans perdre toutes les personnalisations de votre fichier functions.php.
Testez sur un site de test
La recommandation définitive. Que je n’utilise pas toujours, je dois être honnête.
Ne testez pas vos modifications au fichier functions.php directement sur votre site réel, celui qui est référencé par Google et est accessible aux internautes.
Testez vos modifications au fichier functions.php sur un site de test identique à votre site réel.
Puis, si elles sont fonctionnelles, appliquez-les à votre site réel.
Cela vous permet de ne pas perturber votre site réel et de vérifier qu’il n’y a pas d’erreurs potentielles, que le code fonctionne comme prévu.
Un “site de test” est une copie identique de votre site web en ligne. Cette copie est accessible par une autre adresse web connue de vous seul. Ce site de test vous permet de tester tous les changements possible et imaginables (et pas seulement les modifications du fichier functions.php) sans agir et perturber votre site réel en production.
Une alternative au fichier functions.php
Le fichier WordPress functions.php permet donc d’ajouter du code PHP à votre site. Mais ce n’est pas la méthode la plus conviviale, ni la méthode la plus sécurisée.
Cependant, il existe une alternative que je vous recommande, surtout si vous êtes débutant : utiliser un plugin de gestion de code.
Cette méthode présente quelques avantages :
- Aucun lien avec le thème WordPress de votre site : si vous changez de thème, vos personnalisations seront toujours présentes.
- Une meilleure organisation : l’organisation de vos extraits de code est facilitée, ce qui est appréciable si vous ajoutez un grand nombre d’extraits de code à votre site.
- Plus de contrôle : la gestion de vos extraits de code est elle aussi facilitée car vous pouvez activer ou désactiver chaque fonction PHP d’un simple clic.
Bref, la solution idéale à mon sens.
Certes, vous ajoutez un plugin à ceux que vous utilisez. Mais les gains sont supérieurs à ce léger inconvénient.
Je vous recommande 2 plugins :
- le plugin Code Snippets
- le plugin Woody Code Snippets
Vous aurez plus d’informations sur ces 2 plugins dans cet article dédié aux snippets WordPress et comment les gérer facilement sur votre site.
L’utilisation du plugin dédié ne vous dispense malgré tout de sauvegarder votre site, et même de tester sur un site de test.
Conclusion
Le fichier WordPress functions.php.
Cela étant, pour vous débarrasser de l’administration de votre site WordPress et vous libérer du temps pour des activités plus importantes, faites appel à un spécialiste.
Vous avez des questions ou des commentaires sur ce fichier ? Vous rencontrez un problème ? N’hésitez pas : les commentaires sont là pour ça !
