Guide d’introduction au développement de plugins WordPress : créer votre premier module fonctionnel de A à Z.

Pourquoi a-t-il été nécessaire de développer un plug-in WordPress personnalisé ?

Lorsque les fonctionnalités intégrées de WordPress et les plugins existants ne répondent pas entièrement aux besoins spécifiques d’une entreprise, le développement de plugins personnalisés devient la solution la plus directe. Les plugins personnalisés vous permettent d’ajouter toutes les fonctionnalités que vous souhaitez au système central sans avoir à modifier les fichiers principaux de WordPress. Cela garantit non seulement que vos fonctionnalités ne seront pas perdues après une mise à jour de WordPress, mais également que les fonctionnalités seront modulaires, ce qui facilite leur migration et leur gestion entre différents sites. Comparé à la modification d’un thème, le développement de plugins personnalisés offre de nombreux avantages.functions.phpLes fichiers et les plug-ins sont un meilleur choix pour la réutilisation des fonctionnalités. Ils permettent de séparer votre code du thème, ce qui améliore la flexibilité et la maintenabilité du projet.

L'environnement de développement et la préparation des connaissances préalables au développement.

Avant de commencer à écrire du code, vous devez mettre en place un environnement de développement approprié et acquérir les connaissances de base nécessaires.

Mise en place d'un environnement de développement local.

Un environnement de développement local stable et isolé est essentiel. Il est recommandé d’utiliser des outils tels que Local by Flywheel, XAMPP ou MAMP pour configurer rapidement un environnement intégré comprenant PHP, MySQL et Apache/Nginx. Assurez-vous que votre version de PHP est supérieure à 7.4 et celle de MySQL à 5.6, et installez la dernière version de WordPress.wp-config.phpEn Chine, il est recommandé de...WP_DEBUGLa constante est définie àtrueAfin d'afficher des messages d'erreur pendant le processus de développement.

Lectures recommandées Guichet unique pour le développement de plugins WordPress : de zéro à la création de votre premier plugin fonctionnel.。

Les connaissances nécessaires en PHP et en API WordPress.

Le développement de plugins nécessite des connaissances de base en PHP, y compris l’utilisation de variables, de fonctions, de classes et d’espaces de noms, ainsi que la manière de manipuler les bases de données en toute sécurité. Plus important encore, il est nécessaire de maîtriser les nombreuses API fournies par WordPress, telles que les hooks d’actions et de filtres. Les hooks d’actions vous permettent d’exécuter du code personnalisé à des moments spécifiques, tandis que les hooks de filtres vous permettent de modifier les données. La mise en œuvre des fonctionnalités des plugins dépend largement d’une utilisation judicieuse de ces hooks.

Hébergement WordPress par UltraHost

Garantie de remboursement dans les 30 jours, bande passante illimitée et base de données, protection gratuite contre les attaques DDoS. Avantage de 501 TP4T pour les achats sur 3 ans.

page d'accès

Créer la structure de base du premier plug-in.

Ensuite, nous allons comprendre la structure de base des plugins en créant un plugin simple intitulé “ Hello World ”.

La structure de base du fichier du plug-in principal.

Chaque plug-in doit avoir un fichier principal qui contient les métadonnées du plug-in. Veuillez le placer dans le répertoire d’installation de WordPress.wp-content/pluginsDans le dossier, créez un nouveau dossier, par exemple en le nommant «  ».my-first-pluginDans ce dossier, créez le fichier PHP principal, que vous pouvez nommer comme vous le souhaitez.my-first-plugin.phpEn haut de ce fichier, vous devez ajouter une annotation d'en-tête d'informations sur le plug-in standard.

<?php
/**
 * Plugin Name:       我的第一个插件
 * Plugin URI:        https://yourwebsite.com/my-first-plugin
 * Description:       这是一个学习用的示例插件，用于在管理后台显示欢迎信息。
 * Version:           1.0.0
 * Author:            你的名字
 * License:           GPL v2 or later
 * Text Domain:       my-first-plugin
 */

