Guide de développement de plugins pour WordPress : Créez votre premier plugin personnalisé de zéro à un

Environnement de développement et préparatifs de base

Avant de commencer à écrire du code, il est essentiel de disposer d’un environnement de développement local stable et efficace. Pour le développement de plugins WordPress, nous recommandons l’utilisation d’environnements intégrés tels que XAMPP, MAMP ou Local by Flywheel, qui permettent d’installer Apache, MySQL et PHP en un seul clic, évitant ainsi des procédures de configuration complexes. Vérifiez que votre version de PHP est supérieure ou égale à 7.4 et que votre version de MySQL est supérieure ou égale à 5.6, afin de respecter les dernières exigences officielles de WordPress.

Ensuite, vous aurez besoin d’un éditeur de code. Visual Studio Code, PhpStorm ou Sublime Text sont de très bonnes options ; ils offrent une mise en évidence du syntaxe, des suggestions de code et des fonctionnalités de débogage, ce qui peut considérablement améliorer votre efficacité de développement. Il est également essentiel d’installer un outil de gestion de version, comme Git, pour gérer l’historique des modifications de votre code. C’est une pratique standard dans le développement moderne.

Comprendre la structure de base des plugins WordPress est la première étape. Un plugin de base contient au moins un fichier PHP principal, dont les commentaires en tête du fichier constituent l“” identité » du plugin, permettant de déclarer ses informations au système WordPress. Ce fichier peut exister de manière indépendante, ou il peut servir de point d’entrée pour un répertoire de plugins plus complexes.

Lectures recommandées Développement de plugins pour WordPress : de l’initiation à la maîtrise : Créez votre premier plugin personnalisé。

Créez votre premier fichier de plugin.

Commençons par créer le plugin le plus simple possible. Tout d’abord, dans le répertoire d’installation local de WordPress, allez à…wp-content/pluginsDossier. Créez ici un nouveau dossier et nommez-le…my-first-pluginTous les fichiers liés aux plugins seront placés dans ce répertoire.

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

Dans ce dossier, créez un fichier PHP principal, par exemple nommé « main.php ».my-first-plugin.phpLa section d’en-tête de ce fichier doit contenir un bloc d’annotations spécifique contenant des informations sur les plugins utilisés. Voici un exemple standard :

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

Dans cette note, l’élément “ Plugin Name ” est obligatoire. WordPress en a besoin pour identifier et afficher votre plugin dans la liste des plugins en arrière-plan. D’autres informations telles que la version et l’auteur aident les utilisateurs à mieux comprendre les fonctionnalités du plugin. Après avoir enregistré le fichier, connectez-vous à l’administration de WordPress et accédez à la page des plugins. Vous devriez voir “ Mon premier plugin ” dans la liste des plugins, et vous pourrez l’activer ou le désactiver. Pour l’instant, il n’a aucune fonctionnalité, mais vous avez réussi à créer un cadre de plugin légal.

Ajouter des fonctionnalités essentielles au plugin.

Un plugin activé doit exécuter du code via le mécanisme des hooks de WordPress. Il existe deux types de hooks : les hooks d’action (Action Hooks) et les hooks de filtre (Filter Hooks). Les hooks d’action vous permettent d’insérer du code à des moments précis pour exécuter des fonctions, tandis que les hooks de filtre vous permettent de modifier les données transmises au cours du processus.

Utiliser des crochets d’action pour ajouter un menu de gestion

Afin que les utilisateurs puissent interagir avec les plugins, il est généralement nécessaire d'ajouter une page de paramétrage dans l'administration de WordPress. Cela peut être réalisé en...add_action()La fonction est montée suradmin_menuCette action est réalisée grâce à un hook.

Lectures recommandées Guide ultime pour le développement de plugins WordPress : Créer votre premier plugin personnalisé à partir de zéro。

Tout d’abord, nous définissons une fonction dans le fichier principal du plugin, destinée à générer le contenu HTML de la page de configuration. Cette fonction peut être nommée…mfp_settings_page_htmlEnsuite, nous créons une autre fonction, par exemple…mfp_add_admin_menuDans lequel WordPress est utilisé.add_menu_page()Une fonction est utilisée pour enregistrer un nouvel élément de menu de niveau supérieur. Enfin, on utilise…add_action('admin_menu', 'mfp_add_admin_menu')Mettez la fonction d’enregistrement en charge dans le système.

Utiliser les hooks des filtres pour modifier le contenu des articles

En plus des fonctionnalités de gestion en arrière-plan, les plugins sont souvent utilisés pour modifier le contenu visible sur le site web (c’est-à-dire le « frontend »). Par exemple, nous pouvons ajouter automatiquement une déclaration de droits d’auteur à la fin de chaque article. Cela nécessite l’utilisation d’un plugin approprié.the_contentCe filtre hook.

