Vous ne savez pas ce qu’est le fichier functions.php de WordPress ou ce que vous pouvez faire avec ?

En résumé, le fichier functions.php de WordPress vous permet d’ajouter des extraits de code à votre site. Vous pouvez utiliser ces extraits de code de toutes sortes de façons utiles. Comprendre le fonctionnement du fichier functions.php peut donc vous aider à construire un meilleur site WordPress.

Dans notre guide ultime du fichier functions.php de WordPress, vous allez apprendre tout ce que vous devez savoir sur ce fichier.

Une fois que vous saurez tout sur le fichier functions.php, nous partagerons également 17 extraits de code functions.php utiles pour vous aider à personnaliser votre site.

Que fait le fichier functions.php de WordPress ?

Le fichier WordPress functions.php est un fichier de thème que vous pouvez utiliser pour ajouter des extraits de code personnalisés à votre site. Vous pouvez utiliser ces extraits de code pour modifier le fonctionnement de différentes parties de votre site ou pour ajouter un nouveau contenu/code à votre site.

Bien qu’il soit inclus dans votre thème, le fichier WordPress functions.php n’est pas limité à la personnalisation de votre thème.

Vous pouvez apporter des modifications à n’importe quelle partie de votre site, comme le font les extensions.

Voici quelques types d’ajustements courants que vous pouvez effectuer à l’aide du fichier WordPress functions.php :

  • Modifier le comportement de base de WordPress, comme le nombre d’articles à afficher sur la page de résultats de recherche ou le contenu à inclure dans le flux RSS de votre site.
  • Créer vos propres codes courts personnalisés.
  • Ajouter du nouveau contenu ou des scripts à votre site, par exemple en injectant un script de votre service de discussion en direct sur certaines pages ou en modifiant le pied de page de votre site.

Et ce n’est pas tout..

Étant donné que le fichier functions.php vous permet d’ajouter des extraits de code PHP personnalisés à votre site plutôt que du HTML statique, les possibilités de modification sont illimitées.

Où se trouve le fichier WordPress functions.php ?

Le fichier WordPress functions.php est situé dans le dossier de votre thème actif, avec les autres fichiers du thème. Pour trouver le fichier, vous pouvez vous connecter à votre serveur en utilisant le FTP ou un outil de gestion de fichiers et naviguer jusqu’à …/wp-content/themes/[nom-theme-actif]/functions.php

Par exemple, si vous utilisez le thème populaire OceanWP, le fichier functions.php se trouve à l’adresse suivante : … /wp-content/themes/oceanwp/functions.php

Comment travailler en toute sécurité avec le fichier functions.php

Parce que travailler avec le fichier WordPress functions.php implique d’ajouter du code à votre site web, il est important de suivre quelques bonnes pratiques avant de commencer à faire des modifications.

Même quelque chose d’aussi simple qu’une virgule ou une apostrophe manquante peut déclencher des erreurs sur votre site, comme l’écran blanc de WordPress.

Dans les versions récentes de WordPress, la gestion de ces erreurs a été améliorée, notamment en affichant le message « Une erreur critique s’est produite sur votre site web » ou en vérifiant la présence d’erreurs PHP avant d’enregistrer vos modifications.

Cependant, pour éviter tout problème, nous vous recommandons de suivre les meilleures pratiques suivantes..

Testez votre code functions.php sur un site de staging

Avant d’ajouter des extraits de code functions.php à votre site WordPress, nous vous recommandons de les tester d’abord sur une version de staging de votre site. Cela vous permet de vérifier qu’il n’y a pas d’erreurs potentielles et que l’extrait de code fonctionne comme prévu.

Si vous hébergez chez Kinsta, Kinsta offre un outil de simulation en 1 clic sur tous les plans, ce qui est l’un des avantages de l’hébergement WordPress infogéré.

Si vous êtes hébergé ailleurs, vous pouvez consulter notre guide sur la mise en place d’un site de staging WordPress.