Cette section de commentaires est nécessaire. WordPress l'utilise pour identifier et afficher votre plugin dans la liste des plugins en arrière-plan.

Créer une page de menu d'administration d'arrière-plan.

Pour que la fonctionnalité soit visible dans l'interface d'administration de WordPress, nous devons ajouter une page de menu d'administration. Dans le fichier principal du plug-in, continuez à ajouter du code. Nous allons utiliser :add_action()La fonction est montée suradmin_menuC'est sur ce crochet d'action.

Lectures recommandées De débutant à expert : guide complet et meilleures pratiques pour le développement de plugins WordPress.。

/\n  // Ajouter un menu d'administration
function mfp_add_admin_menu() {
    add_menu_page(
        'Paramètres de mon plugin', // Titre de la page
        'Mon plugin',     // Titre du menu
        'manage_options', // Autorisations (administrateur)
        'my-first-plugin', // Slug du menu
        'mfp_admin_page_content', // Fonction de rendu du contenu de la page
        'dashicons-smiley', // Icône (utilise Dashicon)
        6 // Position du menu
    );
}
add_action('admin_menu', 'mfp_add_admin_menu');

// Définir le contenu de la page d'administration
function mfp_admin_page_content() {
    ?>
    <div class="wrap">
        <h1>Bienvenue à mon premier plug-in !</h1>
        <p>Il s'agit d'un simple exemple de plug-in WordPress.</p>
    </div>
    &lt;?php
}

Ce code ajoute un menu principal intitulé “ Mes plugins ” dans la barre de navigation située à gauche de l'interface d'administration de WordPress. En cliquant dessus, une page d'accueil s'affiche. Veillez à ce que le nom de la fonction soit précédé de votre propre préfixe (par exemple <).mfp_）, afin d'éviter tout conflit avec les noms de fonctions d'autres plugins ou thèmes.

Écrire la première fonction simple.

Maintenant, ajoutons une fonctionnalité simple côté site. Par exemple, ajouter automatiquement un paragraphe de texte personnalisé à la fin de chaque article. Nous allons utiliser ici une fonction JavaScript.the_contentLes crochets de filtre.

