Entamer le voyage du développement de plugins pour WordPress signifie que vous maîtrisez les outils nécessaires pour créer des extensions qui pourront être utilisées par des utilisateurs du monde entier.

Entamer le développement de plugins pour WordPress signifie que vous disposez de la capacité d’ajouter de nouvelles fonctionnalités, d’automatiser des processus et de créer de la valeur unique pour des millions de sites web à travers le monde. Que ce soit pour répondre à des besoins commerciaux spécifiques ou pour partager vos créations avec la communauté, il est essentiel de comprendre son architecture et ses principes fondamentaux pour réussir. Un plugin est essentiellement un ensemble de codes PHP qui respecte les conventions et l’API de WordPress, et s’intègre sans effort au système principal de la plateforme. Il permet de modifier ou d’améliorer le fonctionnement de celle-ci grâce à des mécanismes tels que les hooks et les filters.

Installer un environnement de développement et créer des plugins de base

Avant de commencer à écrire la première ligne de code, il est essentiel de disposer d’un environnement de développement isolé et professionnel. Il est recommandé d’utiliser des outils de développement locaux tels que Local by Flywheel, DevKinsta ou MAMP, qui permettent de configurer rapidement un environnement intégrant PHP, MySQL et WordPress.

Créer le premier fichier de plug-in.

Tout a commencé par un fichier PHP. Dans le cas de WordPress… wp-content/plugins Dans le répertoire, créez un nouveau dossier pour votre nouveau plugin. Par exemple, créons un dossier nommé… my-first-plugin Créez un dossier. Ensuite, dans ce dossier, créez le fichier principal, qui porte généralement le même nom que le dossier.my-first-plugin.php。

Lectures recommandées De zéro à un : guide complet et tutoriel pratique pour le développement de plugins WordPress.。

Les commentaires en tête de ce fichier principal constituent l“” identité » du plugin, et fournissent à WordPress toutes les métadonnées nécessaires pour reconnaître ce dernier. Voici la structure de base :

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

<?php
/**
 * Plugin Name:       我的第一个插件
 * Plugin URI:        https://example.com/my-first-plugin
 * Description:       这是一个用于学习 WordPress 插件开发的示例插件。
 * Version:           1.0.0
 * Author:            Your Name
 * Author URI:        https://example.com
 * License:           GPL v2 or later
 * Text Domain:       my-first-plugin
 * Domain Path:       /languages
 */

Après avoir enregistré le fichier, connectez-vous à votre administration WordPress et accédez à la page des “ Plugins ”. Vous devriez y voir un nouveau plugin intitulé “ Mon premier plugin ”. Bien qu’il n’ait aucune fonctionnalité pour l’instant, vous pouvez l’activer ou le désactiver. Cela marque la réussite de la création de votre cadre de plugin.

Comprendre les concepts clés : les crochets d'action (action hooks) et les filtres (filters).

Le cœur du développement de plugins pour WordPress est le mécanisme des “ hooks ” (ou crochets). Ces hooks permettent à votre code d’être intégré aux processus fondamentaux de WordPress à des moments précis, afin d’exécuter vos propres instructions logiques.

Action Hook

Les « Action Hooks » permettent d’exécuter du code lorsque des événements spécifiques se produisent, tels que la publication d’un article, le connexion d’un utilisateur ou le chargement d’un modèle. Vous les utilisez pour mettre en œuvre des actions automatiques ou personnalisées en fonction de ces événements. add_action() La fonction lie votre fonction de rappel (callback) à ce « crochet » (hook).

Par exemple, nous voulons afficher un message personnalisé en haut de la page d'édition des articles dans l'administration. Nous pouvons utiliser… edit_form_top Ce déclencheur d'action.

Lectures recommandées Comment choisir et développer des plugins WordPress de haute qualité : Guide de l’initiation à l’expertise。

// 在文章编辑页面顶部添加自定义提示
add_action( 'edit_form_top', 'myplugin_edit_form_top_message' );
function myplugin_edit_form_top_message( $post ) {
    if ( 'post' === $post->post_type ) {
        echo '<div class="notice notice-info"><p>C’est un message personnalisé provenant de ‘ Mon premier plugin » !</p></div>';
    }
}

Filtre Hook

Les « filtres hook » (Filter Hooks) sont utilisés pour modifier les données. Ils vous permettent de modifier leurs valeurs avant que celles-ci ne soient utilisées (par exemple, enregistrées dans une base de données ou affichées dans un navigateur). add_filter() Une fonction.