Sauvegardez votre site avant de modifier le fichier functions.php

En plus de tester sur un site de staging, vous voudrez également sauvegarder votre site web avant d’ajouter l’extrait de code au fichier functions.php de votre site.

Il s’agit d’une bonne pratique à suivre lorsque vous modifiez des fichiers WordPress.

En cas de problème avec l’extrait de code, vous pouvez restaurer ce point de sauvegarde pour rétablir instantanément le fonctionnement de votre site.

Si vous hébergez chez Kinsta, Kinsta sauvegarde automatiquement votre site tous les jours et vous pouvez également créer manuellement une sauvegarde à tout moment. Si vous êtes hébergé ailleurs, vous pouvez lire notre guide sur la façon de sauvegarder un site WordPress.

Utilisez toujours un thème enfant si vous modifiez le fichier functions.php

Parce que le fichier functions.php de WordPress est situé dans le code de votre thème WordPress, votre thème écrasera le fichier functions.php lorsque vous mettrez à jour votre thème.

Pour éviter que les modifications que vous avez apportées au fichier functions.php de votre thème ne soient écrasées, vous devez toujours utiliser un thème enfant WordPress et ajouter vos extraits de code au fichier functions.php du thème enfant.

En utilisant un thème enfant, vous êtes toujours en mesure de mettre à jour le thème parent si nécessaire, mais toutes vos personnalisations du fichier functions.php ne seront jamais écrasées.

Pour en savoir plus, consultez notre guide complet sur la création d’un thème enfant WordPress.

2 Alternatives au fichier functions.php qui pourraient être meilleures

Bien que le fichier WordPress functions.php offre un moyen facile d’ajouter des extraits de code à votre site, il existe des alternatives au fichier functions.php qui offrent une meilleure solution dans la plupart des situations :

  1. Utiliser une extension de gestion de code
  2. Stocker les extraits de code dans une extension personnalisée

Ces alternatives peuvent présenter quelques avantages par rapport à l’utilisation du fichier functions.php :

  • Pas de lien avec votre thème – cela signifie que si vous changez de thème, vos personnalisations du fichier functions.php seront toujours présentes.
  • Meilleure organisation – ces alternatives facilitent l’organisation de vos extraits de code, ce qui peut être utile si vous prévoyez d’ajouter beaucoup d’extraits de code à votre site.
  • Plus de contrôle – dans le cas d’une extension de gestion de code, vous disposez d’options utiles telles que l’activation/désactivation d’un extrait à l’aide d’un bouton bascule, l’exécution d’extraits uniquement sur le frontend ou le backend, et bien plus encore.

Utilisez un plugin de gestion de code

Une extension de gestion de code est une extension qui vous offre une interface conviviale pour ajouter et modifier des extraits de code qui seraient autrement placés dans le fichier functions.php.

L’une des options les plus populaires est l’extension gratuite Code Snippets, mais vous pouvez trouver d’autres extesions qui offrent des fonctionnalités similaires.

Avec Code Snippets, vous pouvez ajouter vos extraits de code functions.php à partir du tableau de bord de WordPress, avec des options.

  • Ajouter un titre et une description.
  • Organiser vos extraits à l’aide d’étiquettes.
  • N’exécuter l’extrait que sur une certaine partie de votre site.
Ajout d'un extrait de code dans l'extension Code Snippets.
Ajout d’un extrait de code dans l’extension Code Snippets.

Vous pouvez ensuite voir tous vos extraits dans une liste et les activer/désactiver facilement si nécessaire.

Comment gérer les extraits de code dans Code Snippets.
Comment gérer les extraits de code dans Code Snippets.

Comme Code Snippets est une extension, tous vos extraits de code seront toujours présents même si vous changez de thème WordPress.

Créer un plugin de fonctionnalité personnalisé

Une autre alternative au fichier WordPress functions.php est de créer votre propre extension personnalisée pour héberger les extraits de code.

Bien que cela puisse sembler compliqué, c’est en fait beaucoup plus simple qu’il n’y paraît.

