Si vous utilisez WordPress depuis quelques temps, vous avez sûrement dû entendre parler du fichier functions.php. Ce fichier est un outil puissant pour quiconque souhaite avoir un contrôle poussé du CMS, mais il doit être manipulé avec précautions.
Nous allons explorer tout au long de cet article ce qu’est functions.php, comment l’utiliser, et partager des exemples pratiques pour tirer le meilleur parti de cette ressource.
Table of Contents
Le Fichier functions.php de WordPress, C’Est Quoi Donc ?
Le fichier functions.php est un élément central de WordPress. Ce fichier est présent au sein de tous les thèmes installés sur votre site. Il permet d’ajouter des fonctionnalités à WordPress sans pour autant ajouter un nouveau plugin. Il vous permet notamment de contrôler la gestion des menus, les widgets, et bien d’autres choses encore.
Ce fichier se trouve dans le dossier de chaque thème WordPress. Il s’active au moment où le thème est activé et on peut y accéder via l’éditeur de thème “Apparence” ==> “Éditeur de thème” ou directement sur le serveur de votre hébergeur via FTP.
Que Pouvez-Vous Faire avec functions.php ?
Personnaliser Certaines Fonctions
Vous pouvez écrire des fonctions en langage PHP qui vont vous permettre d’ajouter ou de modifier certains comportements du site. Vous pouvez par exemple définir de nouvelles tailles d’images, ajouter des shortcodes ou même personnaliser l’affichage du tableau de bord WordPress.
Voici un exemple de code pour personnaliser les tailles d’images :
function custom_image_size() {
add_image_size(‘custom-size’, 800, 600);
}
add_action(‘after_setup_theme’, ‘custom_image_size’);
Ce code ajoute une nouvelle taille d’image de 800×600 pixels qui pourra être utilisée dans les pages et les articles du site.
Désactiver des Fonctionnalités par Défaut
Vous pouvez également utiliser functions.php pour modifier certaines fonctionnalités qui ne vous conviennent pas. Vous pouvez par exemple désactiver l’affichage des emojis, qui ont pour effet néfaste de ralentir le site.
Voici un exemple de code pour désactiver les emojis :
remove_action(‘wp_head’, ‘print_emoji_detection_script’, 7);
remove_action(‘wp_print_styles’, ‘print_emoji_styles’);
Ce code a pour effet de supprimer les scripts et les styles dont le but est de permettre l’affichage des emojis, allégeant ainsi la charge sur WordPress.
Quelles Sont les Différences entre functions.php Et un Plugin ?
Quand Utiliser functions.php Plutôt Qu’un Plugin ?
Le fichier functions.php étant propre à chaque thème, les modifications apportées ne seront valables qu’au sein de ce thème. Si vous désirez apporter des modifications qui persisteront malgré le changement de thème, préférez alors utiliser un plugin.
Avantages et Inconvénients de functions.php
Avantages de functions.php
functions.php est facile à modifier et permet d’ajouter ou de modifier des fonctions sans alourdir votre site avec l’installation d’un plugin.
Inconvénients de functions.php
Les modifications opérées au sein du fichier functions.php disparaîtront si vous décidez de changer le thème graphique du site. Vous devrez alors transférer les changements dans le fichier functions.php du nouveau thème, ou bien installer une extension.
Les Bonnes Pratiques à Observer avec functions.php
Créer un Thème Enfant
La première chose à faire quand on travaille avec functions.php est d’utiliser un thème enfant. Un thème enfant est une sorte de “sous-thème” qui fonctionne de concert avec le thème principal.
Mais pourquoi me direz-vous ? Eh bien parce que si vous faites vos modifications directement dans le thème parent, celles-ci seront écrasées lorsque vous mettrez à jour le thème. Vous évitez donc cet inconvénient en utilisant un thème enfant.
Bien Organiser le Fichier pour Retrouver ses Petits
Il est important de bien structurer votre fichier functions.php par exemple en utilisant les commentaires et en regroupant les fonctionnalités par groupes (images, shortcodes…). Cela facilitera grandement la lecture et la maintenance du fichier sur le long terme.
Testez les Modifications avant d’Aller Plus Loin !
Testez toujours vos modifications dans un environnement de développement avant de passer en production. Vous pouvez par exemple utiliser des outils comme Query Monitor afin de détecter d’éventuelles erreurs et vous assurer que le site fonctionne toujours correctement.
Sauvegardez le Fichier Original
Faites une copie du fichier functions.php et renommez-la par exemple enfunctions-sauvegarde.php. De cette façon, vous pourrez revenir à un fichier “propre” si vous rencontrez un problème que vous ne parvenez pas à résoudre.
Quelques Exemples de Fonctionnalités à Ajouter à WordPress
Ajouter le code de suivi Google Analytics
Le code de suivi Google Analytics peut être ajouté directement dans functions.php :
function add_google_analytics() { ?>
<script async src=”https://www.googletagmanager.com/gtag/js?id=UA-XXXXX-X”></script>
<script>
window.dataLayer = window.dataLayer || [];
function gtag(){dataLayer.push(arguments);}
gtag(‘js’, new Date());
gtag(‘config’, ‘UA-XXXXX-X’);
</script>
<?php }
add_action(‘wp_head’, ‘add_google_analytics’);
Vous pouvez remplacer UA-XXXXX-X par votre propre identifiant Google Analytics afin d’activer le suivi.
Désactiver l’Éditeur Gutenberg
Si vous préférez utiliser l’éditeur classique de WordPress, cette simple ligne de code désactivera l’éditeur de blocs Gutenberg :
add_filter(‘use_block_editor_for_post’, ‘__return_false’);
Personnaliser les Shortcodes
Les shortcodes permettent d’afficher certaines informations directement dans votre article. Cet exemple affichera l’année actuelle :
function current_year_shortcode() {
return date(‘Y’);
}
add_shortcode(‘year’, ‘current_year_shortcode’);
Pour l’utiliser, il vous suffit d’insérer [year] dans une page ou un article, et WordPress affichera automatiquement l’année en cours.
Les Problèmes Courants Rencontrées avec functions.php et Leurs Solutions
Erreurs de Syntaxe
C’est l’erreur la plus courante mais aussi la plus simple à corriger. Par exemple, un simple point-virgule oublié peut totalement bloquer votre site. Vérifiez donc toujours la syntaxe employée et utilisez au besoin un éditeur de code qui pourra vous avertir lors d’éventuelles erreurs de syntaxe.
Page Blanche (Erreur Fatale)
Une erreur au sein du fichier functions.php peut provoquer l’affichage d’une page totalement vide. Dans ce cas, la solution est d’accéder à functions.php via un logiciel FTP (ou via le gestionnaire de fichiers de votre hébergeur), l’ouvrir et tenter de localiser l’erreur. Au besoin, remplacer le fichier corrompu par une sauvegarde faite au préalable.
Conflits avec d’Autres Thème ou Plugins
Il peut arriver que les modifications apportées à functions.php entrent en conflit avec les thèmes ou plugins de votre site. Dans ce cas, désactivez les plugins un à un et changez le thème jusqu’à ce que le problème n’apparaisse plus.
Conclusion
Le fichier functions.php est donc un outil simple à manier mais très puissant concernant l’optimisation et la personnalisation de votre installation WordPress. En l’utilisant correctement, vous pouvez ajouter des fonctionnalités, désactiver des éléments inutiles, et optimiser le fonctionnement de votre site. N’oubliez cependant pas d’observer les bonnes pratiques comme travailler sur un thème enfant, sauvegarder une copie du fichier avant toute modification et bien sûr de tester ces dernières dans un environnement de test avant toute mise en production.
La FAQ sur le Fichier functions.php
Puis-Je Ajouter N’Importe Quelle Fonction ?
Non, seules les fonctions liées à WordPress peuvent être utilisées. Assurez-vous en au préalable.
J’Ai Cassé mon Site en Modifiantfunctions.php. Que Puis-Je Faire ?
Ne paniquez pas ! Accédez àfunctions.php via FTP et remplacez le fichier corrompu par un fichier de sauvegarde. Vous pouvez également utiliser le mode de récupération de WordPress.
Est-Ce Que les Modifications Apportées àfunctions.php Peuvent Ralentir mon Site ?
Non, sauf si vous ajoutez des fonctions mal codées ou particulièrement complexes. Suivez les bonnes pratiques énoncées dans cet article pour ne pas alourdir votre site.