Un exemple classique est la modification des derniers mots du contenu d’un article. Nous pouvons utiliser… the_content Filtre.

// 在文章内容末尾附加版权信息
add_filter( 'the_content', 'myplugin_add_copyright_to_content' );
function myplugin_add_copyright_to_content( $content ) {
    if ( is_single() ) {
        $content .= '<p><small>© 2026 Tous droits réservés. Ce texte a été optimisé grâce à mon plugin.</small></p>';
    }
    return $content;
}

Créer une page de gestion des plugins ainsi que leurs options.

Afin que les utilisateurs puissent configurer votre plugin, vous devez créer une page de paramétrage pour eux. WordPress offre une API très complète qui vous permet d’ajouter des pages dans le menu de gestion et de gérer les options associées.

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

Ajouter un menu de gestion

utiliser add_menu_page() Ou add_options_page() Les fonctions permettent d’ajouter un menu de niveau supérieur ou un menu enfant à votre plugin. Généralement, les plugins simples sont intégrés au menu “Paramètres” sous la forme d’une page secondaire.

Tout d’abord, nous devons lier une fonction lors de l’initialisation de l’administrateur afin de régister le menu.

// 在管理后台添加设置菜单
add_action( 'admin_menu', 'myplugin_add_admin_menu' );
function myplugin_add_admin_menu() {
    add_options_page(
        '我的插件设置',          // 页面标题
        '我的插件',             // 菜单标题
        'manage_options',      // 所需权限
        'myplugin-settings',   // 菜单别名 (slug)
        'myplugin_render_settings_page' // 用于输出页面内容的回调函数
    );
}

Page de paramètres de rendu et options de sauvegarde

Ensuite, nous devons définir… myplugin_render_settings_page Une fonction est utilisée pour générer le formulaire HTML de la page et pour gérer l’enregistrement des données saisies dans ce formulaire. Nous allons utiliser l’API des paramètres (Settings API) de WordPress afin de régister, de vérifier et de sauvegarder les options de manière sécurisée.

Lectures recommandées Comment choisir et développer des plugins WordPress de haute qualité : Guide de l’initiation à l’expertise。

// 渲染设置页面
function myplugin_render_settings_page() {
    ?>
    <div class="wrap">
        <h1>Les paramètres de mon plugin</h1>
        <form action="/fr/options.php/" method="post" data-trp-original-action="options.php">
            <?php
            // 输出必要的安全字段和隐藏字段
            settings_fields( 'myplugin_settings_group' );
            // 输出设置章节和字段
            do_settings_sections( 'myplugin-settings' );
            // 输出提交按钮
            submit_button();
            ?>
        <input type="hidden" name="trp-form-language" value="fr"/></form>
    </div>
    <?php
}

// 初始化设置
add_action( 'admin_init', 'myplugin_settings_init' );
function myplugin_settings_init() {
    // 注册一个设置组和字段
    register_setting(
        'myplugin_settings_group', // 设置组名
        'myplugin_option_message'  // 选项名，将保存在 wp_options 表中
    );

    // 添加一个设置章节
    add_settings_section(
        'myplugin_section_basic',
        '基础设置',
        null, // 章节描述回调函数，可以为空
        'myplugin-settings' // 页面别名
    );

    // 向章节添加一个字段
    add_settings_field(
        'myplugin_field_message',
        '自定义消息',
        'myplugin_field_message_render', // 渲染字段 HTML 的函数
        'myplugin-settings',
        'myplugin_section_basic'
    );
}

// 渲染 ‘自定义消息’ 字段
function myplugin_field_message_render() {
    $option = get_option( 'myplugin_option_message' );
    ?>
    <input type='text' name='myplugin_option_message' value='<?php echo esc_attr( $option ); ?>'>
    <p class="description">Les messages saisis ici seront affichés à l’écran principal.</p>
    &lt;?php
}

Maintenant, vous pouvez consulter une page de paramètres dans “ Paramètres ” -> “ Mes plugins ”, qui contient une boîte de texte permettant d’entrer un message, et vous pouvez enregistrer ce message. Pour utiliser cette fonctionnalité, vous pouvez le faire depuis l’interface utilisateur. get_option( 'myplugin_option_message' ) Obtenir sa valeur.

Implementer des codes courts personnalisés

Les codes courts (shortcodes) permettent aux utilisateurs d’utiliser des balises simples entre des crochets pour effectuer des actions ou accéder à des contenus spécifiques. [my_shortcode]Intégrer du contenu dynamique dans des articles, des pages ou des outils est une manière conviviale pour les utilisateurs d’accéder à des fonctionnalités avancées fournies par des plugins.

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

