Partir de zéro : Guide complet de démarrage et tutoriel pratique pour le développement de plugins WordPress.

Préparation et aménagement de l'environnement.

Avant de développer un plugin pour WordPress, il est essentiel de mettre en place un environnement de développement local stable. Cela vous permettra de tester et de déboguer vos fonctionnalités sans affecter le site web en ligne.

Choix et configuration de l'environnement de développement local

L’étape la plus essentielle consiste à mettre en place un serveur local intégrant PHP, MySQL, ainsi que Apache ou Nginx. Vous pouvez choisir…MAMP、XAMPPDe tels paquets logiciels intégrés offrent des méthodes d’installation simples pour Windows et macOS. Pour les utilisateurs plus avancés, il est également possible de…DockerLa mise en conteneur de votre environnement de développement constitue actuellement la meilleure pratique, car elle permet d’assurer une cohérence de l’environnement et de faciliter sa reproduction. Quelle que soit la méthode choisie, veillez à ce que la version de PHP utilisée soit compatible avec les versions les plus récentes prévues pour les plugins (par exemple, PHP 7.4 ou ultérieure), et activez les extensions PHP nécessaires, telles que MySQLi ou PDO.

Installation et configuration de WordPress.

Une fois que l’environnement du serveur local est prêt, vous devez installer le noyau de WordPress. Téléchargez la dernière version stable depuis le site officiel de WordPress.org, puis dézippez le fichier dans le répertoire racine du site web de votre serveur (par exemple, dans le répertoire `/www`).htdocsOuwwwLe fichier se trouve dans un sous-dossier situé à l’intérieur de ce répertoire. Ensuite, accédez à ce sous-dossier depuis votre navigateur et suivez les étapes bien connues de l’installation en 5 minutes pour configurer le plugin. Il est conseillé de créer une base de données dédiée au développement de plugins, et de noter le nom de la base de données, le nom d’utilisateur ainsi que le mot de passe. Après l’installation, rendez-vous dans l’administration de WordPress et modifiez la structure des liens permanents pour qu’elle utilise un format non par défaut (par exemple, le nom de l’article), ce qui facilitera la vérification de la compatibilité du plugin avec ces liens permanents.

Lectures recommandées Introduction au développement de thèmes WordPress : Créez votre premier thème personnalisé à partir de zéro.。

Recommandations d'outils de développement essentiels

Un développement efficace ne peut se passer d'outils adaptés. Tout d'abord, vous avez besoin d'un éditeur de code, comme un outil gratuit et puissant…Visual Studio CodeInstallez des plugins adaptés à PHP, WordPress et à la reconnaissance intelligente du code. Outils de contrôle de version également nécessaires.GitC’est un outil essentiel pour gérer les modifications apportées au code et pour reconstituer son historique. Les outils de développement des navigateurs (Chrome DevTools ou Firefox Developer Edition) sont cruciaux pour le débogage du côté client (front-end). Enfin, pensez à installer un outil de vérification de la qualité du code.PHP_CodeSnifferCombinaisonWordPress-Coding-StandardsUn ensemble de règles vous aide à respecter les normes de codage officielles de 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

Structure de base des plugins et fichiers clés

Un plugin WordPress standard dispose d’une structure de répertoires et de fichiers bien définie. Respecter ces normes est essentiel pour que le plugin soit reconnu par le système et puisse être géré efficacement.

Composition de base du fichier principal et ses fonctions

Chaque plugin doit disposer d’un fichier PHP principal qui sert de point d’entrée pour le plugin. Les commentaires d’en-tête de ce fichier contiennent les métadonnées du plugin, qui sont essentielles pour que WordPress puisse le reconnaître. Voici un exemple de fichier principal de plugin le plus basique possible.my-first-plugin.phpExemple :

<?php
/**
 * Plugin Name:       我的首个插件
 * Plugin URI:        https://example.com/my-first-plugin
 * Description:       这是一个用于演示的WordPress插件。
 * Version:           1.0.0
 * Author:            你的名字
 * Author URI:        https://example.com
 * License:           GPL v2 or later
 * Text Domain:       my-first-plugin
 * Domain Path:       /languages
 */

// 防止直接文件访问
if ( ! defined( 'ABSPATH' ) ) {
    exit;
}

Plugin NameC’est le seul champ obligatoire, utilisé pour l’affichage de la liste des plugins dans l’interface administrative. Il est conseillé de le définir.ABSPATHVérifier pour empêcher les utilisateurs malveillants d’accéder directement aux fichiers principaux du plugin.

