Le guide ultime du développement de plugins WordPress : créez votre premier plugin personnalisé à partir de zéro.

Pourquoi choisir le développement de plugins pour WordPress ?

Le fait que WordPress soit devenu le système de gestion de contenu le plus populaire au monde est en grande partie dû à sa forte extensibilité, qui est rendue possible par son architecture basée sur des plugins. En développant des plugins personnalisés, vous pouvez ajouter à votre site web toutes les fonctionnalités que vous imaginez, sans avoir à modifier le code source de WordPress lui-même. Cela signifie que ces fonctionnalités peuvent exister indépendamment des thèmes utilisés et rester intactes même en changeant de thème. De plus, un bon plugin peut résoudre des problèmes spécifiques des utilisateurs, voire devenir un produit ou un service à part entière.

Maîtriser le développement de plugins signifie que vous passez d’un utilisateur de WordPress à un créateur. Que ce soit pour répondre aux besoins personnalisés de vos projets ou pour générer des revenus en développant des plugins commerciaux, il est essentiel de comprendre les principes fondamentaux et les meilleures pratiques du développement de plugins. Ce guide vous guidera, à partir des structures les plus basiques, pour construire progressivement un plugin complet et conforme aux normes.

Construire votre première structure de plugin

Un plugin WordPress standard est un dossier contenant une ou plusieurs fichiers PHP, et son répertoire racine doit contenir un fichier principal. Ce fichier principal doit inclure des informations de déclaration spécifiques au plugin, afin que WordPress puisse le reconnaître et le gérer correctement.

Lectures recommandées Maîtriser le développement de plugins WordPress : créer des modules de fonctionnalités personnalisées et efficaces à partir de zéro.。

Créer le fichier principal du plug-in.

La première chose que vous devez faire est de créer le fichier principal du plugin. Ce fichier porte généralement le même nom que le plugin lui-même, par exemple… my-first-plugin.phpEn haut de ce fichier, vous devez ajouter une annotation de type « header de plugin » conforme aux normes établies.

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://yourwebsite.com/my-first-plugin
 * Description:       这是一个用于学习的 WordPress 自定义插件示例。
 * Version:           1.0.0
 * Author:            你的名字
 * Author URI:        https://yourwebsite.com
 * License:           GPL v2 or later
 * Text Domain:       my-first-plugin
 * Domain Path:       /languages
 */

Cette annotation est l’équivalent de la “ carte d’identité ” du plugin. Plugin NameLe nom du plugin est le seul champ obligatoire ; les autres champs servent à fournir des informations supplémentaires. La page “ Plugins ” dans l’administration de WordPress lit ces informations et les affiche. Une fois ce fichier créé, vous devez le placer dans le répertoire d’installation de WordPress. /wp-content/plugins/ Le fichier se trouve dans le dossier correspondant. Vous pouvez créer directement un sous-dossier nommé “ my-first-plugin ” et y placer le fichier principal. Ensuite, connectez-vous à l’administration de WordPress et vous verrez ce plugin dans la liste des plugins disponibles ; vous pourrez alors l’activer. Bien qu’il n’ait aucune fonctionnalité pour l’instant, vous avez déjà franchi la première étape vers le succès.

Organisez vos fichiers de plugins.

Avec l’augmentation du nombre de fonctionnalités, il devient difficile de maintenir tout le code dans un seul fichier principal. Une bonne structure d’organisation des fichiers est donc essentielle. Un plugin typique peut contenir les dossiers suivants :
* /includes/Contient les fichiers définissant les fonctionnalités essentielles et les classes.
* /admin/Contient les fichiers relatifs à l'interface d administration en arrière-plan.
* /public/Contient les fichiers de fonctionnalités frontales destinés aux visiteurs du site web.
* /assets/Il sert à stocker des ressources statiques telles que le JavaScript, le CSS et les images.
* /languages/Réservé aux fichiers de traduction internationaux (.po/.mo).

