Partir de zéro : l'infrastructure de développement des plugins WordPress.

Partir de zéro : l'infrastructure de développement des plugins WordPress.

Pour développer un plugin pour WordPress, il est nécessaire de comprendre sa structure de base. Le fichier le plus essentiel d’un plugin est le fichier principal, qui porte généralement le même nom que le plugin. Par exemple…my-first-plugin.phpCe fichier contient non seulement tout le code fonctionnel du plugin, mais ce qui est plus important, les commentaires de la tête contenant les informations sur le plugin, situés en haut du fichier. Cette tête est essentielle pour que WordPress puisse reconnaître le plugin.

Les commentaires situés en tête des plugins doivent contenir des métadonnées spécifiques. Voici un exemple de base :

<?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
 */

J’ai créé ce fichier et je l’ai mis en place./wp-content/plugins/Après avoir créé le répertoire, vous pourrez le voir sur la page des “ Plugins ” dans l’administration de WordPress, et vous pourrez l’activer ou le désactiver. Il est ensuite essentiel de comprendre l’ordre de chargement et d’exécution du code des plugins. Lorsque WordPress charge les plugins, il les fait dans l’ordre alphabétique./wp-content/plugins/Tous les fichiers principaux des plugins valides se trouvent dans le répertoire correspondant. Par conséquent, si votre plugin dépend des fonctionnalités d’un autre plugin, vous ne pouvez pas supposer automatiquement que ce dernier ait été chargé. Dans ce cas, il est nécessaire d’utiliser des mécanismes appropriés pour vérifier que le plugin dépendant a bien été chargé.plugins_loadedCe crochet d’action assure que le code s’exécute au bon moment.

Lectures recommandées Guide complet pour le développement de plugins WordPress : de zéro à la création d'extensions de niveau professionnel.。

Comprendre en profondeur les hooks : le mécanisme des actions et des filtres

La philosophie fondamentale du développement d’extensions pour WordPress repose sur les “ hooks ” (crochets). Ces hooks vous permettent d’insérer votre propre code dans le flux d’exécution du noyau de WordPress, des thèmes ou d’autres extensions, sans avoir à modifier les fichiers originaux. Les hooks se divisent principalement en deux catégories : les hooks d’action (Action Hooks) et les hooks de filtre (Filter 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

Les « action hooks » vous permettent d’exécuter des fonctions personnalisées lorsque des événements spécifiques se produisent. Par exemple, lorsque un article est publié…publish_postLors de la chargement des ressources en haut de la page web…wp_enqueue_scripts) ou lors de l’initialisation depuis l’administration.admin_initPour utiliser un crochet d’action (action hook), vous devez…add_action()La fonction “monte” votre fonction de rappel (callback) sur le crochet (hook) correspondant.

add_action( 'init', 'myplugin_custom_init' );
function myplugin_custom_init() {
    // 在WordPress初始化时执行
    // 例如，注册一个自定义文章类型
}

