Comment créer un mu-plugin WordPress

Créer un « mu-plugin » (must-use plugin) pour WordPress permet de garantir que les fonctionnalités essentielles restent toujours actives sur votre site. Ce plugin est activé automatiquement et ne peut pas être désactivé depuis le tableau de bord WordPress, ce qui en fait une solution idéale pour les fonctions ou personnalisations critiques.

Un autre cas d’usage d’un mu-plugin consiste à ajouter des fonctions supplémentaires à un plugin ou au cœur de WordPress. Par exemple, WP Staging propose de nombreux filtres et hooks qui peuvent enrichir la fonctionnalité de staging ou de sauvegarde de WP Staging. Tous ces filtres documentés peuvent être ajoutés à un mu-plugin personnalisé.

Introduction aux must-use plugins

Les mu-plugins, ou « must-use » plugins, constituent un type particulier de plugin WordPress. Ils sont stockés dans un répertoire distinct (wp-content/mu-plugins) et chargés automatiquement par WordPress. Ces plugins sont parfaits pour du code qui doit toujours s’exécuter, comme des fonctions personnalisées pour un site, et ils sont à l’abri d’une désactivation accidentelle.

Avantages des Mu-Plugins

  1. Activation automatique : les mu-plugins sont activés automatiquement et ne peuvent pas être désactivés par inadvertance.
  2. Sécurité renforcée : comme ils ne peuvent pas être désactivés depuis l’interface d’administration, ils offrent une manière plus sûre d’implémenter des fonctionnalités critiques.
  3. Gestion simplifiée : parfaits pour gérer plusieurs sites WordPress, car ils facilitent la maintenance des plugins essentiels.

Créer un Mu-Plugin

1. Accédez aux fichiers de votre site

  • Accédez aux fichiers de votre site via FTP ou via le gestionnaire de fichiers de votre hébergeur.

2. Localisez le répertoire Mu-Plugin

  • Rendez-vous dans le répertoire wp-content.
  • Vérifiez la présence du dossier mu-plugins. S’il n’existe pas, créez-le.

3. Créez le fichier de votre Mu-Plugin

  • Créez un nouveau fichier PHP pour votre mu-plugin. Par exemple, my-mu-plugin.php.
  • Utilisez un éditeur de texte simple pour écrire votre code PHP.

4. Ajoutez du code à votre Mu-Plugin

  • Votre mu-plugin doit commencer par la balise PHP d’ouverture <?php.
  • Voici la structure de base d’un fichier mu-plugin :
PHP
<?php
/*
Plugin Name: My Custom Mu-Plugin
Description: A custom must-use plugin to enhance my WordPress site.
Version: 1.0
Author: Mickey Mouse
*/

// Your custom code goes here

Étape 5 : envoyez votre Mu-Plugin

  • Téléversez le fichier .php dans le répertoire mu-plugins de votre serveur.

Étape 6 : vérifiez l’activation

  • Les mu-plugins étant activés automatiquement, vérifiez sur votre site que votre code personnalisé fonctionne correctement.

Exemple de Mu-Plugin : texte de pied de page d’administration personnalisé

À titre d’exemple, créons un mu-plugin simple qui modifie le texte du pied de page dans l’interface d’administration WordPress.

PHP
<?php
/*
Plugin Name: Custom Admin Footer
Description: Changes the footer text in the WordPress admin area.
Version: 1.0
Author: Your Name
*/

add_filter('admin_footer_text', function () {
    echo 'Customized by Tony Stark - Powered by WordPress';
});

Conclusion

Créer un mu-plugin est une opération simple qui peut considérablement améliorer la fonctionnalité et la sécurité de votre site WordPress. En suivant les étapes ci-dessus, vous pourrez mettre en place des personnalisations toujours actives et offrir une expérience cohérente et fiable à votre site.

Pensez à tester soigneusement vos mu-plugins dans un environnement de staging avant de les déployer sur un site en production, afin de vous assurer qu’ils fonctionnent comme prévu.

Articles connexes

Rene Hermenau

Auteur : Rene Hermenau

À propos de l'auteur : René Hermenau est le fondateur de WP STAGING. Il travaille sur les sauvegardes WordPress, les environnements de staging, les migrations, la gestion des bases de données et les workflows de déploiement sécurisés.