FR 
EN 
Une Nouvelle Opportunité pour les Développeurs
WPMasterToolKit franchit une nouvelle étape en offrant aux développeurs la possibilité de créer leurs propres addons. Cette ouverture permet d’étendre les fonctionnalités du plugin tout-en-un et de proposer des solutions sur mesure pour les utilisateurs de WordPress.
Cette possibilité a été ajouté dans la version 2.3.0 de WPMasterToolKit.
Un Écosystème en Expansion
Grâce à cette nouvelle approche, les développeurs peuvent désormais concevoir et intégrer leurs propres modules en respectant l’architecture de WPMasterToolKit. Cette initiative vise à enrichir l’expérience utilisateur et à répondre à des besoins spécifiques sans alourdir le noyau du plugin.
Un Exemple d’Addon Disponible sur GitHub
Pour accompagner cette ouverture, nous avons mis à disposition un exemple d’addon sur GitHub : WPMasterToolKit Addon Exemple. Ce module illustre comment développer et intégrer un addon à WPMasterToolKit.
Fonctionnalités de l’Addon Exemple
- Gestion de l’activation et de la désactivation : Le module enregistre son activation et sa désactivation via le fichier de log.
- Ajout d’un sous-menu : Un nouveau sous-menu est automatiquement ajouté dans l’interface d’administration de WordPress.
- Page d’administration dédiée : Une page spécifique permet de visualiser les informations du module.
- Structure optimisée : L’architecture du plugin respecte les meilleures pratiques de développement WordPress.
Installation du Module Exemple
- Téléchargez le fichier ZIP du module depuis le dépôt GitHub.
- Accédez au tableau de bord WordPress et cliquez sur « Extensions ».
- Sélectionnez « Ajouter » puis « Téléverser une extension ».
- Choisissez le fichier ZIP et cliquez sur « Installer maintenant ».
- Activez le module depuis la liste des extensions.
- Une fois activé, un nouveau module apparaîtra dans WPMasterToolKit.
Voici en détail ce que vous trouverez dans cet exemple
Le fichier principal wpmastertoolkit-addon-exemple.php
Ce fichier constitue le cœur du plugin et contient les définitions principales permettant à l’addon de fonctionner avec WPMasterToolKit. Il définit également les constantes essentielles telles que le chemin et l’URL du plugin.
La déclaration du plugin
/**
* @wordpress-plugin
* Plugin Name: WPMasterToolKit Addon Exemple
* Requires Plugins: wpmastertoolkit
* Plugin URI: https://wpmastertoolkit.com/
* Description: WPMasterToolKit Addon Exemple is created to show you how to create an addon for WPMasterToolKit.
* Version: 1.0.0
* Author: Webdeclic
* Author URI: https://webdeclic.com
* License: GPL-2.0+
* License URI: https://www.gnu.org/licenses/gpl-2.0.txt
* Text Domain: wpmastertoolkit-addon-exemple
* Domain Path: /languages
*/Il s’agit d’une déclaration tout à fait classique de plugin. Vous pouvez vous documenter sur la documentation officielle de WordPress.
Chose tout de même importante à noter la ligne la déclaration Requires Plugins: wpmastertoolkit est importante pour éviter d’éventuels bugs en cas de suppression et / ou désactivation du plugin principal.
Déclaration des données de vos modules
Ensuite vient la déclaration de vos modules exemple :
/**
* Add modules data to WPMasterToolKit.
*/
add_filter( 'wpmastertoolkit_modules_data', function($modules){
$modules['Exemple_Of_New_Module'] = array(
'original_name' => "Exemple Of New Module",
'group' => 'other-features',
'path' => WPMASTERTOOLKIT_ADDON_EXEMPLE_PLUGIN_PATH . 'modules/class-exemple-of-new-module.php',
);
return $modules;
});Dans cet exemple voici à quoi correspond les différentes valeurs :
Exemple_Of_New_Module: Correspond au nom de la class dans votre fichier il est très important de ne pas faire d’erreur sinon le module ne fonctionnera pas, c’est grâce à cette clé de tableau que l’instanciation de la class du module est possible.original_name: correspond au nom humainement lisible en anglais de votre module. Attention ne pas mettre de chaine traduisible ici, car ce code est appelé avant l’init de WordPress. Pour plus d’info lire : Internationalization improvements in 6.7.group: l’id du groupe où ranger votre fonctionnalité, voici la liste des groupes existants (liste extensible via le filtrewpmastertoolkit_modules_groups):'administration''content-media''custom-code''disable-features''security''speed-optimizations''woocommerce''other-features'
path: Le chemin vers le fichier de votre class php.
Déclaration des textes descriptifs pour vos modules
Vous devez pour chaque module ajouter, déclarer un titre et une description pour vos modules (traduisibles).
/**
* Add modules labels to WPMasterToolKit.
*/
add_filter( 'wpmastertoolkit_modules_labels', function($modules){
$modules['Exemple_Of_New_Module'] = array(
'name' => esc_html_x( "Exemple Of New Module", "Module name", 'wpmastertoolkit-addon-exemple' ),
'desc' => esc_html_x( "Description of the module", "Module description", 'wpmastertoolkit-addon-exemple' ),
);
return $modules;
});Le dossier modules/
Ce dossier contient les classes dédiées aux modules. Dans cet exemple, on retrouve la classe class-exemple-of-new-module.php, qui illustre comment créer un module conforme aux standards de WPMasterToolKit.
La classe Exemple_Of_New_Module
Cette classe définit les fonctionnalités de l’addon :
- Gestion de l’activation et de la désactivation avec des logs pour un suivi détaillé.
- Initialisation des hooks WordPress.
- Ajout du sous-menu dans l’administration.
- Affichage d’une page dédiée pour le module.
- etc.
Conclusion
Avec l’ouverture à la création d’addons, WPMasterToolKit se transforme en une plateforme encore plus flexible et évolutive. Cette nouvelle approche donne aux développeurs une liberté totale pour créer des solutions adaptées aux besoins des utilisateurs WordPress.
Rejoignez la communauté et commencez dès aujourd’hui à développer votre propre addon pour WPMasterToolKit !
