Guide complet du développement de plugins WordPress : de l’initiation à la création de fonctionnalités personnalisées en passant par la pratique.

Aperçu du développement de plugins pour WordPress

Un plugin WordPress est un ensemble de scripts PHP conçus pour étendre et améliorer les fonctionnalités de base de WordPress. Il permet aux développeurs d’ajouter de nouvelles fonctionnalités, des outils, des panneaux de gestion, ou de modifier le comportement existant du système sans avoir à modifier le code source de WordPress lui-même. Un plugin peut être très simple (ne comprenant qu’un seul fichier) ou très complexe (comportant plusieurs dossiers et différents types de fichiers).

Pour comprendre le noyau d’un plugin, il est essentiel de se concentrer sur son fichier d’entrée. Chaque plugin doit contenir au moins un fichier PHP principal, et ce fichier doit inclure en tête des métadonnées standard relatives au plugin. Ces informations sont lues par le gestionnaire de plugins de WordPress et affichées dans la liste des plugins en arrière-plan.

Créez votre premier plugin.

Créer la structure de base des fichiers

Tout d’abord, vous devez créer le fichier d’entrée pour votre plugin. Cela se fait dans le répertoire d’installation de WordPress.wp-content/plugins/Dans le dossier, créez un nouveau dossier, par exemple…my-first-pluginDans ce dossier, créez un fichier PHP principal dont le nom correspond généralement au nom du dossier, par exemple…my-first-plugin.php。

Lectures recommandées Partir de zéro : créer votre premier plugin WordPress.。

Écrire les informations d'en-tête du plug-in.

Dans ce fichier principal, vous devez ajouter une annotation de type « header » pour le plugin, conforme aux normes de WordPress. C’est essentiel pour que le plugin soit reconnu et activé par WordPress.

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:       这是一个用于演示的简单插件，它将在文章内容顶部添加一行文字。
 * Version:           1.0.0
 * Author:            你的名字
 * License:           GPL v2 or later
 * Text Domain:       my-first-plugin
 */

Cette note fournit des informations de base sur l’extension. Après avoir enregistré ce fichier, vous pourrez la trouver sur la page des “ Extensions ” dans l’administration de WordPress.

Réaliser une fonction simple

Ensuite, nous allons ajouter la fonction la plus simple à ce plugin : afficher une ligne de texte personnalisée en haut de tout le contenu des articles. Nous pouvons utiliser…the_contentCela est réalisé à l’aide d’un « hook de filtre » (Filter Hook).

function myplugin_add_text_to_content( $content ) {
    $custom_text = '<p>Cette salutation a été ajoutée par mon premier plugin.</p>';
    return $custom_text . $content;
}
add_filter( 'the_content', 'myplugin_add_text_to_content' );

Ajoutez ce code à votre fichier de plugin principal.my-first-plugin.phpDans ce fichier, sauvez et activez le plugin. Désormais, lorsque vous consultez n’importe quel post ou page sur le site, le texte spécifié apparaîtra en tête du contenu. C’est la réalisation de la fonction de base du plugin.

Concepts fondamentaux du développement d’extensions et API

Comprendre le mécanisme du crochet

Les hooks sont au cœur du développement des plugins pour WordPress ; ils permettent à votre code de s’insérer dans le flux d’exécution du noyau de WordPress ou d’autres plugins. Il existe principalement deux types de hooks : les actions (Actions) et les filtres (Filters).

Lectures recommandées Comment apprendre à développer des plugins WordPress à partir de zéro : guide complet et tutoriel pratique.。

Ces actions sont conçues pour exécuter votre code personnalisé à un moment précis. Par exemple,wp_footerCette fonction vous permet d'afficher du HTML ou des scripts en bas de la page. Vous pouvez l'utiliser comme vous le souhaitez.add_action()Une fonction est utilisée pour mettre en œuvre une action (ou une action spécifique).