S’inscrire pour obtenir un code court

utiliser add_shortcode() Une fonction est disponible pour enregistrer votre code court. Elle accepte deux paramètres : l’étiquette du code court et la fonction de traitement associée.

Par exemple, nous créons des codes courts. [display_greeting]Il peut afficher différents salutations en fonction de l’heure, et accepte éventuellement un paramètre supplémentaire. name Paramètres.

// 注册自定义短代码
add_shortcode( 'display_greeting', 'myplugin_render_greeting_shortcode' );
function myplugin_render_greeting_shortcode( $atts ) {
    // 设置默认属性值
    $attributes = shortcode_atts(
        array(
            'name' => '访客',
        ),
        $atts,
        'display_greeting'
    );

    // 获取当前小时
    $hour = date( 'H' );
    $greeting = '';

    if ( $hour < 12 ) {
        $greeting = '早上好';
    } elseif ( $hour < 18 ) {
        $greeting = '下午好';
    } else {
        $greeting = '晚上好';
    }

    // 构建输出
    $output = sprintf(
        &#039;<div class="myplugin-greeting"><p><strong>%s, %s !</strong> Bienvenue sur notre site.</p></div>',
        esc_html( $greeting ),
        esc_html( $attributes['name'] )
    );

    return $output;
}

Les utilisateurs peuvent maintenant saisir des données dans l’éditeur. [display_greeting name="张三"]Lors de la rendu de la page, cela sera remplacé par un salut personnalisé.

résumés

Le développement de plugins pour WordPress est un processus puissant et flexible, dont l’essence réside dans la compréhension et l’utilisation du système de crochets (hooks) ainsi que de l’API de base du framework. En commençant par la création d’un fichier PHP contenant une tête standard, vous pouvez étendre les fonctionnalités à l’aide des crochets d’actions (actions) et de filtres (filters), créer des interfaces de configuration conviviales grâce à l’API des paramètres (settings API), et fournir des codes courts (shortcodes) pratiques. Vous aurez ainsi construit un plugin doté d’une structure de base et de modules fonctionnels couramment utilisés. En combinant ces modules de base, en les améliorant, et en suivant les normes de codage et les meilleures pratiques de sécurité de WordPress, vous serez en mesure de créer des plugins performants répondant à diverses exigences.

FAQ Foire aux questions

Quelles connaissances de base sont nécessaires pour développer des plugins pour WordPress ?

Vous devez posséder des connaissances de base en programmation PHP, car les plugins sont principalement écrits en PHP. De plus, une compréhension de base d’HTML, CSS et JavaScript vous aidera à créer des interfaces utilisateur et des fonctionnalités interactives. Le plus important est de maîtriser les concepts fondamentaux de WordPress, tels que les hooks, le The Loop et la structure hiérarchique des templates.

Comment déboguer un plugin WordPress en cours de développement ?

Il est conseillé d’activer le mode de débogage de WordPress dans votre environnement de développement local. wp-config.php Dans le document, il sera indiqué que... WP_DEBUG La constante est définie à trueVous pouvez également installer des plugins de surveillance des requêtes (tels que Query Monitor) pour suivre les requêtes effectuées sur la base de données, l’exécution des fonctions de déclenchement (hooks) ainsi que le chargement des scripts. Cela est très utile pour l’optimisation des performances et les vérifications logiques.

Comment mon plugin peut-il prendre en charge l’internationalisation ?

WordPress utilise le framework GNU gettext pour l’internationalisation. Définissez cela en haut du fichier principal de votre plugin. Text Domain et Domain PathDans le code, utiliser… __()、_e() Les fonctions telles que `translate` enveloppent toutes les chaînes de caractères qui doivent être traduites. Ensuite, des outils comme Poedit sont utilisés pour générer la traduction finale. .pot Des fichiers de modèle, destinés aux traducteurs pour leur permettre de créer des traductions. .po et .mo Les documents.

Comment soumettre mon plugin de manière sûre au répertoire officiel de plugins de WordPress ?

Tout d’abord, vous devez créer un compte sur WordPress.org et soumettre votre plugin. Votre code doit respecter les normes de codage de WordPress et ne doit pas contenir de code chiffré ou obscurci. Le répertoire du plugin, le fichier principal, les captures d’écran ainsi que le fichier README doivent suivre une structure spécifique. L’équipe d’audit vérifiera la qualité du code, sa sécurité et les conditions de licence (le plugin doit être compatible avec la licence GPL).