Les hooks de filtre sont utilisés pour modifier les données. Ils vous permettent d’intercepter et de modifier les variables qui leur sont transmises, avant de les renvoyer. Par exemple, pour modifier le contenu d’un article.the_contentModification de la longueur des extraits.excerpt_length) ou modifier les résultats de la recherche (the_postsPour utiliser un filtre, il est nécessaire d'appeler une fonction ou une méthode appropriée.add_filter()Une fonction.

add_filter( 'the_title', 'myplugin_custom_title' );
function myplugin_custom_title( $title ) {
    // 修改文章标题
    return '前缀：' . $title;
}

Créer un crochet personnalisé

En plus des centaines de hooks intégrés fournis par WordPress, les développeurs de plugins avancés peuvent également créer leurs propres hooks, afin que d’autres développeurs puissent les utiliser pour étendre les fonctionnalités du site.do_action()Pour créer un crochet d'action (action hook), utilisez…apply_filters()Créez un crochet de filtre.

// 在插件代码中定义一个自定义动作钩子
do_action( 'myplugin_after_something_happens', $some_data );

// 在插件代码中定义一个自定义过滤器钩子
$value = apply_filters( 'myplugin_filter_some_value', $default_value );

Construire des fonctionnalités d’extension : Sécurité et bonnes pratiques

Lors de la conception des fonctionnalités d’un plugin, la sécurité est un facteur primordial à prendre en compte. Il ne faut jamais faire confiance aux données saisies par les utilisateurs. Toutes les données provenant de l’extérieur (telles que les formulaires, les paramètres URL ou les cookies) doivent être vérifiées, nettoyées et échappées.

Lectures recommandées Guide d’introduction au développement de plugins WordPress : de zéro à la maîtrise de la création de fonctionnalités personnalisées.。

La validation et l'échappement des données.

Pour les entrées, utilisez…sanitize_text_field()、sanitize_email()、intval()Nettoyer les fonctions correspondantes. Pour les données affichées sur la page HTML, utiliser…esc_html()、esc_attr()Ouwp_kses_post()Réalisez une échappement afin d'empêcher les attaques par script inter-sites.

$user_input = $_POST['some_field'];
$clean_input = sanitize_text_field( $user_input );

// 输出时
echo '<div class="' . esc_attr( $class_name ) . '">'`. esc_html($clean_input)`.'</div>';

Interagir avec une base de données

WordPress offre…$wpdbLes objets globaux sont utilisés pour effectuer des opérations directes sur la base de données, mais il est préférable d’utiliser d’abord les fonctions intégrées à WordPress.get_post()、update_option()Etc. Si l’utilisation de SQL est indispensable, veillez à l’utiliser de manière appropriée.$wpdb->prepare()Méthodes pour se protéger contre les injections SQL.

global $wpdb;
$user_id = intval( $_GET['id'] );
$results = $wpdb->get_results(
    $wpdb->prepare( "SELECT * FROM {$wpdb->prefix}my_table WHERE user_id = %d", $user_id )
);

Ajouter un menu de gestion et des pages correspondantes.

Créer une page de configuration pour un plugin est une demande fréquente. Vous pouvez utiliser…add_menu_page()Ouadd_options_page()Les fonctions en question doivent être utilisées pour ajouter des éléments de menu en arrière-plan. Ces fonctions doivent être exécutées…admin_menuCela est appelé dans les hooks d'action.

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

add_action( 'admin_menu', 'myplugin_add_admin_menu' );
function myplugin_add_admin_menu() {
    add_options_page(
        '我的插件设置', // 页面标题
        '我的插件',     // 菜单标题
        'manage_options', // 权限
        'myplugin-slug',  // 菜单别名
        'myplugin_settings_page' // 用于呈现页面的回调函数
    );
}
function myplugin_settings_page() {
    // 输出设置页面HTML
    echo '<div class="wrap"><h1>mettre en place</h1></div>';
}

Préparation à la publication des plugins : internationalisation et organisation du code

Lorsque les fonctionnalités du plugin seront complètes, il sera nécessaire de se concentrer sur l’internationalisation et l’organisation du code afin de s’adresser à un public plus large et de faciliter son entretien.

Réaliser l'internationalisation des plugins.

L’internationalisation (i18n) permet de traduire vos plugins dans d’autres langues. Cela nécessite l’utilisation des fonctions de traduction intégrées à WordPress.__()、_e()、_x()Collectez toutes les chaînes de caractères visibles par les utilisateurs, et déclarez-les en haut du plugin.Text DomainPar exemple…my-first-plugin）。

// 在代码中
$greeting = __( 'Hello, World!', 'my-first-plugin' );
_e( 'This text will be echoed and translatable.', 'my-first-plugin' );

// 然后，使用如Poedit等工具生成 .pot 翻译模板文件。

Organisation du code en modules

Il est conseillé d’éviter d’accumuler tout le code dans le fichier principal. Une bonne pratique consiste à diviser le code fonctionnel en plusieurs fichiers distincts, chacun correspondant à une fonction spécifique..phpLes fichiers sont inclus dans le fichier principal, qui les contient. Par exemple :
- includes/admin/ Le répertoire contient le code lié au backend.
- includes/public/ Le répertoire contient le code lié à la partie front-end (l’interface utilisateur).
- includes/class-*.php Contient les définitions des principales classes.
- assets/css/ et assets/js/ Sert à stocker les feuilles de style et les scripts.

Lectures recommandées Le guide ultime du développement de plugins WordPress : des conseils de base pour créer des fonctionnalités personnalisées, de zéro à un.。

L'utilisation de la programmation orientée objet permet de mieux organiser le code, d'éviter les conflits de noms de fonctions et d'améliorer la réutilisabilité. Définissez une classe principale, et installez-y tous les hooks nécessaires dans son constructeur.

class My_First_Plugin {
    public function __construct() {
        add_action( 'init', array( $this, 'init_method' ) );
        add_filter( 'the_content', array( $this, 'filter_content' ) );
    }
    public function init_method() {
        // 初始化
    }
    public function filter_content( $content ) {
        return $content . '<p>Contenu ajouté par l'extension</p>';
    }
}
new My_First_Plugin();

résumés

Le développement de plugins pour WordPress consiste à intégrer des fonctionnalités personnalisées de manière fluide dans l’écosystème WordPress. Tout commence par un fichier de commentaires de tête du plugin qui respecte les normes établies. L’essentiel du développement réside dans l’utilisation maîtrisée des hooks d’actions et des hooks de filtres, afin d’élargir ou de modifier le fonctionnement de WordPress de manière pilotée par des événements. Pendant le processus de codage, la sécurité doit être une priorité absolue ; il est donc nécessaire de valider, de nettoyer et d’échapper strictement les données. À mesure que les fonctionnalités du plugin s’étendent, une bonne organisation du code (y compris une conception orientée objet et une structure de fichiers modulaire), ainsi qu’un soutien à l’internationalisation, sont des éléments clés pour améliorer la maintenance du plugin, son professionnalisme et sa portée auprès des utilisateurs. En suivant ces bonnes pratiques, vous pourrez créer des plugins WordPress puissants, sûrs et faciles à distribuer.

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

FAQ Foire aux questions

Pour développer un plugin WordPress, quelles connaissances de base sont nécessaires ?

Vous devez maîtriser les bases du langage PHP, car WordPress ainsi que ses plugins sont écrits en PHP. De plus, il est nécessaire de connaître les fondamentaux d’HTML, CSS et JavaScript pour gérer l’affichage et l’interaction de l’interface utilisateur. Le plus important est de comprendre le fonctionnement de base de WordPress et son système de « hooks » (ancrages), qui constitue le mécanisme essentiel du développement de plugins.

Comment empêcher que le nom de la fonction de mon plugin ne entre en conflit avec celui d’autres plugins ?

La meilleure pratique consiste à utiliser la programmation orientée objet (POO) pour encapsuler vos fonctionnalités dans une classe, de manière que les noms des méthodes à l’intérieur de cette classe soient indépendants. Si vous utilisez la programmation procédurale, vous devez ajouter un préfixe unique à toutes les fonctions, classes et constantes. Ce préfixe peut être l’abréviation de votre plugin ou le nom de votre marque, par exemple.myplugin_Ouacme_Et assurez-vous de maintenir cette cohérence dans tout le code.

Où devrais-je charger les fichiers JavaScript et CSS des plugins ?

Afin d’assurer la précision et les bonnes performances, il ne faut jamais créer de liens directs vers les fichiers ressources dans les templates HTML. Vous devez utiliser les fonctions de mise en file d’attente (enqueue) fournies par WordPress. Pour les ressources frontales, utilisez…wp_enqueue_script()etwp_enqueue_style()Et l’installer sur…wp_enqueue_scriptsSur les crochets d’action. Pour les ressources utilisées uniquement par l’interface d’administration en arrière-plan, elles sont montées (c’est-à-dire mises à disposition) sur ces crochets.admin_enqueue_scriptsSur le crochet.

Comment les plugins stockent-ils leurs propres paramètres et données ?

Pour les paramétrages simples impliquant une seule valeur, il est possible d’utiliser l’API des options de WordPress.add_option()、get_option()etupdate_option()Pour des données plus complexes et structurées (par exemple, une liste d’entrées de formulaire), il conviendra de créer des tables de base de données personnalisées. Cela peut être réalisé en utilisant…dbDelta()La fonction s’exécute lorsque le plugin est activé (via…)register_activation_hookCréer ou mettre à jour la structure d'une table de manière sûre.