Voici comment cela fonctionne :

  1. Créez un dossier sur votre ordinateur local pour votre extension.
  2. Créez un fichier .php dans ce dossier et modifiez-le avec votre éditeur de texte préféré.
  3. Ajoutez le modèle de code ci-dessous au fichier.
  4. Ajoutez vos extraits de code functions.php au fichier
<?php

/**
* Plugin Name: My Custom Code Snippets
* Description: This is a custom plugin to house code snippets.
* Author: Kinsta
* Version: 1.0
*/

/* Add the first code snippet below this comment - use the comment to explain what it does. */
[CODE]

/* Add the second code snippet below this comment. */
[CODE]

/* Continue as needed. */
[CODE]

?>

Ensuite, il vous suffit d’installer et d’activer l’extension sur WordPress. Voici deux façons de le faire :

  1. Connectez-vous à votre serveur via FTP/SFTP et téléversez le dossier de l’extension personnalisée dans le dossier wp-content/plugins. Ensuite, allez dans la liste des Extensions et activez l’extension.
  2. Utilisez votre ordinateur pour créer un fichier .zip du dossier. Ensuite, allez dans Extensions → Ajouter et téléversez le fichier .zip pour l’installer comme n’importe quelle autre extension.

Comment accéder au fichier WordPress functions.php : 2 options

Il existe différentes façons d’accéder au fichier functions.php de WordPress et de le modifier. Voici 2 des méthodes les plus polyvalentes qui fonctionneront chez n’importe quel hébergeur :

  1. L’éditeur de code de WordPress dans le tableau de bord du thème.
  2. SFTP et votre propre éditeur de code.

1. Utiliser l’éditeur de code du thème dans le tableau de bord de WordPress

Par défaut, WordPress vous permet de modifier tout le code de votre thème depuis votre tableau de bord WordPress, y compris le fichier functions.php :

  1. Ouvrez votre tableau de bord WordPress.
  2. Allez dans Apparence → Éditeur de fichiers de thème.
  3. Sélectionnez le fichier Fonctions du thème (functions.php) dans la liste Fichiers du thème sur le côté droit.
  4. Ajoutez vos modifications dans l’éditeur de code.
  5. Cliquez sur le bouton Mettre à jour le fichier pour enregistrer vos modifications.
Comment modifier le fichier functions.php depuis votre tableau de bord WordPress.
Comment modifier le fichier functions.php depuis votre tableau de bord WordPress.

Ceci étant dit, de nombreuses personnes souhaitent désactiver l’édition de fichiers dans le tableau de bord de WordPress afin d’améliorer la sécurité. Dans ce cas, vous pouvez utiliser la méthode suivante.

2. Utiliser SFTP + votre propre éditeur de code

Pour une autre façon de modifier le fichier WordPress functions.php, vous pouvez vous connecter à votre serveur via FTP/SFTP et modifier le fichier de cette façon.

Voici comment procéder :

  1. Téléchargez un client FTP si vous ne l’avez pas encore fait – nous utiliserons le client gratuit FileZilla pour les captures d’écran.
  2. Connectez-vous à votre serveur à l’aide de vos identifiants FTP – voici comment utiliser SFTP pour vous connecter.
  3. Utilisez la structure des dossiers pour naviguer jusqu’à . ../wp-content/themes/[votre-theme-enfant-actif]
  4. Faites un clic droit sur le fichier functions.php et sélectionnez Modifier.
Comment modifier le fichier functions.php avec FileZilla.
Comment modifier le fichier functions.php avec FileZilla.

Cela devrait télécharger le fichier sur votre ordinateur local et l’ouvrir automatiquement dans un éditeur de texte. Vous pouvez maintenant ajouter vos extraits de code au fichier.

FileZilla ouvrira le fichier dans un éditeur de texte local -- par exemple Sublime Text.
FileZilla ouvrira le fichier dans un éditeur de texte local — par exemple Sublime Text.