Ajouter le code fonctionnel essentiel au plugin.

Après les commentaires d’en-tête, vous pouvez commencer à écrire le code fonctionnel de l’extension. L’exemple le plus simple consiste à ajouter un message “Hello World” dans l’interface d’administration. Vous pouvez utiliser…add_actionLes « hooks » permettent d’associer des fonctions personnalisées à des points d’exécution spécifiques de WordPress.

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

/**
 * 在管理后台顶部显示欢迎信息
 */
function myfp_display_admin_notice() {
    echo '<div class="notice notice-success is-dismissible"><p>Bienvenue à utiliser “ Mon premier plugin ” !</p></div>';
}
add_action( 'admin_notices', 'myfp_display_admin_notice' );

Afin de maintenir l’organisation du code et d’éviter les conflits de noms, tous les noms de fonctions et de classes doivent utiliser un préfixe unique, comme c’est le cas ici.myfp_(Abreviation for “My First Plugin”).

Normes de organisation du répertoire des plugins et des fichiers de ressources

Un plugin un peu plus complexe contient généralement plusieurs fichiers. Une structure de répertoires bien conçue peut considérablement améliorer sa maintenance. Les méthodes d’organisation les plus courantes sont les suivantes :
- /assets/Il sert à stocker des ressources statiques telles que le CSS, le JavaScript, les images et les polices de caractères.
- /includes/Ce répertoire contient les fichiers de classes PHP essentielles ainsi que les fichiers contenant les fonctions fonctionnelles.
- /admin/Il s'agit d'un répertoire destiné à stocker des fichiers PHP, CSS et JS qui ne sont liés qu'au back-end administrateur.
- /public/Il s'agit d'un espace destiné à stocker les fichiers liés à l'aspect visuel (ou à l'interface utilisateur) du site web.
- /languages/Il s'agit d'un répertoire destiné à stocker les fichiers de traduction internationaux (.po et .mo).

N’oubliez jamais que le fichier principal du plugin se trouve dans le répertoire racine du plugin. Lorsque vous faites référence à des fichiers de ressources dans votre code, vous devez utiliser…plugin_dir_url( FILE )Ouplugin_dir_path( FILE )Obtenir dynamiquement l’URL ou le chemin de serveur correct.

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

Le mécanisme des « hooks » interagit avec les API centrales (core APIs).

L’essence du développement de plugins pour WordPress réside dans son mécanisme des “ hooks ” (crochets). Ce système permet à votre code d’être intégré et exécuté à des moments précis, que ce soit au niveau du noyau de WordPress, des thèmes ou d’autres plugins.

Comprendre les crochets d'action (action hooks) et les crochets de filtre (filter hooks)

Les hooks se divisent en deux grandes catégories : les actions (Action) et les filtres (Filter). Les hooks d’action sont utilisés pour exécuter votre code lorsqu’un événement spécifique se produit, par exemple après la publication d’un article ou avant le chargement d’une page. Ils ne retournent aucune valeur ; ils se contentent de “ faire ” quelque chose. La fonction clé utilisée pour cela est…add_action()etdo_action()Les crochets de filtre sont utilisés pour modifier les données. Avant que les données ne soient utilisées, enregistrées ou affichées, vous pouvez les intercepter et les modifier. Ils doivent retourner une valeur. La fonction principale utilisée est…add_filter()etapply_filters()。

Installer des fonctionnalités personnalisées sur les crochets standard

Le noyau de WordPress propose des centaines de « hooks » standard. Par exemple, vous pouvez ajouter automatiquement une déclaration de droits d’auteur à la fin du contenu d’un article, ce qui implique à la fois l’utilisation d’actions (actions) et de filtres (filters).

Lectures recommandées Du niveau débutant au niveau expert dans le développement de plugins WordPress : apprenez à créer des fonctionnalités personnalisées étape par étape.。

// 使用过滤器修改文章内容
function myfp_add_copyright_to_content( $content ) {
    if ( is_single() ) {
        $copyright_text = '<p><em>Veuillez indiquer la source lorsque vous reproduisez ce contenu.</em></p>';
        $content .= $copyright_text;
    }
    return $content;
}
add_filter( 'the_content', 'myfp_add_copyright_to_content' );

// 使用动作在文章保存时执行操作
function myfp_log_post_publish( $post_id ) {
    // 记录日志或执行其他后处理
    error_log( "文章 ID {$post_id} 已发布。" );
}
add_action( 'publish_post', 'myfp_log_post_publish' );