Cette structure modulaire non seulement rend le code plus lisible, mais facilite également la collaboration au sein de l’équipe ainsi que l’extension des fonctionnalités à l’avenir. Dans le fichier principal… my-first-plugin.php Dans ce contexte, vous utilisez généralement… require_once Pour introduire les fichiers fonctionnels situés dans ces dossiers.

Comprendre les concepts fondamentaux du développement de WordPress : les hooks et les filtres

Le cœur du développement de plugins pour WordPress est le mécanisme des “ hooks ”. Il vous permet de faire en sorte que votre code s’incorpore au flux d’exécution principal de WordPress à des moments précis, afin d’y modifier ou d’y ajouter des fonctionnalités. Les hooks se divisent en deux catégories : les actions (Actions) et les filtres (Filters).

Lectures recommandées Maîtriser le développement de plugins WordPress à partir de zéro : guide de mise en œuvre de fonctionnalités avancées et de meilleures pratiques.。

Utiliser des crochets d’action pour ajouter des fonctionnalités

Les « action hooks » vous permettent d’exécuter vos fonctions personnalisées à un moment précis pendant le fonctionnement de WordPress. Par exemple, vous pouvez effectuer une action lors de la publication d’un article, ou ajouter un menu à la barre latérale de l’administration.

Voici un exemple simple qui utilise… wp_footer Ce crochet d’action affiche une information dans la zone commune en bas de la page du site web. Vous devez ajouter le code suivant au fichier principal de votre plugin.

function myplugin_add_footer_text() {
    echo '<p style="text-align:center;">Merci d’utiliser mon premier plugin !</p>';
}
add_action( 'wp_footer', 'myplugin_add_footer_text' );

Ici,myplugin_add_footer_text C’est une fonction que nous avons définie nous-mêmes.add_action() La fonction “lie” cette autre fonction à… wp_footer Cette action est liée à un crochet (hook). Lorsque WordPress atteint la section du pied de page (footer), notre fonction est automatiquement appelée.

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

Utiliser les hooks des filtres pour modifier le contenu.

Contrairement aux crochets d’action, les crochets de filtre sont utilisés pour modifier des données. Votre fonction recevra une valeur en entrée et doit en retourner une autre après traitement. Par exemple, modifier le titre d’un article ou changer la manière dont le contenu est affiché.

L'exemple suivant montre comment utiliser… the_content Un filtre qui ajoute automatiquement un texte personnalisé à la fin de tous les articles et du contenu des pages.

function myplugin_append_to_content( $content ) {
    $custom_text = '<div class="myplugin-note"><p><em>Ce texte est affiché de manière améliorée grâce à mon plugin personnalisé.</em></p></div>';
    // 仅在主循环的单篇文章页面添加
    if ( is_single() &amp;&amp; in_the_loop() &amp;&amp; is_main_query() ) {
        return $content . $custom_text;
    }
    return $content;
}
add_filter( 'the_content', 'myplugin_append_to_content' );

La fonction myplugin_append_to_content Recevoir l’original. $contentNous utilisons des conditions pour nous assurer que le texte n’est ajouté que là où c’est nécessaire, puis nous retournons le contenu modifié.add_filter() La fonction a effectué l’enregistrement.

Lectures recommandées Du niveau débutant au niveau expert dans le développement de plugins WordPress : créer des fonctionnalités personnalisées et des extensions efficaces.。

Créer une page de gestion pour le plugin.

La plupart des plugins nécessitent une page de configuration permettant aux utilisateurs de définir des options. WordPress offre une API richement dotée pour créer des interfaces de gestion esthétiques et standardisées.

Ajouter un menu de gestion de niveau supérieur

Vous pouvez ajouter un nouvel élément de menu de niveau supérieur à la barre de navigation gauche du panneau d’administration de WordPress pour votre plugin. Cela se fait en suivant ces étapes : add_menu_page() La fonction est mise en œuvre par des programmes. Nous utilisons généralement… admin_menu Cette fonction est appelée dans ce hook d'action.

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