Lorsque vous avez terminé, enregistrez vos modifications et fermez le fichier.

FileZilla devrait alors afficher une invite pour retéléverser la version modifiée sur votre serveur.

Assurez-vous de téléverser à nouveau le fichier functions.php une fois que vous avez effectué vos modifications.
Assurez-vous de téléverser à nouveau le fichier functions.php une fois que vous avez effectué vos modifications.

Principales fonctions utiles à ajouter à votre fichier functions.php de WordPress

Maintenant que vous savez comment modifier le fichier WordPress functions.php, passons en revue certains des extraits de code functions.php les plus utiles que vous pouvez ajouter à votre site.

Afficher la date de dernière modification sur les articles de blog

Par défaut, la plupart des thèmes affichent la date à laquelle vous avez publié un article de blog. Toutefois, si vous mettez régulièrement à jour et actualisez d’anciens contenus, vous souhaiterez peut-être afficher également la date de dernière modification (ou remplacer la date de publication par la date de dernière modification).

Cela permet non seulement à vos visiteurs humains de savoir que vous mettez toujours le contenu à jour, mais aussi à Google de savoir que votre contenu est frais.

function show_last_updated( $content ) {
$u_time = get_the_time('U');
$u_modified_time = get_the_modified_time('U');
if ($u_modified_time >= $u_time + 86400) {
$updated_date = get_the_modified_time('F jS, Y');
$updated_time = get_the_modified_time('h:i a');
$custom_content .= '<p class="last-updated-date">Recently updated on '. $updated_date . ' at '. $updated_time .'</p>';
}
$custom_content .= $content;
return $custom_content;
}
add_filter( 'the_content', 'show_last_updated' );

Pour plus de détails, consultez notre article complet sur l’affichage de la date de dernière modification sur WordPress.

Désactiver la barre d’outils WordPress pour certains utilisateurs

Par défaut, WordPress affiche la barre d’outils WordPress pour tous les utilisateurs connectés en utilisant les rôles d’utilisateur intégrés à WordPress. Ce n’est pas nécessairement le cas pour les rôles personnalisés, tels que le rôle d’utilisateur Client pour les boutiques WooCommerce.

Si vous voulez changer cela, vous pouvez utiliser un extrait de code functions.php pour masquer la barre d’outils WordPress pour certains rôles d’utilisateurs.

Cet exemple masquerait la barre d’outils d’administration pour les comptes ayant le rôle d’auteur ou autrice.

add_filter( 'show_admin_bar', function( $show ) {
if ( current_user_can( 'author' ) ) {
return false;
}
return $show;
} );

Retarder l’apparition des articles dans le flux RSS

Par défaut, le contenu apparaît dans votre flux RSS dès que vous le publiez. Cela peut permettre aux pirates de contenu de récupérer votre contenu et de l’indexer dans Google avant même que Google n’indexe votre article original.

Pour éviter que quelqu’un d’autre ne soit crédité de votre contenu, vous pouvez retarder l’apparition des publications dans votre flux RSS.

Bien que cela ne permette pas d’arrêter complètement les racleurs de contenu, cela signifie que vous pouvez donner à Google le temps d’indexer votre contenu en premier.

Voici l’extrait de code – vous pouvez remplacer le chiffre « 30 » dans cet exemple par le nombre de minutes que vous souhaitez :

function kinsta_delay_feed_content($where) {

global $wpdb;

if ( is_feed() ) {
// timestamp in WP-format
$now = gmdate('Y-m-d H:i:s');

// value for wait; + device
$wait = '30'; // integer

// http://dev.mysql.com/doc/refman/5.0/en/date-and-time-functions.html#function_timestampdiff
$device = 'MINUTE'; //MINUTE, HOUR, DAY, WEEK, MONTH, YEAR

// add SQL-sytax to default $where
$where .= " AND TIMESTAMPDIFF($device, $wpdb->posts.post_date_gmt, '$now') > $wait ";
}
return $where;
}

