Comment dé­ve­lop­per son propre plugin WordPress ?

WordPress est un système de gestion de contenu populaire, se ca­rac­té­ri­sant entre autres par sa mo­du­la­rité. Divers plugins peuvent ainsi être installés afin d’en étendre les fonc­tion­na­li­tés. Pour l’adapter encore plus à vos besoins, vous pouvez même dé­ve­lop­per votre propre plugin WordPress.

Les avantages d’un plugin WordPress per­son­na­lisé

Étant donné qu’il existe déjà de nom­breuses ex­ten­sions qui sont pour la plupart gratuites et dis­po­nibles dans le ré­per­toire de plugins du site Web officiel de WordPress, il n’y a pas de grande nécessité à créer son propre plugin. Cependant, lors de la recherche d’une extension adaptée à votre projet, vous cons­ta­te­rez ra­pi­de­ment que de nombreux plugins (voir notre sélection des meilleurs plugins WordPress) semblent répondre à vos besoins, mais :

• ne sont plus maintenus ;
• ne fonc­tion­nent plus cor­rec­te­ment ;
• ou ne proposent pas toutes les fonc­tion­na­li­tés attendues.

Il peut donc être in­té­res­sant pour vous de dé­ve­lop­per votre propre plugin WordPress, ou au moins d’en modifier un déjà existant, afin de le pa­ra­mé­trer en fonction de vos envies. Un plugin sur mesure est également une ex­cel­lente al­ter­na­tive à l’élar­gis­se­ment des fonc­tion­na­li­tés et des thèmes sur WordPress. Pour cela, les uti­li­sa­teurs du CMS ont souvent recours au fichier functions.php du thème utilisé.

Dé­ve­lop­per un plugin WordPress : les prérequis

Avant de commencer à dé­ve­lop­per votre plugin, vous devez vous assurer que vous êtes en pos­ses­sion des outils ap­pro­priés et des bases né­ces­saires. Pour cela, vous devez disposer d’un en­vi­ron­ne­ment de dé­ve­lop­pe­ment local avec une ins­tal­la­tion de WordPress. Un moyen simple de le faire est l’outil gratuit Local WP, qui vous permet d’installer et de tester WordPress sur votre or­di­na­teur. Vous pouvez également utiliser XAMPP ou MAMP pour mettre en place un en­vi­ron­ne­ment WordPress local.

En plus d’une ins­tal­la­tion WordPress fonc­tion­nelle, un éditeur PHP ou un IDE PHP comme Visual Studio Code ou PhpStorm est un avantage. Posséder des con­nais­sances de base en PHP, HTML, CSS et Ja­vaS­cript est également utile pour mieux com­prendre le fonc­tion­ne­ment des plugins WordPress.

Dé­ve­lop­per un plugin WordPress étape par étape

Étape 1 : créer le ré­per­toire du plugin et le fichier principal

Chaque plugin WordPress est stocké dans son propre ré­per­toire dans le dossier wp-content/plugins/ de l’ins­tal­la­tion de WordPress. Pour créer votre plugin, ouvrez ce dossier dans votre ex­plo­ra­teur de fichiers et créez un nouveau dossier à cet endroit. Donnez à ce dossier un nom sig­ni­fi­ca­tif, par exemple mon-propre-plugin.

Dans ce dossier, créez un nouveau fichier appelé mon-propre-plugin.php. Ce fichier est le fichier principal du plugin et doit contenir un en-tête spécial pour que WordPress re­con­naisse le plugin. Ouvrez le fichier dans votre éditeur de code et insérez le code suivant :

<?php
/*
Plugin Name: My own plugin
Plugin URI: https://localhost/
Description: Demo plugin.
Version: 1.0
Author: IONOS
License: GPL2
*/

Ces lignes de com­men­taires con­tien­nent des méta-in­for­ma­tions im­por­tantes sur le plugin. Le nom du plugin est affiché dans la zone d’ad­mi­nis­tra­tion de WordPress et la des­crip­tion peut aider à com­prendre les fonc­tion­na­li­tés ou le domaine d’ap­pli­ca­tion du plugin. WordPress lui-même étant soumis à la Licence publique générale GNU (GPL), vous devriez choisir une licence qui soit com­pa­tible avec celle-ci.

Après avoir en­re­gis­tré le fichier, vous pouvez accéder à l’option « Plugins » dans le backend de WordPress. Votre plugin devrait main­te­nant ap­pa­raître dans la liste. Pour l’activer, il vous suffit de cliquer sur « Activer ». L’ac­ti­va­tion du plugin n’a pas encore d’effet, compte tenu du fait qu’il ne contient encore aucune fonc­tion­na­lité. Cependant, les fon­da­tions sont désormais créées !

Close

Étape 2 : ajouter une première fonc­tion­na­lité

Pour s’assurer du fonc­tion­ne­ment du plugin que nous venons de créer, com­men­çons par ajouter une fonction simple qui affiche un texte spé­ci­fique via un shortcode WordPress. Un shortcode est une courte chaîne de ca­rac­tères qui peut être insérée dans des articles ou des pages WordPress pour y afficher un contenu dynamique.

Ajoutez le code suivant dans votre fichier principal :