Les filtres sont utilisés pour modifier les données avant qu’elles ne soient transmises à une base de données ou à un navigateur. Par exemple, ceux utilisés dans l’exemple ci-dessus…the_contentLes filtres vous permettent de modifier le contenu des articles. Vous devez les utiliser pour effectuer les modifications nécessaires.add_filter()La fonction permet d’ajouter des filtres, et votre fonction de rappel (callback) doit retourner la valeur modifiée.

Utiliser les classes de base de données

WordPress propose une classe d’abstraction de base de données très puissante.wpdbIl s’agit d’un objet global utilisé pour interagir de manière sécurisée avec la base de données. Vous devez l’utiliser directement, plutôt que d’appeler les fonctions MySQL de PHP.

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

Par exemple, si vous souhaitez consulter certaines informations dans une base de données, vous pouvez procéder de la manière suivante :

global $wpdb;
$results = $wpdb->get_results( "SELECT id, name FROM {$wpdb->prefix}my_custom_table" );

Faites attention à l’utilisation.$wpdb->prefixVeuillez vous assurer de la correctitude des prefixes des tables. Pour les opérations d’insertion, de mise à jour ou de suppression, veillez à utiliser les bons formats.wpdbLes informations fournies sont les suivantes :insert()、update()Ces méthodes gèrent automatiquement l’échappement des données, empêchant ainsi les attaques de type injection SQL.

Créer une page de paramètres d'administration.

Créer une page de configuration en arrière-plan pour un plugin est une exigence de base pour tout plugin professionnel. WordPress propose de nombreuses fonctions API permettant d'ajouter des éléments de menu et des pages à différents niveaux de hiérarchie ; les plus couramment utilisées sont…add_menu_page() et add_options_page()。

Lectures recommandées Guide pratique pour WooCommerce : Construire un site e-commerce professionnel de zéro à un。

Voici un exemple de la manière de mettre en place un menu principal et une page de paramétrage simple :

function myplugin_add_admin_menu() {
    add_menu_page(
        '我的插件设置',        // 页面标题
        '我的插件',            // 菜单标题
        'manage_options',      // 所需权限
        'myplugin-settings',   // 菜单Slug
        'myplugin_settings_page', // 回调函数，用于输出页面HTML
        'dashicons-admin-generic', // 图标
        6                      // 菜单位置
    );
}
add_action( 'admin_menu', 'myplugin_add_admin_menu' );

function myplugin_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( 'myplugin_settings_group' );
                do_settings_sections( 'myplugin-settings' );
                submit_button();
            ?>
        <input type="hidden" name="trp-form-language" value="fr"/></form>
    </div>
    &lt;?php
}

Cet exemple créera un menu principal nommé “ Mon plugin ”. En cliquant dessus, on accédera au contenu correspondant à ce plugin.myplugin_settings_pagePage rendue par une fonction. Généralement, cela se fait en utilisant conjointement l’API Settings de WordPress.register_setting, add_settings_section, add_settings_fieldCela permet de gérer et de sauvegarder les paramètres de configuration de manière sûre.

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

Projet pratique : Développer un plugin de gestion de notes

Dans cette section, nous allons mettre en œuvre de manière intégrée les connaissances acquises précédemment pour créer une fonctionnalité de “ notes ” simple qui pourra être utilisée sur la page d'édition des articles. Ce plugin permet aux éditeurs d'ajouter des remarques internes privées à leurs articles.

Créer une table de base de données personnalisée.

Tout d’abord, lorsque le plugin est activé, nous devons créer une nouvelle table dans la base de données pour stocker les notes. Cela peut être réalisé en enregistrant un crochet d’activation (activation hook).register_activation_hookPour le réaliser.

function my_note_plugin_activate() {
    global $wpdb;
    $table_name = $wpdb->prefix . 'post_notes';
    $charset_collate = $wpdb->get_charset_collate();

$sql = "CREATE TABLE $table_name (
        id mediumint(9) NOT NULL AUTO_INCREMENT,
        post_id bigint(20) NOT NULL,
        note_content text NOT NULL,
        created_by bigint(20) NOT NULL,
        created_at datetime DEFAULT CURRENT_TIMESTAMP NOT NULL,
        PRIMARY KEY  (id)
    ) $charset_collate;";