add_filter('posts_where', 'kinsta_delay_feed_content');

Exclure certaines catégories du flux RSS

Outre le fait de retarder l’apparition d’un contenu dans le flux RSS, il se peut que vous souhaitiez exclure des catégories entières d’articles de blog du flux RSS de votre site.

Pour cela, vous pouvez utiliser l’extrait de code functions.php suivant :

function kinsta_exclude_category_rss($query) {
if ($query->is_feed) {
$query->set('cat','-38');
}
return $query;
}
add_filter('pre_get_posts','kinsta_exclude_category_rss');

Veillez à remplacer l’ID de catégorie de l’exemple – « 38 » – par les ID de catégorie réels que vous souhaitez exclure (et n’enlevez pas le signe moins)

Voici comment trouver le numéro d’ID :

  1. Allez dans Articles → Catégories pour voir la liste de toutes les catégories de votre site.
  2. Cliquez sur Modifier sous la catégorie que vous souhaitez exclure.
  3. Regardez l’URL de la page de modification dans la barre d’adresse de votre navigateur. L’ID de la catégorie est le numéro qui suit ?taxonomy=category&tag_ID=X.

Par exemple, si l’URL est https://yoursite.com/wp-admin/term.php?taxonomy=category&tag_ID=38&post_type=post, l’ID de la catégorie est 38.

Limiter les révisions WordPress par type de publication

Pour éviter d’encombrer la base de données de votre site, vous pouvez limiter le nombre de révisions d’articles à enregistrer.

Bien qu’une façon de limiter les révisions des articles WordPress sur l’ensemble du site soit de modifier le fichier wp-config.php de votre site, vous pourriez vouloir stocker différents nombres de révisions pour différents types de publications – par exemple, les articles de blog par rapport aux produits WooCommerce.

Cet extrait de code functions.php vous permet de le faire. Pour l’adapter à vos besoins, remplacez le type de publication – « post » dans cet exemple – par le type de publication que vous souhaitez contrôler et le nombre – « 5 » dans cet exemple – par le nombre de révisions que vous souhaitez stocker.

function kinsta_post_revisions_by_type( $revisions, $post ) {

if( 'post' == $post->post_type ) {
$revisions = 5;
}

return $revisions;

}

add_filter( 'wp_revisions_to_keep', 'kinsta_post_revisions_by_type', 10, 2 );

* Remarque : vous modifiez le « post » qui vient immédiatement après l’instruction « if ». Par exemple, pour cibler les produits, cette ligne ressemblerait à ceci :

