Hello Dolly ou comment créer un plugin WordPress

Hello Dolly comment cree t on un plugin WordPress
Partager sur

Vous avez des connaissances en PHP et vous utilisez WordPress. Vous vous êtes probablement déjà posé la question « mais comment on crée un plugin WordPress »

Dans la vidéo ci-dessous je vous montre rapidement comment créer un plugin WordPress ! Pour aller un plus loin lisez l’article jusqu’au bout 😉.

À quoi sert le plugin Hello dolly ? Devez-vous le supprimer ?

Si vous avez déjà installé WordPress, vous avez dû voir dans vos extensions ce fameux plugin… Hello Dolly est installé par défaut sur toutes les installations WordPress et ce depuis 2004.

Créer par Matt Mullenweg, cofondateur de WordPress, le plugin Hello Dolly a été conçu pour présenter l’architecture de base d’une extension WordPress.

Comment créer votre premier plugin WordPress ?

Étape 1 : Création du répertoire de votre plugin

Rendez-vous dans /wp-content/plugins/ et créer un nouveau dossier par exemple mon-premier-plugin.

capture nouveau dossier premier plugin

Étape 2 : Création du fichier principale de votre plugin

Allez dans votre nouveau dossier /wp-content/plugins/mon-premier-plugin et ajoutez un fichier nommez par exemple mon-premier-plugin.php.

premier fichier de votre plugin wp

Étape 3 : Éditons notre nouveau fichier

Voici la déclaration minimale pour que votre plugin soit reconnu par WordPress :

				
					<?php
/**
 * Plugin Name: Mon premier plugin
 */
				
			

Rendez-vous dans vos extensions, vous pouvez désormais voir votre extension et même l’activer.

plugin actif minimal

Vous pouvez aller un peu plus loin avec les autres options qui suivent (documentation WordPress sur le sujet) : 

				
					<?php
/**
 * Plugin Name
 *
 * @package           PluginPackage
 * @author            Your Name
 * @copyright         2019 Your Name or Company Name
 * @license           GPL-2.0-or-later
 *
 * @wordpress-plugin
 * Plugin Name:       Plugin Name
 * Plugin URI:        https://example.com/plugin-name
 * Description:       Description of the plugin.
 * Version:           1.0.0
 * Requires at least: 5.2
 * Requires PHP:      7.2
 * Author:            Your Name
 * Author URI:        https://example.com
 * Text Domain:       plugin-slug
 * License:           GPL v2 or later
 * License URI:       http://www.gnu.org/licenses/gpl-2.0.txt
 * Update URI:        https://example.com/my-plugin/
 */
				
			

Voilà ce que cela donne côté wp-admin :

plugin actif toutes options

Étape 4 : Maintenant on peut commencer à ajouter des fonctionnalités

On peut par exemple ajouter une petite fonction pour créer une petite page de maintenance provisoire (à mettre après la déclaration du plugin), on l’ajoute sur le hook wp_head qui est l’un des premiers hooks en front :

				
					<?php
add_action('wp_head', function(){
    // mode maintenance
    ?>
    <h1>Mode maintenance</h1>
    <p>Nous revenons très rapidement !</p>
    <?php
    exit; // on arrête le script
});
				
			

Voilà le rendu en front : 

mode maintenance via plugin

Bon, je vous l’accorde ce n’est pas la fonctionnalité la plus folle de l’histoire de WordPress, mais ici le but est d’illustrer le fonctionnement de base d’un plugin.

Étape 5 : On peut ajouter un petit Readme.txt

Bien que cela soit facultatif il est pertinent si vous envisagez de partager votre plugin sur le répertoire officiel de WordPress, d’ajouter un petit readme.txt à la racine de votre plugin.

readme txt

Voici une petite documentation pour rédiger votre readme.txt.

Étape 6 : Amusez-vous 😊

À partir de là vous venez d’ouvrir la boîte de pandore, vous n’avez plus qu’à explorer le champ des possibles… Un conseil aller y crescendo, ne commencez pas par des projets trop gros dans un premier temps.

Bonus : Un template de plugin

Si vous êtes à l’aise avec la programmation orientée objet sous WordPress, j’ai créé un projet pour générer un plugin vierge à partir d’un script exécutable en Bash.

demo WordPress Plugin Boilderplate webpack composer

Un plugin vierge… Mais avec un panel de fonctionnalités incluses tels qu’une class pour créer des tâches cron ou encore la présence de composer et webpack.

Ce template vous facilitera également la création de pages d’administration.

Je ferais prochainement un article dédié au projet en attendant n’hésiter pas à télécharger le projet sur github ou encore à y contribuer :

Le mot de la fin

Cet article vous a peut-être permis de faire le premier pas dans le monde du développement de plugin. J’ai voulu faire un article très simple pour qu’il profite au plus grand nombre… Prochainement j’essayerais d’approfondir le sujet !

Réservez un coaching WordPress

Vous avez besoin de conseils pour votre projet sous WordPress.

Ces articles pourraient vous intéresser

👇 Me contacter 👇