require_once( ABSPATH . 'wp-admin/includes/upgrade.php' );
    dbDelta( $sql );
}
register_activation_hook( __FILE__, 'my_note_plugin_activate' );

Ici, nous utilisons…dbDelta()Une fonction est utilisée pour créer ou mettre à jour la structure d’une table. C’est une méthode sûre et compatible avec de nombreux systèmes.

Ajouter une boîte métadonnées à l'interface d'édition de l'article.

Ensuite, nous devons ajouter une boîte métatag sur la page d'édition de l'article pour afficher et enregistrer les notes. Cela nécessitera l'utilisation de…add_meta_boxFonction, et l’installer pour qu’elle soit utilisable…add_meta_boxesSur le plan des actions.

function my_note_add_meta_box() {
    add_meta_box(
        'my_note_meta_box',         // 元框的唯一ID
        '文章内部便签',             // 显示的标题
        'my_note_meta_box_callback', // 渲染元框内容的回调函数
        'post',                     // 要显示的帖子类型
        'side',                     // 位置
        'default'                   // 优先级
    );
}
add_action( 'add_meta_boxes', 'my_note_add_meta_box' );

function my_note_meta_box_callback( $post ) {
    // 从数据库获取当前文章的已有便签
    global $wpdb;
    $table_name = $wpdb->prefix . 'post_notes';
    $notes = $wpdb->get_results( $wpdb->prepare( "SELECT * FROM $table_name WHERE post_id = %d ORDER BY created_at DESC", $post->ID ) );

wp_nonce_field( 'my_note_save_action', 'my_note_nonce_field' );
    echo '<textarea name="my_new_note" rows="5" style="width:100%;" placeholder="Entrez vos remarques internes…."></textarea>'echo '<p class="description">Cette remarque n’est visible que par les éditeurs et les administrateurs du site.</p>';

if ( $notes ) {
        echo '<hr><h4>Historiques des notes :</h4>';
        foreach ( $notes as $note ) {
            $user = get_user_by( 'id', $note-&gt;created_by );
            $username = $user ? $user-&gt;display_name : '未知用户';
            echo '<p><strong>' . esc_html( $username ) . ' (' . $note-&gt;created_at . '):</strong><br>';
            echo nl2br( esc_html( $note-&gt;note_content ) ) . '</p>';
        }
    }
}

Enregistrer et nettoyer les données

Lorsque l'article est sauvegardé ou mis à jour, nous devons enregistrer les nouvelles notes dans la base de données. Cela peut être réalisé en…save_postCes actions doivent être mises en œuvre. De plus, lorsque le plugin est supprimé (optionnel), il est également nécessaire de fournir un mécanisme de désinstallation (un “uninstall hook”).register_uninstall_hookVenez nettoyer les tables de données créées.

function my_note_save_post_data( $post_id ) {
    // 检查非ce、权限、自动保存等
    if ( ! isset( $_POST['my_note_nonce_field'] ) || ! wp_verify_nonce( $_POST['my_note_nonce_field'], 'my_note_save_action' ) ) {
        return;
    }
    if ( defined( 'DOING_AUTOSAVE' ) && DOING_AUTOSAVE ) {
        return;
    }
    if ( ! current_user_can( 'edit_post', $post_id ) ) {
        return;
    }

if ( ! empty( $_POST['my_new_note'] ) ) {
        global $wpdb;
        $table_name = $wpdb->prefix . 'post_notes';

$wpdb->insert(
            $table_name,
            array(
                'post_id' => $post_id,
                'note_content' => sanitize_textarea_field( $_POST['my_new_note'] ),
                'created_by' => get_current_user_id(),
            ),
            array( '%d', '%s', '%d' )
        );
    }
}
add_action( 'save_post', 'my_note_save_post_data' );