function myplugin_add_admin_menu() {
    add_menu_page(
        '我的插件设置', // 页面标签
        '我的插件',     // 菜单标题
        'manage_options', // 所需权限
        'myplugin-settings', // 菜单 Slug
        'myplugin_settings_page_html', // 显示页面内容的回调函数
        'dashicons-admin-generic', // 图标（可选）
        80 // 菜单位置（可选）
    );
}
add_action( 'admin_menu', 'myplugin_add_admin_menu' );

Construire le contenu de la page de paramétrage

Maintenant, nous devons définir la fonction de rappel (callback) mentionnée ci-dessus. myplugin_settings_page_htmlCela sert à rendre le contenu HTML de la page de configuration. Une version simplifiée est la suivante :

function myplugin_settings_page_html() {
    // 检查用户权限
    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
            // 输出设置字段和非ce字段
            settings_fields( 'myplugin_options' );
            do_settings_sections( 'myplugin-settings' );
            submit_button( '保存设置' );
            ?>
        <input type="hidden" name="trp-form-language" value="fr"/></form>
    </div>
    &lt;?php
}

Cette fonction crée un formulaire conforme au style du back-end de WordPress. Pour gérer complètement les paramètres, vous devez également utiliser… register_setting(), add_settings_section() et add_settings_field() Des fonctions telles que celles-ci sont utilisées pour définir les paramètres de configuration spécifiques, ce qui constitue le flux de travail complet de l“” API des Paramètres » (Settings API). C’est la méthode recommandée pour stocker et récupérer de manière sécurisée les options des plugins.

Réaliser une fonctionnalité de plugin pratique : le comptage du nombre de consultations des articles.

Combinons ces concepts pour créer une fonction pratique : compter et afficher le nombre de consultations pour chaque article.

Créer des champs dans une base de données et y stocker des données.

Tout d’abord, nous devons créer un espace pour stocker le nombre de consultations lors de la publication d’un article. Généralement, nous utilisons la fonctionnalité des meta-données des articles (post meta) de WordPress. Nous pouvons… add_post_meta Il existe des fonctions pour cela, mais une manière plus élégante consiste à vérifier et à mettre à jour cette valeur lorsque l’article est consulté.

function myplugin_track_post_views( $post_id ) {
    if ( ! is_single() ) {
        return;
    }
    if ( empty( $post_id ) ) {
        global $post;
        $post_id = $post->ID;
    }
    // 获取当前浏览次数
    $count = get_post_meta( $post_id, 'myplugin_post_views', true );
    // 如果为空，初始化为0
    $count = $count ? absint( $count ) : 0;
    $count++;
    // 更新数据库
    update_post_meta( $post_id, 'myplugin_post_views', $count );
}
// 在模板重定向时触发，确保只对真实访客计数
add_action( 'template_redirect', 'myplugin_track_post_views' );

Afficher le nombre de consultations sur la page frontale.

Une fois les données stockées, nous avons besoin d’une fonction pour les récupérer et les afficher. Nous pouvons créer un raccourci (shortcode) qui permettra aux utilisateurs de l’insérer facilement dans le contenu des articles ou dans les outils de la barre latérale.