Créer et fournir des crochets personnalisés pour l’extension.

Un plugin bien conçu devrait également permettre à d’autres développeurs de l’élargir. Vous pouvez y parvenir en créant vos propres crochets personnalisés. Cela reflète à la fois l’ouverture de l’architecture des plugins et respecte la philosophie même de WordPress.

// 定义一个自定义动作钩子
function myfp_process_data() {
    $data = '一些初始数据';
    // 其他开发者可以通过 ‘myfp_before_action’ 在此处插入代码
    do_action( 'myfp_before_action', $data );

// 插件的主要处理逻辑...

// 其他开发者可以通过 ‘myfp_after_action’ 在此处插入代码
    do_action( 'myfp_after_action', $data );
}

// 定义一个自定义过滤器钩子
function myfp_get_output() {
    $output = '默认输出';
    // 允许其他开发者过滤最终的输出
    return apply_filters( 'myfp_filter_output', $output );
}

Créer une interface de gestion des plugins et des options de configuration.

La plupart des plugins nécessitent une interface administrative permettant aux utilisateurs de les configurer. WordPress propose de nombreuses API pour vous aider à créer rapidement et en toute sécurité des pages de paramétrage et des options standardisées.

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

Gérer les options de sécurité à l’aide de l’API de configuration

L’API de configuration de WordPress est un cadre de sécurité permettant de gérer les formulaires, de vérifier les données, de les stocker et de les afficher. Il s’occupe automatiquement des champs de sécurité (tels que les « nonces ») ainsi que des contrôles d’accès. Les étapes de base pour créer une page de configuration sont les suivantes : 1) Enregistrer la configuration, 2) Ajouter des blocs de configuration, 3) Ajouter des champs. Le code ci-dessous démontre comment enregistrer une configuration simple.

function myfp_register_settings() {
    register_setting(
        'myfp_settings_group', // 选项组名
        'myfp_option_name',    // 选项名（存储在wp_options表中）
        array( 'sanitize_callback' => 'myfp_sanitize_callback' ) // 消毒回调函数
    );

add_settings_section(
        'myfp_settings_section', // 区块ID
        '基本设置',               // 区块标题
        'myfp_section_callback', // 区块回调函数（可输出描述）
        'myfp-settings-page'     // 设置页面Slug
    );

add_settings_field(
        'myfp_text_field',      // 字段ID
        '示例文本输入',         // 字段标签
        'myfp_text_field_callback', // 字段回调函数（输出HTML表单域）
        'myfp-settings-page',   // 页面Slug
        'myfp_settings_section' // 所属区块ID
    );
}
add_action( 'admin_init', 'myfp_register_settings' );

Créer des pages de menus et de sous-menus à des emplacements différents.

Vous devez ajouter le lien vers la page de paramétrage au menu de gestion de WordPress. Pour ce faire, suivez ces étapes :add_menu_page()Il est possible de créer un menu de niveau supérieur en utilisant…add_submenu_page()Il est possible de créer des sous-menus.

function myfp_add_admin_menu() {
    // 添加顶级菜单
    add_menu_page(
        '我的插件设置',        // 页面标题
        '我的插件',            // 菜单标题
        'manage_options',     // 权限能力
        'myfp-settings-page', // 菜单Slug
        'myfp_render_settings_page', // 渲染页面的回调函数
        'dashicons-admin-generic', // 图标（可选）
        80                    // 菜单位置
    );

// 添加子菜单（指向同一个页面，但菜单标题不同）
    add_submenu_page(
        'myfp-settings-page', // 父菜单Slug
        '关于此插件',         // 页面标题
        '关于',              // 菜单标题
        'manage_options',    // 权限能力
        'myfp-about-page',   // 菜单Slug
        'myfp_render_about_page' // 渲染回调
    );
}
add_action( 'admin_menu', 'myfp_add_admin_menu' );

Fonction de rappel pour afficher la page de paramètres personnalisés

myfp_render_settings_pageLa fonction de rappel est chargée d’afficher la structure HTML de la page de configuration. Dans cette fonction, vous devez appeler…settings_fields()etdo_settings_sections()Affichez les champs enregistrés par l'API Settings.

function myfp_render_settings_page() {
    // 检查用户权限
    if ( ! current_user_can( 'manage_options' ) ) {
        return;
    }
    ?>
    <div class="wrap">
        <h1></h1>
        <form action="/fr/options.php/" method="post" data-trp-original-action="options.php">
            <?php
            settings_fields( 'myfp_settings_group' );
            do_settings_sections( 'myfp-settings-page' );
            submit_button( '保存设置' );
            ?>
        <input type="hidden" name="trp-form-language" value="fr"/></form>
    </div>
    &lt;?php
}