// 可选：卸载插件时删除数据表
function my_note_plugin_uninstall() {
    global $wpdb;
    $table_name = $wpdb->prefix . 'post_notes';
    $wpdb->query( "DROP TABLE IF EXISTS $table_name" );
}
register_uninstall_hook( __FILE__, 'my_note_plugin_uninstall' );

Best Practices et Préparation à la Publication

Respecter les normes de codage de WordPress

Afin d’assurer la lisibilité, la maintenabilité du code ainsi que sa compatibilité avec d’autres plugins, veuillez respecter strictement les normes de codage PHP officielles de WordPress. Cela inclut, mais ne se limite pas à : utiliser l’indentation correcte (des tabulations plutôt que des espaces), nommer les fonctions et les variables en utilisant des lettres minuscules séparées par des underscores (_), nommer les classes en utilisant la convention UpperCamelCase, et utiliser des fonctions d’internationalisation pour tous les textes qui peuvent être traduits.

Implémenter l’internationalisation

Un plugin de qualité, destiné à être largement utilisé, doit prendre en charge l’internationalisation. Cela signifie que tout le texte destiné aux utilisateurs doit être encapsulé dans des fonctions de traduction.

WordPress offre…__()、_e()、_n()Une série de fonctions… Tout d’abord, vous devez les configurer dans les informations de tête du plugin.Text DomainPar exemple, pour « my-first-plugin », il faut d’abord l’encapsuler (l’entourer d’une structure appropriée) avant de l’afficher ou de l’utiliser à chaque fois.

Exemple :

echo '<p>' . esc_html__( '这是一个演示文本。', 'my-first-plugin' ) . '</p>';

Ensuite, vous pouvez utiliser un outil comme Poedit pour extraire tout le texte et le générer..potFichiers, à traduire dans différentes langues par le traducteur..moet.poLes documents.

Sécurité et optimisation des performances

La sécurité est de la plus haute importance dans le développement de plugins. Vérifiez et nettoyez constamment les données saisies par les utilisateurs (sanitization), et échappez (escapez) les données affichées. Lors des requêtes SQL, veillez à utiliser des mécanismes de sécurité appropriés.prepare()Des instructions sont mises en place pour empêcher les injections de code malveillant. Avant d’exécuter une opération, les autorisations de l’utilisateur sont vérifiées.current_user_can()Pour les cas non liés à la fonctionnalité CE (Conditional Expression), il est possible d’utiliser le mécanisme de nonce (Nonce) intégré à WordPress.wp_nonce_field(), wp_verify_nonce()）。

En termes de performance, il est important d’optimiser les requêtes de base de données et d’éviter d’exécuter des requêtes à l’intérieur de boucles. Utilisez de manière judicieuse l’API des « Transients » de WordPress pour mettre en cache les données. Supprimez également ces données dès qu’elles ne sont plus nécessaires, en utilisant les mécanismes appropriés.remove_action(), remove_filter()Enfin, assurez-vous que le répertoire des plugins ne contienne que les fichiers nécessaires, et compressez et nettoyez le code avant de le publier.

Prêt à être publié dans le répertoire de WordPress.

Si vous comptez publier votre plugin dans le catalogue officiel des plugins WordPress, vous devez effectuer une série de préparatifs. Assurez-vous que votre plugin dispose d’une documentation claire et complète, ainsi que d’une interface utilisateur intuitive.readme.txtLe fichier respecte les spécifications de WordPress. Il doit contenir une description du plugin, des instructions d’installation, des FAQ, un journal des mises à jour, etc. Assurez-vous également que les informations de la tête du fichier principal du plugin soient complètes et exactes. Testez attentivement la compatibilité de votre plugin dans différents environnements et différentes versions de WordPress.

résumés