function my_plugin_shortcode() {
return "<h2>Hello World!</h2>";
}
add_shortcode(‘my_shortcode’, ‘my_plugin_shortcode’);

Cette fonction crée un nouveau shortcode nommé [my_shortcode]. Désormais, lorsque ce shortcode est inséré dans un article ou une page, WordPress affichera au­to­ma­ti­que­ment le code HTML défini, soit dans le cas présent « Hello World! ».

En­re­gis­trez le fichier, allez dans l’éditeur de WordPress et collez le shortcode [my_shortcode] dans une nouvelle page.

Close

Une fois la page en­re­gis­trée et affichée, le texte HTML défini devrait être visible sur votre site Web :

Close

Notez que ce shortcode a pour unique objectif de servir d’exemple pour vous montrer comment dé­ve­lop­per votre plugin.

Étape 3 : ajouter un menu dans la zone d’ad­mi­nis­tra­tion de WordPress (fonc­tion­na­lité avancée)

Un plugin per­son­na­lisé peut également disposer d’un menu propre dans la zone d’ad­mi­nis­tra­tion de WordPress. Cela est par­ti­cu­liè­re­ment utile si votre plugin a besoin de sa propre interface uti­li­sa­teur, par exemple pour les pa­ra­mètres ou les sta­tis­tiques.

Pour créer un menu pour le plugin, insérez le code suivant dans votre fichier principal :

function my_plugin_menu() {
add_menu_page(
‘Mon Plugin’,	// Titre de la page
‘Mon Plugin’, 	// Nom affiché dans le menu
‘manage_options’,	// Droits d’utilisation
‘mon-plugin’,	// Slug de la page
‘my_plugin_site’,	// Fonction de rendu de la page
‘dashicons-admin-generic’,	// Symbole
20	// Position dans le menu
);
}
add_action(‘admin_menu’, ‘my_plugin_menu’);
function my_plugin_site() {
echo "<h1>Bienvenue dans mon plugin</h1>";
echo "<p>Vous pouvez ajouter vos paramètres ici.</p>";
}

Après avoir en­re­gis­tré et rechargé votre backend WordPress, vous devriez voir ap­pa­raître un nouvel élément de menu nommé « Mon plugin » dans la barre latérale gauche. Si vous cliquez dessus, une page s’ouvre avec un titre et un texte de rem­pla­ce­ment.

Close

Étape 4 : intégrer des styles et des scripts

En général, un plugin WordPress a besoin de scripts sup­plé­men­taires. Les plugins les plus complets né­ces­si­tent souvent des fonc­tion­na­li­tés avancées qui sont intégrées avec du Ja­vaS­cript, ou avec un style CSS dédié.

Vous pouvez inclure vos propres fichiers CSS ou Ja­vaS­cript en utilisant la fonction wp_enqueue_scripts. Créez un dossier nommé assets dans le ré­per­toire de votre plugin et un autre dossier css à l’intérieur. Dans ce dossier, créez un fichier appelé style.css et ajoutez la règle CSS suivante qui, pour illustrer, colore l’arrière-plan de votre page WordPress en bleu clair :

body {
background-color: #87b9ff;
}

Avec ce code, vous avez créé votre propre feuille de style, même si elle est très ru­di­men­taire. Vous devez main­te­nant l’intégrer dans votre plugin. Pour cela, insérez ce code dans votre fichier mon-propre-plugin.php :

function my_plugin_scripts() {
wp_enqueue_style(‘my-plugin-css’, plugin_dir_url(__FILE__) . ‘assets/css/style.css’);
}
add_action(‘wp_enqueue_scripts’, ‘my_plugin_scripts’);

Close

Étape 5 : en­re­gis­trer les pa­ra­mètres du plugin dans la base de données

Dans de nombreux cas, et notamment pour les plugins les plus complexes, il est né­ces­saire d’en­re­gis­trer les pa­ra­mètres per­son­na­li­sés. WordPress propose pour cela la fonction register_setting. Avec le code suivant, vous pouvez pro­gram­mer une simple page de réglages pour votre plugin WordPress :

function my_plugin_settings() {
add_options_page(
‘Les paramètres de mon plugin’,
‘Mon plugin’,
‘manage_options’,
‘mon-plugin-parametres’,
my_plugin_settings_site()
);
}
add_action(‘admin_menu’, ‘my_plugin_settings’);
function my_plugin_settings_site() {
?>
<div class="wrap">
<h1>Paramètres de mon plugin</h1>
<form method="post" action="options.php">
<?php
settings_fields(‘my_plugin_options’);
do_settings_sections(‘my-plugin-settings’);
submit_button();
?>
</form>
</div>
<?php
}

Après avoir en­re­gis­tré, une nouvelle entrée pour votre plugin apparaît sous « Pa­ra­mètres » dans la zone d’ad­mi­nis­tra­tion.

Close

Dé­ve­lop­per un plugin WordPress en résumé

Grâce à ce tutoriel, vous con­nais­sez désormais les étapes es­sen­tielles pour dé­ve­lop­per votre plugin WordPress. Avec ces bases, vous pouvez intégrer des fonc­tion­na­li­tés plus complexes dans votre plugin, comme des appels API qui com­mu­ni­quent avec des services externes ou la création de types de posts per­son­na­li­sés pour gérer le contenu de manière plus spé­ci­fique et flexible.