/ Ajouter du texte personnalisé après le contenu de l'article
function mfp_append_text_to_content($content) {
    if (is_single()) { // Cela ne fonctionne que sur la page d'un article unique
       $custom_text = ' '<p><em>— Cet article a été amélioré par mon premier plug-in.</em></p>'fonction mfp_append_text_to_content() : Cette fonction ajoute du texte personnalisé au contenu de la page. Elle prend en entrée le contenu de la page et retourne le contenu modifié.  

add_filter('the_content', 'mfp_append_text_to_content');  

```

```python
def mfp_append_text_to_content(content):  
    if content is not None:  
        custom_text = mfp_get_custom_text()  
        if custom_text is not None:  
            content +=custom_text  
    return content  
```;

Cette fonctionnalité illustre l’utilisation de base des filtres : recevoir le contenu original et le retourner après l’avoir modifié. C’est un modèle très puissant et couramment utilisé.

hosting.com Hébergement partagé

Hautes performances avec les CPU AMD EPYC, stockage SSD NVMe et LiteSpeed, support interne expert 24h/24 et 7j/7, mesures de sécurité avancées, notamment SSL, protection contre la force brute, les logiciels malveillants et le DDoS, économies pouvant aller jusqu'à 73%.

page d'accès

Pratiques et normes avancées pour le développement de plugins.

Après la mise en œuvre des fonctionnalités de base, suivre les meilleures pratiques permettra à votre plug-in d’être plus robuste et plus sécurisé.

Le traitement lors de l'activation et de la désactivation des plug-ins.

Lorsqu'un utilisateur active ou supprime un plugin, vous devrez peut-être créer des tables de données, définir des options par défaut ou nettoyer les données générées par le plugin. WordPress fournit des hooks spéciaux pour gérer ces situations.

Les crochets d'activation et de désactivation de l'enregistrement doivent se trouver dans le fichier principal du plug-in, via
register_activation_hooketregister_uninstall_hookMise en œuvre de la fonction. Remarque : le hook de désinstallation doit être une méthode statique ou une fonction indépendante.

Lectures recommandées Guide complet du développement de plugins WordPress : créez votre propre plugin de A à Z.。

// 插件激活时执行的操作
function mfp_plugin_activation() {
    // 例如：在选项表中添加一个默认设置
    add_option('mfp_default_greeting', '你好，欢迎光临！');
}
register_activation_hook(__FILE__, 'mfp_plugin_activation');

// 插件卸载时执行的操作
function mfp_plugin_uninstall() {
    // 删除插件创建的选项
    delete_option('mfp_default_greeting');
    // 注意：谨慎操作，此处可删除自定义数据库表
}
register_uninstall_hook(__FILE__, 'mfp_plugin_uninstall');

\nDes considérations de sécurité, de localisation et de performance.

La sécurité est une priorité absolue dans le développement de plugins. Toutes les entrées des utilisateurs (telles que les soumissions de formulaires et les paramètres d'URL) doivent être validées et désinfectées. WordPress fournit de nombreuses fonctions, telles que :sanitize_text_field(), esc_html(), wp_kses(), prepare()(Pour les requêtes de base de données) pour vous aider. Ne faites jamais confiance directement aux entrées des utilisateurs ou ne les affichez jamais directement sur une page ou dans une base de données.

Si votre plug-in s'adresse à des utilisateurs internationaux, il doit prendre en charge la localisation (i18n). Pour cela, utilisez :__()et_e()La fonction attend que tous les chaînes de texte à traduire soient enfermées dans des parenthèses.

Hébergement partagé InterServer

Hébergement mutualisé $2.50 USD par mois, premier mois $0.1 USD code promo tryinterserver, 461 scripts cloud apps, installation en un clic.

page d'accès

En termes de performances, évitez les requêtes inutiles de la base de données ou les opérations gourmandes en ressources. Utilisez judicieusement le cache (comme l'API Transient) et combinez les scripts et les feuilles de style.wp_enqueue_script()etwp_enqueue_style()S'insérer correctement dans la file d'attente et ne se charger que sur les pages où ils sont nécessaires.

Emballer et distribuer les plugins.

Après le développement, vous pouvez compresser le dossier du plug-in en un fichier ZIP. Les utilisateurs peuvent l’installer directement dans l’interface d’administration de WordPress, en allant sur la page “ Plugins → Installer un plugin → Télécharger un plugin ”.

Si vous souhaitez soumettre votre plugin au répertoire officiel de WordPress, vous devez strictement respecter les directives de soumission, y compris les normes de codage (il est recommandé d’utiliser les normes de codage WordPress), une documentation complète, une déclaration de compatibilité, et vous assurer qu’il ne contient aucun code contraire à la licence GPL. Aujourd'hui, en 2026, les critères d'évaluation du répertoire de plugins seront mis à jour en fonction de l'évolution de la plateforme. Par conséquent, il est essentiel de lire attentivement les exigences les plus récentes avant de soumettre votre plugin.

résumés

Le développement de plugins WordPress est un processus qui consiste à transformer des idées personnalisées en fonctionnalités puissantes. Nous avons commencé par comprendre les motivations du développement, mis en place un environnement local et pratiqué progressivement la création de la structure de fichiers du plugin, l'ajout de menus d'administration, la mise en œuvre de fonctionnalités de base et la gestion d'événements du cycle de vie tels que l'activation et la désinstallation. Plus important encore, nous avons exploré des normes de développement essentielles telles que la sécurité, la localisation et les performances, qui constituent les fondements de la qualité et de la fiabilité des plugins. La première étape du développement consiste à passer à la pratique. En partant de l'exemple “ Hello World ” de cet article, en explorant sans cesse la vaste API et le système de hooks de WordPress, vous pourrez progressivement créer des plugins complexes et pratiques, qui étendront considérablement les capacités de WordPress.

FAQ Foire aux questions

Pour développer un plugin WordPress, faut-il maîtriser le PHP ?

Oui, développer des plugins WordPress nécessite une solide base en PHP. En effet, WordPress est lui-même construit en PHP, et la logique centrale des plugins est également écrite en PHP. Vous devez comprendre les fonctions, les classes, les espaces de noms et les concepts de base de la programmation orientée objet en PHP. De plus, connaître les bases du HTML, du CSS et du JavaScript est également très utile pour créer des fonctionnalités interactives côté front-end.

Quelle est la différence fondamentale entre les fonctions des fichiers functions.php des plugins et celles des thèmes ?

La principale différence entre les deux réside dans l'utilisation du code et sa portabilité. Le thème de...functions.phpIl est utilisé pour ajouter du code étroitement lié à l'apparence et aux fonctionnalités du thème actuel. Lorsque vous changez de thème, ces fonctionnalités deviennent inutilisables. Les plugins, quant à eux, sont des modules fonctionnels dont le code est indépendant du thème. Leur objectif est de fournir un ensemble de fonctionnalités spécifiques pouvant fonctionner sous n'importe quel thème. Par conséquent, les fonctionnalités génériques (telles que les formulaires de contact et l'optimisation du référencement) devraient être développées sous forme de plugins, tandis que les fonctionnalités étroitement liées à la mise en page et au style du thème seraient mieux placées dans le thème lui-même.functions.phpAu milieu.

Comment gérer les problèmes de compatibilité entre les différentes versions de WordPress ?

La clé pour résoudre les problèmes de compatibilité est d'utiliser les API avec prudence et de procéder à des tests conditionnels. Pendant le développement, vous devriez consulter le manuel officiel de WordPress pour connaître la version dans laquelle les fonctions, classes ou hooks que vous utilisez ont été introduits. Dans les cas où vous devez prendre en charge les anciennes versions, vous pouvez utiliser ...function_exists()Ouclass_exists()Vérifiez si une fonctionnalité est disponible, et si ce n’est pas le cas, proposez une solution de repli élégante ou affichez un message d’avertissement convivial. En outre, indiquez clairement dans les commentaires d’en-tête du plug-in la gamme de versions de WordPress pour lesquelles les tests ont été réussis.

Comment créer un panneau de contrôle personnalisable pour un plug-in ?

La méthode standard pour créer un panneau de contrôle pour un plugin est d'utiliser l'API Paramètres de WordPress. Ce processus comprend : utiliserregister_setting()Enregistrez un groupe de paramètres et des champs, en utilisant :add_settings_section()etadd_settings_field()Pour définir les sections et les champs spécifiques de la zone de configuration, et enfin, les utiliser dans la fonction de rappel de la page de menu.settings_fields()etdo_settings_sections()Pour rendre le formulaire. L'API Paramètres gère automatiquement la validation non-CE des soumissions de formulaire, les vérifications d'autorisations et la sauvegarde des paramètres. C'est la meilleure pratique pour développer des pages de paramètres.

Quelle est la bonne manière de se connecter à une base de données lors du développement d'un plug-in ?

Ne jamais utiliser directement les fonctions MySQL de PHP. WordPress fournit déjà ces fonctions.wpdbLes classes globales permettent d'interagir en toute sécurité avec la base de données. Vous pouvez le faire via des variables globales.$wpdbPour y accéder. Pour les requêtes, en particulier celles impliquant la saisie d'informations par l'utilisateur, il est indispensable d'utiliser$wpdb->prepare()Des méthodes pour prévenir les attaques par injection SQL. Pour créer des tables de données personnalisées, vous devez exécuter la requête SQL de création de table dans le hook d'activation du plug-in, et utiliser$wpdb->get_charset_collate()Pour s'assurer que le jeu de caractères est conforme aux paramètres de WordPress.