if( 'product' == $post->post_type ) {

Désactiver la fonction de recherche de WordPress

Si votre site n’a pas besoin d’une fonction de recherche, vous pouvez désactiver la fonction de recherche de WordPress afin d’éviter tout abus potentiel.

Par exemple, même si vous n’affichez pas de champ de recherche sur votre site, les robots peuvent toujours utiliser la fonction de recherche en ajoutant ?s=[terme de recherche] à votre URL.

Pour cela, vous pouvez ajouter l’extrait de code suivant :

function kinsta_disable_wp_search( $query, $error = true ) {

if ( is_search() ) {
$query->is_search = false;
$query->query_vars[s] = false;
$query->query[s] = false;

// to error
if ( $error == true )
$query->is_404 = true;
}
}

add_action( 'parse_query', 'kinsta_disable_wp_search' );
add_filter( 'get_search_form', create_function( '$a', "return null;" ) );

Si quelqu’un essaie d’utiliser la fonction de recherche directement, votre site renverra une page 404.

Créer vos propres codes courts personnalisés (par exemple, l’année en cours)

Les codes courts de WordPress sont des raccourcis très pratiques qui vous permettent d’intégrer du contenu dynamique dans votre site.

Alors que de nombreuses extensions WordPress s’appuient sur les codes courts pour renforcer leurs fonctionnalités, vous pouvez également créer vos propres codes courts personnalisés en utilisant le fichier WordPress functions.php et la fonction add_shortcode().

Par exemple, un cas d’utilisation courant est la création d’un code court qui affiche l’année en cours. Cela vous permet d’afficher automatiquement l’année en cours dans tout votre contenu sans avoir à tout mettre à jour manuellement chaque 1er janvier.

Pour créer un tel code court, vous pouvez utiliser le code suivant :

function year_shortcode() {
$year = date('Y');
return $year;
}
add_shortcode('currentyear', 'year_shortcode');

Ensuite, lorsque vous ajoutez le shortcode [currentyear] à votre contenu, il sera automatiquement remplacé par l’année actuelle, par exemple 2023.

Autoriser les codes courts dans les titres d’articles

Par défaut, WordPress n’exécute pas les codes courts que vous placez dans le champ du titre de votre article. Si vous souhaitez utiliser des codes courts dans les titres de vos articles, vous pouvez activer cette fonctionnalité en ajoutant un simple extrait de code dans le fichier functions.php de WordPress.

Par exemple, combiné à l’extrait de code précédent, il vous permettrait d’inclure automatiquement l’année en cours dans le titre de l’article en ajoutant le code court [currentyear].

add_filter( 'the_title', 'do_shortcode' );

Masquer les erreurs de connexion pour améliorer la sécurité

Par défaut, WordPress affiche un message explicatif lorsque les tentatives de connexion échouent. Ce message peut révéler certaines informations, comme le fait qu’une certaine adresse e-mail est enregistrée sur votre site (même si le mot de passe est incorrect).

Pour éviter de divulguer des informations potentiellement sensibles, vous pouvez masquer ces erreurs de connexion en ajoutant l’extrait de code suivant à votre fichier functions.php.

function kinsta_hide_login_errors(){
return 'These are not valid credentials';
}
add_filter( 'login_errors', 'kinsta_hide_login_errors' );

Cet extrait de code remplace le texte d’erreur de connexion par défaut par le message suivant – These are not valid credentials.

Vous pouvez personnaliser le texte en fonction de vos préférences, mais évitez d’utiliser des tirets, des barres obliques ou d’autres caractères, car cela pourrait provoquer une erreur (à moins que vous n’échappiez ces caractères),

Modifier la longueur de l’extrait

Par défaut, l’extrait WordPress affiche les 55 premiers mots d’un article.

Si vous souhaitez modifier cette longueur, vous pouvez ajouter l’extrait de code suivant au fichier functions.php.

function kinsta_change_excerpt_length($length) {
return 90;
}
add_filter('excerpt_length', 'kinsta_change_excerpt_length');

L’extrait de code ci-dessus modifiera la longueur de l’extrait à 90 mots. Si vous préférez un autre nombre, vous pouvez remplacer « 90 » par le nombre exact de mots que vous souhaitez utiliser.

Supprimer le numéro de version de WordPress

Pour que les acteurs malveillants aient plus de mal à détecter la version de WordPress que vous utilisez, certains utilisateurs préfèrent supprimer le numéro de version de WordPress dans le code frontend de votre site.

Pour cela, vous pouvez ajouter les extraits de code suivants à votre fichier functions.php.

function kinsta_hide_version() {
return '';
}
add_filter('the_generator', 'kinsta_hide_version');

Configurer la pagination de WordPress

Si vous n’êtes pas satisfait du fonctionnement de la pagination dans votre thème, vous pouvez utiliser un extrait de code functions.php pour ajuster le comportement de la pagination ou même créer votre propre système de pagination.

Si vous êtes intéressé par ce type de modification, nous avons un guide complet sur la pagination WordPress qui inclut quelques exemples d’extraits de code functions.php pour vous.

Modifier le nombre de résultats à inclure sur la page d’affichage de la recherche

WordPress vous donne une option dans le tableau de bord pour contrôler combien d’articles sont listés sur les pages d’archives (Réglages → Lecture).

Cependant, cette option modifie le nombre d’articles pour toutes les pages d’archives. Que faire si vous souhaitez simplement utiliser un nombre différent pour la page de résultats de recherche ?

Pour cela, vous pouvez ajouter cet extrait à votre fichier functions.php – assurez-vous de remplacer le nombre (« 12 » dans cet exemple) par le nombre réel de résultats que vous souhaitez afficher avant de paginer les résultats supplémentaires.

function kinsta_search_results_list() {
if ( is_search() )
set_query_var('posts_per_archive_page', 12);
}

add_filter('pre_get_posts', 'kinsta_search_results_list');

Inclure les images mises en avant dans le flux RSS de WordPress

Si vous souhaitez inclure les images mises en avant de vos articles dans le contenu de votre flux RSS, vous pouvez ajouter l’extrait suivant à votre fichier functions.php.

function kinsta_featured_image_rss($content) {
global $post;
if ( has_post_thumbnail( $post->ID ) ){
$content = '<div>' . get_the_post_thumbnail( $post->ID, 'full', array( 'style' => 'margin-bottom: 15px;' ) ) . '</div>' . $content;
}
return $content;
}

add_filter('the_excerpt_rss', 'kinsta_featured_image_rss');
add_filter('the_content_feed', 'kinsta_featured_image_rss');

Tel qu’il est écrit, l’extrait de code ci-dessus insère l’image en taille réelle. Pour utiliser une taille de miniature différente, vous pouvez remplacer « full » par une taille de vignette différente, par exemple « large » ou « medium ».

Ajouter la prise en charge du téléversement pour les types de fichiers (par exemple SVG)

Par défaut, WordPress vous empêche de téléverser certains types de fichiers, tels que les fichiers SVG.

Pour activer la prise en charge de ces types de fichiers bloqués, vous pouvez ajouter l’extrait de code suivant au fichier functions.php de WordPress :

function kinsta_myme_types($mime_types){
$mime_types['svg'] = 'image/svg+xml';
return $mime_types;
}
add_filter('upload_mimes', 'kinsta_myme_types', 1, 1);

Cet extrait de code ne permet que le téléversement de fichiers SVG, mais vous pouvez le modifier pour ajouter la prise en charge d’autres types de fichiers si nécessaire.

Masquer les alertes de mise à jour de WordPress pour les non-administrateurs

Par défaut, WordPress affiche des messages à tous les utilisateurs ayant accès au tableau de bord lorsqu’une nouvelle mise à jour est disponible.

Même si le rôle d’un utilisateur ne lui permet pas d’appliquer la mise à jour, le message du tableau de bord lui dira de contacter l’administrateur.

Pour remédier à cette situation, vous pouvez utiliser cet extrait de code pour masquer les notifications de mise à jour pour tous les utilisateurs qui ne sont pas administrateurs :

function kinsta_hide_update_nag() {
if ( ! current_user_can( 'update_core' ) ) {
remove_action( 'admin_notices', 'update_nag', 3 );
}
}

add_action('admin_menu','kinsta_hide_update_nag');

Pour d’autres variantes, consultez notre guide sur la façon de désactiver les notifications de mise à jour de WordPress.

Modifier la qualité de l’optimisation automatique des JPEG

Bien que tout le monde ne connaisse pas cette fonctionnalité, WordPress compresse automatiquement les images JPEG lors de la création de miniatures pour votre site après que vous ayez téléversé des images.

Depuis WordPress 4.5, WordPress a fixé le niveau de qualité par défaut à 82 (100 étant une compression nulle).

Si vous souhaitez augmenter ou diminuer ce niveau de qualité, vous pouvez ajouter l’extrait de code suivant à votre fichier functions.php – assurez-vous de remplacer le nombre (« 90 » dans cet exemple) par le niveau de qualité que vous souhaitez utiliser :

add_filter( 'jpeg_quality', create_function( '', 'return 90;' ) );

Meilleures pratiques pour l’organisation de votre fichier functions.php de WordPress

Si vous n’utilisez le fichier functions.php de WordPress que pour ajouter quelques extraits de code, vous n’avez probablement pas besoin de vous préoccuper de l’organisation.

Mais si vous ajoutez beaucoup d’extraits de code à votre site, il peut rapidement devenir lourd et complexe si vous ne suivez pas les meilleures pratiques d’organisation du fichier functions.php.

Voici quelques bonnes pratiques pour organiser vos extraits de code..

Ajoutez des commentaires de code pour tout expliquer

Lorsque vous ajoutez pour la première fois un extrait de code à votre fichier functions.php, vous savez exactement ce qu’il fait et pourquoi vous l’avez ajouté. Mais lorsque vous regardez à nouveau le fichier functions.php un an plus tard, les choses ne sont peut-être pas aussi claires.

Pour éviter cela, vous devez ajouter des commentaires de code à chaque extrait qui expliquent ce que fait l’extrait et pourquoi vous l’avez ajouté.

Les commentaires de code sont du texte qui n’est pas exécuté par WordPress, mais que les utilisateurs humains peuvent lire pour comprendre ce que fait l’extrait de code.

Pour ajouter un commentaire de code d’une seule ligne, vous pouvez utiliser ce format :

// This is a single-line code comment

Pour ajouter un commentaire de code sur plusieurs lignes, vous pouvez utiliser ce format :

/**
* This is a code comment that spans multiple lines
* This text is also in the same comment
* This is the last line in the code comment
*/

Voici un exemple de la manière dont vous pouvez utiliser les commentaires de code – vous pouvez voir que le commentaire précédant chaque extrait explique ce qu’il fait.

Exemple d'utilisation de commentaires de code pour documenter des extraits dans le fichier functions.php.
Exemple d’utilisation de commentaires de code pour documenter des extraits dans le fichier functions.php.

Utilisez les fichiers include pour séparer les extraits dans différents fichiers

Si vous avez vraiment beaucoup d’extraits de code, vous pouvez les stocker dans des fichiers séparés au lieu d’utiliser uniquement le fichier functions.php.

Ensuite, vous pouvez inclure ces extraits de code dans le fichier functions.php en utilisant include ou require. Mike Schinkel présente un bon exemple de la manière dont vous pouvez procéder sur StackExchange.

Envisagez l’une des alternatives à functions.php présentées ci-dessus

Si vous trouvez que votre fichier functions.php est un peu encombré, vous pouvez préférer l’une des alternatives à functions.php que nous avons détaillées plus haut.

Par exemple, l’extension gratuite Code Snippets facilite l’organisation car vous pouvez ajouter chaque extrait de code séparément, avec son propre titre et sa propre description. Vous pouvez également utiliser des étiquettes pour organiser vos extraits.

Résumé

Le fichier WordPress functions.php est un fichier spécifique à un thème qui vous permet d’ajouter des extraits de code PHP à votre site web.

Si vous souhaitez ajouter des extraits de code au fichier functions.php, vous devriez toujours utiliser un thème enfant afin que vos modifications ne soient pas écrasées lorsque vous mettez à jour votre thème. Nous vous recommandons également de sauvegarder votre site avant d’ajouter des extraits de code et de les tester sur un site de staging dans la mesure du possible.

Au lieu d’utiliser le fichier functions.php, vous pouvez également envisager d’utiliser une extension de gestion de code ou de créer votre propre extension personnalisée pour héberger vos extraits de code.

Maintenant que vous savez comment fonctionne le fichier functions.php de WordPress, vous pouvez commencer à personnaliser votre site de toutes sortes de façons utiles.

Les exemples de code pour functions.php ci-dessus vous donnent de bons points de départ, mais il n’y a pas de limite à ce que vous pouvez faire.

Jeremy Holcombe Kinsta

Content & Marketing Editor at Kinsta, WordPress Web Developer, and Content Writer. Outside of all things WordPress, I enjoy the beach, golf, and movies. I also have tall people problems ;).