Nous définissons une fonction, disons par exemple nommée…mfp_add_copyright_to_contentIl reçoit un paramètre (c’est-à-dire le contenu original de l’article) et ajoute du texte HTML personnalisé à la fin de celui-ci. Ensuite, il…add_filter('the_content', 'mfp_add_copyright_to_content')Enregistrez cette fonction en tant que filtre. Ainsi, chaque fois que WordPress affiche le contenu d’un article, celui-ci sera d’abord traité par notre fonction avant que les informations de copyright ne soient ajoutées et que le contenu ne soit affiché.

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

Sécurité, optimisation et publication des plugins

Développer de nouvelles fonctionnalités est seulement la première étape ; il est tout aussi important de garantir la sécurité et les performances des plugins. Tous les données saisies par les utilisateurs doivent être strictement vérifiées, échappées et nettoyées avant d’être stockées dans la base de données ou affichées sur la page. WordPress met à disposition de nombreuses fonctions de sécurité pour cela.sanitize_text_field()(Lavage du texte)esc_html()(Echappement HTML) etwp_kses()(Les balises HTML spécifiées sont autorisées ; veillez à les utiliser aux endroits appropriés.)

Afin d’améliorer la maintenance et les performances des plugins, il est conseillé de suivre les principes de la programmation orientée objet (POO) pour organiser le code, en encapsulant les fonctionnalités dans des classes. Il est également important d’utiliser de manière judicieuse l’API de cache temporaire (Transients API) de WordPress pour stocker les résultats de requêtes longues ou les données obtenues à partir de sources externes, afin d’éviter de recalculer ces données à chaque chargement de la page.

Lorsque les fonctionnalités de votre plugin seront complètes et qu’il aura passé avec succès les tests, vous pourrez alors envisager sa publication. Vous devrez préparer un document clair et détaillé pour expliquer son fonctionnement, ses avantages, ainsi que les instructions pour son installation et son utilisation.readme.txtLes fichiers doivent respecter les exigences de WordPress.org en termes de format. Ils doivent contenir des informations sur les fonctionnalités du plugin, les méthodes d’installation, les historiques des mises à jour ainsi que des réponses aux questions fréquentes. Si vous souhaitez soumettre votre plugin au répertoire officiel des plugins de WordPress, vous devez créer un répertoire SVN et vous conformer à ses normes de codage ainsi qu’à ses directives de soumission. Pour les plugins commerciaux, il vous sera nécessaire de mettre en place vos propres serveurs de vente et de mise à jour.

Lectures recommandées Maîtriser complètement le développement de plugins WordPress : créer des fonctionnalités personnalisées de A à Z.。

résumés

À travers ce guide, nous avons parcouru les étapes essentielles du développement de plugins pour WordPress : de la mise en place de l’environnement et de la création de la structure de fichiers de base, à l’ajout de fonctionnalités à votre plugin grâce aux actions et aux hooks, en passant par la prise en charge de la sécurité, de l’optimisation et de la préparation à la publication. L’essence du développement de plugins est d’élargir les fonctionnalités de base de WordPress, et le mécanisme des hooks sert de pont entre votre code et le monde de WordPress. Une fois ces bases maîtrisées, vous pourrez explorer de plus complexes API et possibilités en consultant la documentation officielle des plugins ainsi que le code source de WordPress, afin de créer des plugins puissants, sûrs et populaires.

FAQ Foire aux questions

Quels fichiers un plug-in doit-il contenir ?

Le plugin le plus simple peut ne contenir qu’un fichier PHP avec les commentaires d’en-tête corrects. Cependant, à mesure que les fonctionnalités s’complexifient, il inclut généralement plusieurs fichiers PHP, du JavaScript, du CSS, des ressources graphiques, ainsi qu’un…readme.txtFichiers d’explication : Le fichier PHP principal est obligatoire.

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

Comment éviter que mon plugin ne entre en conflit avec d’autres plugins ?

Ajouter un préfixe unique à tous les noms de fonctions, de classes, de constantes et de variables globales est la meilleure pratique pour éviter les conflits de noms. Il est courant d’utiliser des abréviations de plugins ou des noms connus comme préfixes.mfp_Oumy_plugin_De plus, l’encapsulation du code dans des classes permet également d’isoler efficacement les espaces de noms (scopes).

Comment ajouter des options de configuration personnalisables à un plugin ?

Il est recommandé d’utiliser l’API WordPress Settings pour créer des pages de paramètres sûres et standardisées. Celle-ci propose des fonctions permettant de créer des paramètres, d’ajouter des champs et des sections de paramètres, et gère automatiquement l’enregistrement, la validation des données, ainsi que la vérification de l’authentification (nonce). Cela est bien plus pratique que de gérer tout cela manuellement.$_POSTLes données doivent être bien plus sûres et plus faciles à utiliser.

Comment déboguer les erreurs présentes dans un plugin pendant le développement ?

Tout d’abord, assurez-vous que…wp-config.phpLe mode de débogage de WordPress est activé dans le fichier.WP_DEBUGLa constante est définie àtrueDe plus, il est possible d’installer et d’activer des plugins de débogage professionnels tels que Query Monitor, qui vous aident à visualiser les requêtes effectuées sur la base de données, l’exécution des fonctions de hook, les erreurs PHP ainsi que les points de congestion de performance. C’est un outil indispensable pendant le processus de développement.