function myplugin_display_post_views_shortcode( $atts ) {
    $atts = shortcode_atts( array(
        'id' => get_the_ID(),
    ), $atts, 'myplugin_views' );

$post_id = absint( $atts['id'] );
    $views = get_post_meta( $post_id, 'myplugin_post_views', true );
    $views = $views ? $views : 0;

return '<span class="myplugin-view-count">Nombre de consultations : ' . esc_html( $views ) . '</span>'php
add_shortcode('myplugin_views', 'myplugin_display_post_views_shortcode');

Aujourd'hui, les utilisateurs n’ont plus qu’à saisir un code court dans l’éditeur d’articles. [myplugin_views]Il est également possible d’ajouter une petite application (un “gadget”) qui contient un “code court” ; en saisissant ce code, le nombre de consultations de l’article peut être affiché sur la page. Cet exemple complet couvre l’ensemble du processus, allant de l’stockage des données (les “hooks”) à la récupération des données, en passant par l’affichage sur l’interface utilisateur (le “code court”).

résumés

À travers ce guide, vous avez suivi toutes les étapes pour créer un plugin personnalisé pour WordPress à partir de zéro. Nous avons d’abord découvert la structure de base d’un plugin et créé le fichier principal contenant les informations de tête standard. Ensuite, nous avons approfondi les fondements du développement de plugins WordPress, à savoir les hooks (actions et filtres), et appris comment les utiliser pour ajouter ou modifier des fonctionnalités. Nous avons également créé des pages de gestion professionnelles pour le plugin, qui sont essentielles pour interagir avec les utilisateurs. Enfin, nous avons mis en pratique nos connaissances grâce à un exemple concret : le suivi du nombre de consultations d’articles, réalisant ainsi une chaîne de fonctionnalités complète allant de l’enregistrement des données à leur affichage sur la page web.

N’oubliez pas que le développement de plugins de qualité ne consiste pas seulement à faire fonctionner les fonctionnalités, mais aussi à accorder de l’importance à la sécurité du code, à sa maintenance, à ses performances, ainsi qu’au respect des normes de codage de WordPress. En pratiquant régulièrement et en explorant davantage les API de WordPress, vous serez en mesure de créer des plugins puissants et appréciés par les utilisateurs.

FAQ Foire aux questions

Quelles connaissances préalables sont nécessaires pour développer des plugins ?

Vous devez disposer d’une solide base en programmation PHP, car WordPress et ses plugins sont principalement écrits en PHP. De plus, une connaissance de base des langages HTML, CSS et JavaScript est essentielle pour créer des interfaces utilisateur et des fonctionnalités interactives. Comprendre les concepts de base des bases de données MySQL vous aidera également à comprendre la manière dont WordPress stocke les données.

Comment déboguer mon plug-in WordPress ?

Tout d’abord, assurez-vous que… wp-config.php Activer le mode de débogage de WordPress dans le fichier… WP_DEBUG La constante est définie à trueCela affichera les erreurs et les avertissements PHP à l’écran. Ensuite, utilisez… error_log() La fonction écrit les informations de débogage dans le journal d'erreurs du serveur, ce qui constitue une méthode de débogage très fiable. Pour les variables complexes, il est possible d'utiliser cette méthode en combinaison avec d'autres outils ou techniques. print_r() Ou var_dump() Avec error_log()De plus, utilisez les outils de développement du navigateur (F12) pour déboguer les problèmes liés au JavaScript et au CSS du côté client (front-end).

Comment mon plugin peut-il être compatible avec différentes versions de WordPress ?

Pendant le développement, il est conseillé de consulter régulièrement le manuel officiel de développement de WordPress pour être au courant des modifications apportées aux fonctions et aux hooks dans les différentes versions. function_exists() Ou version_compare() Utilisez des instructions conditionnelles pour vérifier si une fonction ou une fonctionnalité est disponible, afin de proposer une solution de remplacement compatible avec les versions précédentes. Indiquez clairement dans la description du plugin la gamme de versions de WordPress pour lesquelles la compatibilité est assurée. Il est de bonnes pratiques de continuer à tester le plugin dans différents environnements de test de versions de WordPress pour garantir sa compatibilité.

Quelles sont les choses à prendre en compte lors du développement de plugins commerciaux ?

Lors du développement de plugins commerciaux, la sécurité, la qualité du code et l’expérience utilisateur doivent être placées en premier plan. Il est nécessaire de mettre en place un système de validation des autorisations fiable et sécurisé (par exemple, en utilisant des clés de licence). Il est essentiel de fournir des documents d’utilisation clairs et actualisés, ainsi qu’un soutien technique de qualité. Assurez-vous de respecter les guides officiels de développement de plugins de WordPress et l’accord de licence GPL. Pensez à utiliser des plateformes professionnelles telles que Freemius ou Easy Digital Downloads pour gérer les ventes, les mises à jour et les demandes d’assistance.