Préparatifs et configuration de l’environnement
Avant de commencer à écrire du code, il est essentiel de mettre en place un environnement de développement local professionnel. Cela non seulement améliore l’efficacité du développement, mais permet également d’éviter les risques potentiels liés aux tests sur des serveurs en ligne. Il est recommandé d’utiliser des logiciels de serveur local intégrant Apache/Nginx, MySQL et PHP, tels que Local by Flywheel, XAMPP ou MAMP. Assurez-vous que la version de PHP que vous utilisez est compatible avec l’environnement WordPress cible ; il est généralement conseillé d’utiliser PHP 7.4 ou une version ultérieure.
Vous aurez besoin d’un éditeur de code, tel que Visual Studio Code, PhpStorm ou Sublime Text. Ces outils offrent généralement une mise en évidence du code, des suggestions automatiques et une intégration avec des systèmes de gestion de versions, ce qui améliore considérablement l’expérience de développement. De plus, il est essentiel de maîtriser le « Guide de développement de plugins » officiel de WordPress ainsi que les documents sur les normes de codage, et de respecter ces dernières (par exemple, l’utilisation de préfixes pour éviter les conflits de noms de fonctions) afin de créer des plugins de haute qualité.
Comprendre la structure de base des plugins
Un plugin WordPress très basique peut être composé d’un seul fichier principal. Le nom de ce fichier principal est très important ; il est généralement choisi en fonction de la fonctionnalité du plugin. Par exemple… my-custom-plugin.phpLe début du fichier doit contenir une annotation de type « header de plugin » qui respecte un format spécifique. C’est cette annotation qui permet à WordPress de reconnaître le plugin.
Lectures recommandées Maîtriser le développement de plugins pour WordPress : Construire votre premier plugin personnalisé de zéro à un。
Les commentaires situés en tête du plugin fournissent des informations de base sur celui-ci, telles que le nom, la description, la version, l’auteur, etc. Voici un exemple de tête de plugin standard :
<?php
/**
* Plugin Name: 我的自定义功能扩展
* Plugin URI: https://example.com/my-custom-plugin
* Description: 这是一个用于演示的 WordPress 自定义插件。
* Version: 1.0.0
* Author: 你的名字
* Author URI: https://example.com
* License: GPL v2 or later
* Text Domain: my-custom-plugin
* Domain Path: /languages
*/Développement central : Crochets d’actions et de filtres
Le cœur du développement de plugins pour WordPress réside dans la compréhension et l’utilisation de son système de “ hooks ”. Il existe deux types de hooks : les actions (Actions) et les filtres (Filters). Les actions vous permettent d’exécuter du code personnalisé à des moments précis du cycle de vie de WordPress (comme l’initialisation, le chargement des pages ou la publication d’articles). Les filtres, quant à eux, vous permettent de modifier les données générées par WordPress ou par d’autres plugins pendant leur exécution.
Utiliser des crochets d’action pour ajouter des fonctionnalités
Les crochets d'action sont déclenchés par add_action() Montage de fonctions. Par exemple, si vous souhaitez ajouter une notification personnalisée en haut de l’interface d administration d’un site web, vous pouvez utiliser cette méthode. admin_notices Ce « hook d’action » nécessite la création d’une fonction pour afficher le contenu de la notification, puis l’installation de cette fonction sur le hook en question.
Dans cet exemple, nous avons créé une fonction. my_custom_admin_notice Affichez un message d'alerte simple, et faites-le en utilisant… add_action L’associer à… admin_notices Crochet.
function my_custom_admin_notice() {
echo '<div class="notice notice-success is-dismissible"><p>Mon plugin personnalisé a été activé avec succès !</p></div>';
}
add_action( 'admin_notices', 'my_custom_admin_notice' );Utiliser les hooks des filtres pour modifier le contenu.
Les crochets de filtre sont déclenchés par add_filter() Montage de fonctions : il s’agit d’une technique utilisée pour modifier les données qui lui sont transmises. Un exemple courant est l’ajout automatique d’une déclaration de droits d’auteur à la fin du contenu d’un article.
Lectures recommandées Maîtriser le développement de plugins WordPress : construire votre premier module d'extension de A à Z.。
Dans cet exemple, nous avons créé une fonction. append_copyright_to_contentIl reçoit le contenu de l’article en tant que paramètre, ajoute une information sur les droits d’auteur à la fin, puis retourne le contenu modifié. Nous utilisons… add_filter L’associer à… the_content Filtre.
function append_copyright_to_content( $content ) {
if ( is_single() ) { // 仅在单篇文章页面生效
$copyright = '<p><em>© 2026 Tous droits réservés. Cet article a été généré par « Mon plugin ».</em></p>';
$content .= $copyright;
}
return $content;
}
add_filter( 'the_content', 'append_copyright_to_content' );Créer des pages de gestion et des options de configuration.
De nombreux plugins nécessitent de fournir une interface de configuration aux utilisateurs, ce qui se réalise généralement en ajoutant une page de paramétrage distincte dans l’administration de WordPress. WordPress propose une API richement évoluée pour simplifier ce processus. add_menu_page() et add_options_page()。
Ajouter un menu de gestion de niveau supérieur.
utiliser add_menu_page() La fonction peut créer un élément de menu principal pour votre plugin. Vous devez définir des paramètres tels que le titre de la page, le titre du menu, les autorisations des utilisateurs, l’alias du menu, ainsi que la fonction de rappel (callback) utilisée pour rendre le contenu de la page.
Le code suivant montre comment créer une page de menu de niveau supérieur intitulée “ Mes paramètres de plugin ”. Fonction de rappel (callback function). render_my_plugin_settings_page Responsable de l'affichage du contenu HTML de cette page.
function my_plugin_add_menu_page() {
add_menu_page(
'我的插件设置', // 页面标题
'我的插件', // 菜单标题
'manage_options', // 所需用户权限
'my-plugin-settings', // 菜单别名 (slug)
'render_my_plugin_settings_page', // 回调函数
'dashicons-admin-generic', // 图标（可选）
30 // 菜单位置（可选）
);
}
add_action( 'admin_menu', 'my_plugin_add_menu_page' );
function render_my_plugin_settings_page() {
?>
<div class="wrap">
<h1>Les paramètres de mon plugin</h1>
<form method="post" action="/fr/options.php/" data-trp-original-action="options.php">
<?php
settings_fields( 'my_plugin_settings_group' );
do_settings_sections( 'my-plugin-settings' );
submit_button();
?>
<input type="hidden" name="trp-form-language" value="fr"/></form>
</div>
<?php
}Champs de configuration pour l’enregistrement et la validation
Pour conserver de manière sécurisée les données saisies par les utilisateurs, il est nécessaire d’utiliser l’API de configuration de WordPress. Cela inclut l’utilisation des fonctionnalités prévues par cette API. register_setting()、add_settings_section() et add_settings_field() Des fonctions telles que… L’activation de l’API gère automatiquement la validation des données, la vérification des demandes non sécurisées (nonce) ainsi que le stockage dans la base de données.
Le code suivant montre comment enregistrer un groupe de paramètres, une zone de paramètres et un champ de texte. Fonction sanitize_my_setting Utilisé pour nettoyer et valider les données saisies par l'utilisateur avant qu’elles ne soient enregistrées dans la base de données.
Lectures recommandées Apprendre le développement de plugins pour WordPress à partir de zéro : Créer votre première fonction personnalisée。
function my_plugin_settings_init() {
// 注册一个设置
register_setting( 'my_plugin_settings_group', 'my_plugin_option_name', 'sanitize_my_setting' );
// 添加一个设置区域
add_settings_section(
'my_plugin_main_section',
'主要设置',
null, // 可选的区域描述回调函数
'my-plugin-settings'
);
// 在区域内添加一个字段
add_settings_field(
'my_plugin_text_field',
'示例文本字段',
'my_plugin_text_field_callback',
'my-plugin-settings',
'my_plugin_main_section'
);
}
add_action( 'admin_init', 'my_plugin_settings_init' );
function sanitize_my_setting( $input ) {
// 清理输入，例如移除 HTML 标签
return sanitize_text_field( $input );
}
function my_plugin_text_field_callback() {
$value = get_option( 'my_plugin_option_name', '默认值' );
echo '<input type="text" name="my_plugin_option_name" value="' . esc_attr( $value ) . '" class="regular-text" />';
}Internationalisation et bonnes pratiques de sécurité pour les plugins
Un plugin mature doit prendre en charge plusieurs langues et respecter les normes de sécurité les plus élevées. L’internationalisation (i18n) permet de faciliter la traduction du plugin pour les utilisateurs du monde entier. Les bonnes pratiques de sécurité protègent votre plugin ainsi que les sites web des utilisateurs contre les attaques les plus courantes.
Mettre en œuvre la fonction de traduction de texte.
WordPress utilise le framework GNU gettext pour l’internationalisation. Vous devez envelopper toutes les chaînes de caractères affichées aux utilisateurs dans les plugins à l’aide de fonctions spécifiques. La fonction la plus couramment utilisée est… __()(Utilisé pour retourner la chaîne de caractères traduite) et _e()(Il s’agit de directives utilisées pour afficher directement le texte traduit. Vous devez également les configurer correctement dans la partie d’en-tête du plugin.) Text Domain et Domain PathEt utilisez… load_plugin_textdomain() La fonction charge le fichier de traduction au bon moment.
Le code suivant montre comment charger le champ de texte d’un plugin et afficher une chaîne de caractères pouvant être traduite.
function my_plugin_load_textdomain() {
load_plugin_textdomain( 'my-custom-plugin', false, dirname( plugin_basename( __FILE__ ) ) . '/languages/' );
}
add_action( 'init', 'my_plugin_load_textdomain' );
// 在需要的地方使用翻译函数
$greeting = __( '你好，世界！', 'my-custom-plugin' );
_e( '这是一个直接输出的消息。', 'my-custom-plugin' );Respecter les principes fondamentaux de sécurité
La sécurité des plugins est de la plus haute importance lors du développement. Il est essentiel de valider et de nettoyer toutes les données saisies par les utilisateurs. La validation consiste à vérifier si les données respectent le format attendu (par exemple, s’il s’agit bien d’une adresse e-mail). Pour cela, on peut utiliser des outils spécifiques… filter_var() Des fonctions telles que… La nettoyage (sanitization) consiste à supprimer les caractères dangereux des données. WordPress propose de nombreuses fonctions à cet effet. sanitize_text_field()、esc_html()、esc_url() etc.
Lorsque vous affichez des données dans un navigateur, il est nécessaire de les échapper (escapement) pour éviter les attaques de type Cross-Site Scripting (XSS). Pour ce faire, vous pouvez utiliser des fonctions appropriées. esc_html()、esc_attr()、wp_kses_post()Lors de l’exécution d’opérations sur une base de données, il est obligatoire d’utiliser… $wpdb Utilisez des classes et des instructions de prétraitement pour éviter les injections SQL. Ne joignez jamais directement les données saisies par l’utilisateur aux requêtes SQL.
résumés
Le développement de plugins pour WordPress consiste à transformer des idées en extensions fonctionnelles, et l’essentiel réside dans une compréhension approfondie du système des « hooks » (anciennement appelés « fonctions d’interception »). En commençant par mettre en place un environnement local et en écrivant les commentaires de début de fichier standard des plugins, les développeurs doivent maîtriser l’utilisation des hooks d’actions et de filtres pour intervenir dans le cycle de vie de WordPress ainsi que dans le flux de données. La création de pages d’administration et de paramètres permet de fournir une interface d’interaction avec les utilisateurs. L’internationalisation ainsi que des pratiques de sécurité rigoureuses (validation des données, nettoyage des données, échappement des caractères dangereux, opérations sur la base de données sécurisées) constituent les fondements permettant à un plugin d’être professionnel, fiable et utilisable de manière sûre à l’échelle mondiale. Respecter les normes de codage de WordPress, commencer par des fonctionnalités simples et construire progressivement des logiques plus complexes est la voie la plus efficace pour maîtriser l’art du développement de plugins.
FAQ Foire aux questions
Combien de fichiers est nécessaire au minimum pour un plugin ?
Un plugin WordPress complet peut ne contenir qu’un seul fichier PHP. Tant que ce fichier inclut les commentaires de tête appropriés (Plugin Header), il sera reconnu par WordPress comme un plugin indépendant. Bien sûr, à mesure que les fonctionnalités s’avèrent plus complexes, vous pourrez diviser le code en plusieurs fichiers et y intégrer des ressources telles que du CSS, du JavaScript et des images.
Comment éviter que les noms des fonctions des plugins ne entrent en conflit avec ceux d’autres plugins ?
WordPress recommande officiellement l’utilisation d’un préfixe unique pour nommer toutes vos fonctions, classes, variables et constantes. Ce préfixe doit être lié au nom de votre plugin ou à celui de votre entreprise, et suffisamment distinctif. Par exemple, si votre plugin s’appelle “Awesome Slider”, vous pouvez utiliser un préfixe tel que “AWESOME_Slider_” pour vos éléments de code. aslider_init()、ASLIDER_VERSION Une telle approche de nommage. Une autre méthode, plus moderne et plus élégante, consiste à utiliser les espaces de noms (Namespaces) en PHP, ce qui permet de résoudre définitivement les problèmes de conflits de noms.
Que doit-on faire lorsque l’extension est activée ?
L’activation d’un plugin est un moment idéal pour exécuter des tâches de configuration ponctuelles. Vous pouvez y parvenir en enregistrant un « hook » d’activation. Créez une fonction dans laquelle vous vérifiez la compatibilité de l’environnement (par exemple, la version de PHP), créez ou mettez à jour les tables de base de données nécessaires, et initialisez les valeurs par défaut des options du plugin, etc. register_activation_hook( FILE, ‘your_setup_function’ ) Veuillez lier cette fonction.
Comment puis-je permettre aux utilisateurs de désinstaller mon plugin en toute sécurité ?
Afin de fournir une expérience utilisateur complète, votre plugin devrait être capable de nettoyer les données qu’il a créées. Cela peut être réalisé en enregistrant un « hook » de désinstallation. WordPress propose deux méthodes de désinstallation : register_uninstall_hook( FILE, ‘your_cleanup_function’ ) La fonction enregistrée sera exécutée lorsque l'utilisateur clique sur le bouton “ Supprimer ” le plugin. À l’intérieur de cette fonction, vous pourrez supprimer de manière sûre toutes les options de base de données créées par le plugin, ainsi que les tables de base de données personnalisées, etc. Veuillez noter qu’il est absolument interdit d’utiliser ces données directement. register_deactivation_hook Il s’agit de procéder à la suppression définitive des données, car la désactivation ne signifie pas l’installation complète du logiciel.
Quelle est la suite, quelle est la suite ?
Lecture approfondie et connaissances pratiques
Les articles suivants sont liés au sujet de cet article et peuvent faire l'objet d'une lecture plus approfondie. Il est souvent préférable de commencer par l'article qui se rapproche le plus de votre problème actuel, puis d'étendre progressivement la lecture aux sujets environnants.
- Guide de développement de plugins pour WordPress : Créez votre premier plugin personnalisé de zéro à un
- Devenir développeur de plugins pour WordPress : Un guide complet de A à Z
- Guide complet pour le développement de thèmes WordPress : Un tutoriel pratique pour passer du débutant à l'expert
- Guide complet pour le développement de thèmes WordPress : Construire des templates de sites web professionnels à partir de zéro
- Guide complet pour le développement de plugins WordPress : De l’initiation à la maîtrise pour créer des extensions professionnelles
Français