Le développement de plugins pour WordPress est un processus créatif qui consiste à transformer des idées en fonctionnalités puissantes. En comprenant la structure de base des plugins, en maîtrisant les mécanismes fondamentaux des “ hooks ” (Actions et Filters), et en utilisant avec habileté des fonctionnalités essentielles telles que l’API Settings et les opérations sur la base de données, vous pourrez créer toutes sortes de plugins, allant d’outils simples à des solutions complexes. Tout au long du processus de développement, veillez toujours à respecter des principes fondamentaux tels que la sécurité, la performance, les normes de codage et l’internationalisation. Commencez par créer votre premier plugin « Hello World », pratiquez progressivement, et vous pourrez finalement créer des plugins professionnels, prêts à être publiés sur WordPress.

FAQ Foire aux questions

Quelles technologies faut-il maîtriser pour le développement d’extensions (plugins) ?

Vous devez disposer d’une solide base en PHP, ainsi qu’une connaissance des langages HTML, CSS et JavaScript de base. Une compréhension de la base de données MySQL est également importante. Le plus essentiel est de maîtriser la structure fondamentale de WordPress, en particulier le mécanisme des « hooks » (points d’interception) et la hiérarchie des templates (modèles). Les connaissances en programmation orientée objet (POO) seront très utiles pour la création de plugins complexes.

Quelle est la différence entre les fonctions des plugins et celles des thèmes ?

Les plugins sont utilisés pour ajouter ou modifier les fonctionnalités d’un site web. En théorie, ils devraient être séparés de l’apparence du site et devraient présenter une grande portabilité, afin de pouvoir continuer à fonctionner même après le changement de thème. Les thèmes contrôlent principalement l’apparence et le layout du site, mais les thèmes modernes contiennent souvent également de nombreux codes fonctionnels (ce qui est considéré comme une mauvaise pratique). La meilleure approche est la suivante : si une fonctionnalité est étroitement liée à l’affichage visuel, elle peut être intégrée dans le thème ; si elle est générale ou indépendante, elle doit être conçue sous forme de plugin.

Comment gérer les mises à jour des plugins et leur compatibilité ?

Pour gérer les mises à jour, vous devez modifier les commentaires en tête du plugin.VersionPour les mises à jour majeures, vous pouvez envisager d’utiliser le mécanisme de notification des mises à jour de WordPress ainsi que le programme d’upgrade. La clé pour assurer la compatibilité réside dans le respect strict de l’API de base de WordPress lors du développement : évitez d’utiliser des fonctions privées ou obsolètes, et assurez-vous que vos modifications ne perturbent pas le fonctionnement normal du site.readme.txtLe fichier indique clairement la version minimale de WordPress supportée par le plugin. Avant de publier une nouvelle version, assurez-vous de l’avoir suffisamment testée sur plusieurs versions de WordPress.

Comment les plugins doivent-ils charger les fichiers CSS et JavaScript ?

Il est absolument interdit d’insérer du CSS ou du JS directement dans les fichiers PHP des plugins. Afin de garantir la compatibilité et les bonnes performances, il est nécessaire d’utiliser la fonction `wp_enqueue` de WordPress pour charger correctement les scripts et les feuilles de style. Cela se fait en arrière-plan.admin_enqueue_scriptsUn « crochet » (hook), utilisé en interface utilisateur (front-end).wp_enqueue_scriptsCrochet. À utiliser.wp_enqueue_style()etwp_enqueue_script()Fonction, et veillez à gérer les dépendances ainsi que les numéros de version.

Comment puis-je ajouter des types d’articles personnalisés ou des systèmes de classification personnalisés à mon plugin ?

Ajout d'un type d'article personnalisé (Custom Post Type, CPT)register_post_type()Pour ajouter une classification personnalisée à une fonction, suivez ces étapes :register_taxonomy()Fonctions. La meilleure pratique consiste à placer ces opérations de registration…initL’action est exécutée à l’intérieur d’un « hook ». Il est nécessaire de configurer soigneusement l’arrêté des paramètres de registration, qui comprennent des informations telles que les étiquettes, le niveau de visibilité, les fonctionnalités supportées, et la présence ou non d’une page d’archivage. Ces paramètres déterminent le comportement de l’action, tant en arrière-plan qu’en interface utilisateur.