résumés

Le développement de plugins pour WordPress est un processus qui consiste à transformer des idées en fonctionnalités concrètes. Le succès de ce processus dépend d’une compréhension claire de la structure de base du système, d’une maîtrise des mécanismes de liaison (« hooks ») entre les différents éléments du système, ainsi que d’une attention constante à la sécurité et à l’expérience utilisateur. Chaque étape du développement – de la mise en place de l’environnement de développement à la rédaction des fichiers principaux du plugin – suit des normes et des bonnes pratiques établies. Il est essentiel de maintenir le code modulaire, lisible et extensible, d’utiliser des préfixes uniques pour éviter les conflits, et de donner la priorité à la sécurité à tout moment. Grâce à l’apprentissage et à la pratique guidés par ce guide, vous disposez désormais des compétences nécessaires pour créer des plugins WordPress complets et conformes aux normes, à partir de zéro.

FAQ Foire aux questions

Quelles connaissances de programmation sont nécessaires pour développer des plugins WordPress avec le code ### ?
Pour développer des plugins pour WordPress, il est essentiel de posséder de solides connaissances de base en programmation PHP, y compris la syntaxe, les fonctions, les arrays et les concepts de programmation orientée objet. Une compréhension de base des technologies frontales HTML, CSS et JavaScript est également très utile pour la création de plugins dotés d’interfaces utilisateur. Il est également avantageux de maîtriser les opérations de base sur la base de données MySQL, car WordPress en dépend fortement.

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

Il existe plusieurs méthodes pour déboguer des plugins. Tout d’abord,wp-config.phpActiver dans le fichier.WP_DEBUGetWP_DEBUG_LOGCela enregistrera les erreurs et les avertissements PHP dans…/wp-content/debug.logLes informations se trouvent dans le fichier, mais elles ne sont pas affichées aux utilisateurs finaux. Deuxièmement, utilisez les outils de développement du navigateur (comme Chrome DevTools) pour déboguer le JavaScript et les requêtes réseau. Pour des logiques complexes, vous pouvez…var_dump()Ouerror_log()La fonction affiche la valeur de la variable dans le journal ou sur la page. De plus, l’installation d’un débogueur PHP professionnel tel que Xdebug, et son intégration avec votre éditeur de code, permet de mettre en place le débogage par points d’arrêt, ce qui constitue la méthode la plus efficace pour résoudre les problèmes.

Comment mon plugin peut-il être internationalisé pour prendre en charge plusieurs langues ?

Pour mettre en œuvre l’internationalisation (i18n) dans WordPress, on utilise principalement les outils et fonctionnalités qui sont fournis par le framework lui-même.__()、_e()、_x()Dans le code du plugin, enveloppez toutes les chaînes de texte qui doivent être traduites à l’aide de ces fonctions, et spécifiez le domaine de texte (Text Domain), qui a été défini dans les commentaires en tête du plugin.Text DomainEnsuite, utilisez un outil comme Poedit pour analyser le code source du plugin et générer les fichiers nécessaires..potFichiers de modèle : les traducteurs s’en servent pour créer des versions dans différentes langues..poEt après compilation..moFichiers. Enfin, placez ces fichiers de traduction dans le plugin./languages/Dans le répertoire, et utiliser cela lors de l’initialisation du plugin.load_plugin_textdomain()Les fonctions les chargent.

Comment publier mon plugin gratuitement dans le catalogue officiel des plugins WordPress ?

Pour publier un plugin dans le répertoire officiel de WordPress, il faut respecter une série de conditions. Tout d’abord, assurez-vous que votre plugin soit entièrement conforme à la licence GPL v2 ou à une version ultérieure. Ensuite, veillez à la qualité et à la sécurité du code, en suivant les normes de codage de WordPress. Vous devez également créer un compte sur WordPress.org et soumettre votre plugin dans la section “Développeurs”. Avant de soumettre votre plugin, assurez-vous qu’il dispose d’une documentation détaillée et bien structurée.readme.txtLe fichier est rédigé dans un format Markdown spécifique et l’internationalisation a été correctement configurée. Après soumission, l’équipe de révision des plugins le examinera. Ce processus peut durer de quelques jours à plusieurs semaines. Une fois l’approbation obtenue, votre plugin pourra être recherché et installé dans le répertoire officiel.