Créer un plugin WordPress est plus simple que vous ne le pensez
Publié: 2014-06-1025 % de réduction sur les produits Beaver Builder ! Dépêchez-vous que la vente se termine... Apprenez-en davantage !
Jusqu’à il y a quelques années, je n’avais pas écrit un seul plugin WordPress. J'avais créé et personnalisé de nombreux thèmes pour nos clients, mais pour une raison quelconque, je n'arrêtais pas de me dire que créer un plugin dépassait mes capacités.
Avec le recul, je n’aurais pas pu me tromper davantage.
Si vous avez déjà ressenti cela, laissez-moi vous dire quelque chose. Créer un plugin WordPress ne dépasse pas vos capacités. Toute personne possédant suffisamment de compétences pour écrire du PHP de base et modifier un thème peut créer un plugin.
C'est ainsi que j'ai démarré le plugin Beaver Builder ( c'est gratuit donc vous pouvez l'essayer ) et comment vous pouvez également démarrer le vôtre.
Si vous êtes comme moi, vous avez probablement ajouté des fonctionnalités à votre thème au lieu de créer un plugin. Il existe de nombreux cas où cela est acceptable, mais il existe également des cas où il est préférable d'ajouter des fonctionnalités personnalisées à un plugin. Pourquoi pourriez-vous demander ?
Considérez ce scénario.
Vous avez ajouté une fonctionnalité à votre thème qui modifie le gravatar par défaut en votre propre gravatar personnalisé. Le seul problème est que vous venez de changer de thème et maintenant ce n'est plus le cas. Si vous aviez ajouté ce code à un plugin, il serait toujours là lorsque vous décideriez de changer de thème.
Nous avons rencontré ce problème avec le réseau multisite Tabata Times. Ils utilisent une poignée de thèmes qui doivent partager des fonctionnalités personnalisées. Comment pensez-vous que nous avons résolu ce problème ? Vous l'aurez deviné, en ajoutant une bonne partie des fonctionnalités dans un plugin afin qu'elles soient disponibles pour tous les sites du réseau, quel que soit le thème qu'ils utilisent.
Ne vous enfermez pas dans un thème. Utilisez plutôt les plugins #WordPress pour les fonctionnalités. Partager sur XJe ne plaisante pas. Vous pouvez créer un plugin WordPress en cinq étapes simples. Laissez-moi vous montrer comment…
La première chose que vous devrez faire est d'accéder à votre site via FTP en utilisant le programme FTP de votre choix (le mien est Coda). Si vous n'êtes pas familier avec FTP, je vous recommande de le lire avant de continuer.
Une fois que vous avez accédé à votre site via FTP, vous devrez accéder au dossier des plugins WordPress. Ce dossier se trouve presque toujours dans /wp-content/plugins.
Maintenant que vous êtes dans le dossier des plugins, il est temps de créer un dossier pour le vôtre ! Allez-y et créez un nouveau dossier, en lui donnant un nom unique en utilisant des lettres minuscules et des tirets tels que mon-premier-plugin. Une fois que vous avez fait cela, entrez votre nouveau dossier et passez à l'étape suivante.
Ensuite, vous devrez créer le fichier principal de votre plugin. Pour ce faire, créez un fichier PHP dans votre nouveau dossier de plugin et donnez-lui le même nom, par exemple my-first-plugin.php. Après avoir fait cela, ouvrez le fichier principal de votre plugin et préparez-vous à effectuer quelques modifications.
Enfin, copiez et collez les informations du plugin ci-dessous dans votre fichier de plugin principal. Assurez-vous de modifier les détails tels que le nom du plugin et l'URI du plugin car ils se rapportent à votre plugin.
<?php /** * Plugin Name: My First Plugin * Plugin URI: http://www.mywebsite.com/my-first-plugin * Description: The very first plugin that I have ever created. * Version: 1.0 * Author: Your Name * Author URI: http://www.mywebsite.com */
C'est ça! Vous venez de terminer le nombre minimum d'étapes requises pour créer un plugin WordPress. Vous pouvez maintenant l’activer dans l’administrateur WordPress et profiter de toute votre gloire.
À ce stade, vous vous demandez probablement ce que ce plugin est censé faire. Eh bien, ça ne fait rien ! J'ai dit que je vous montrerais comment créer un plugin, je n'ai pas dit que je vous montrerais comment créer un plugin qui fait n'importe quoi.
Blague à part, le but de cet article est d’illustrer à quel point il est simple de commencer à créer des plugins WordPress. Préparez-en un en suivant les étapes décrites ci-dessus et vous êtes prêt à commencer à faire bouger les choses.
Maintenant que vous avez un plugin, faisons-lui faire quelque chose.
Le moyen le plus simple de faire bouger les choses dans WordPress consiste à utiliser des actions et des filtres. Explorons cela en créant une action simple qui ajoute une ligne de texte sous toutes les publications de votre site. Copiez et collez ce code dans votre fichier de plugin principal (sous les informations du plugin) et enregistrez-le.
add_action( 'the_content', 'my_thank_you_text' ); function my_thank_you_text ( $content ) { return $content .= '<p>Thank you for reading!</p>'; }
Ce code s'intègre à l'action « the_content » qui se déclenche lorsque WordPress restitue le contenu de la publication pour votre site. Lorsque cette action se déclenche, WordPress appellera notre fonction « my_thank_you_text » qui est définie sous l'appel « add_action ».
Si vous êtes arrivé jusqu’ici, espérons-le, nous sommes d’accord sur le fait que créer un simple plugin WordPress est relativement facile. Mais que se passe-t-il si vous souhaitez créer un plugin qui fait plus qu’accomplir une tâche simple ?
Si vous envisagez de commencer à coder vos propres plugins, je vous suggère fortement de vous familiariser avec le fonctionnement des actions et des filtres et avec ceux que vous pouvez utiliser. Le Codex WordPress est l'endroit où je passe une grande partie de mon temps, je vous suggère de faire de même.
API du plugin : actions et filtres
API du plugin : référence des actions
API du plugin : référence de filtre
Encore une fois, je passe beaucoup de temps dans le Codex WordPress à lire les fonctions principales pendant que je développe mes plugins. Il y a tellement de fonctions de base que je ne m'attendrais pas à ce que vous sachiez ce qu'est et fait chacune d'entre elles. Après tout, c’est à cela que sert le Codex, alors utilisez-le !
Enfin, si vous finissez par créer un plugin qui fait quelque chose d'intéressant, vous souhaiterez probablement créer une page d'options afin que les personnes qui l'utilisent puissent modifier la fonctionnalité. Créer une page d'options n'est pas nécessaire, il existe de nombreux plugins qui s'installent et font quelque chose sans, mais en avoir une peut être un ajout intéressant pour les utilisateurs de votre plugin.
La création d'une page d'options dépasse le cadre de cet article, donc encore une fois, je vous laisse entre les mains du Codex WordPress.
Écrire un plugin
Création de pages d'options
Créer des plugins WordPress est extrêmement libérateur et constitue un excellent moyen d’acquérir une connaissance plus approfondie du fonctionnement de WordPress. Si vous ne l'avez pas déjà fait, je vous invite fortement à essayer de créer un plugin. Si vous le faites et trouvez parfois quelque chose d'utile, n'oubliez pas que vous pouvez le distribuer librement à d'autres via le répertoire des plugins WordPress.
Avez-vous déjà créé votre premier plugin ou envisagez-vous d'en créer un prochainement ? Si tel est le cas, j’aimerais en entendre parler dans les commentaires ci-dessous !
Un article inspirant et percutant.
Surtout pour moi, comme vous l'avez mentionné comme ayant peur du côté code de WordPress.
J'aime et j'utilise beaucoup WordPress.
Quand il s'agit d'y ajouter des fonctionnalités, je choisis des plugins
Mais comme vous l'avez mentionné, les plugins manquent de fonctions pour répondre à tous mes besoins.
Je me retrouve donc bloqué pour aller plus loin dans mes projets. Parce que je ne peux pas faire les modifications nécessaires aux codes.
J’ai donc vraiment hâte de pouvoir me débrouiller avec le codex de WordPress et de me débrouiller dans les projets.
Merci encore pour le contenu inspirant et motivant.
Bon. Assez bien pour un bon démarrage
Quel bel article ! Que diriez-vous d’un autre sujet sur la conversion d’un modèle HTML en thème WordPress ?
Cela a été incroyablement utile ! Merci
Brise-glace très utile pour les gens comme moi qui avaient la même phobie de regarder « sous le capot » des plugins ! Merci.
Waouh ! Merci beaucoup pour cela, je peux écrire des plugins maintenant. Je me suis toujours demandé comment ces gars-là les écrivent, je n'aurais jamais cru que c'était aussi simple ! Mes doutes ont été dissipés.
J'ai toujours pensé que les thèmes enfants étaient le meilleur moyen de résoudre ce problème, mais hélas, si je change de thème parent, je perds la fonctionnalité. Cela a beaucoup de sens. Merci!
Ouais! Vous m'avez amené à « Je n'ai pas dit que je vous montrerais comment créer un plugin qui fait n'importe quoi. »
Excellent moyen d’enseigner et de maintenir l’engagement de l’utilisateur !
J'ajoute maintenant une interface d'administration à mon plugin… merci beaucoup !
Je pense qu'il vous manque peut-être une balise de fermeture PHP : ?> Merci pour le tutoriel !
Si un fichier ne contient que du code PHP, il est préférable d'omettre la balise de fermeture PHP à la fin du fichier. Cela empêche l'ajout accidentel d'espaces ou de nouvelles lignes après la balise de fermeture PHP, ce qui pourrait provoquer des effets indésirables car PHP démarrera la mise en mémoire tampon de sortie lorsque le programmeur n'a pas l'intention d'envoyer une sortie à ce stade du script.
Intéressant. Les autres tutoriels que j'ai lus incluent la balise de fermeture, donc j'ai simplement supposé que c'était une erreur, mais vous avez tout à fait raison.
Merci
Merci pour ce message pour nous tous, les débutants de WP. Puis-je poser une question idiote : si j'ajoute le code PHP du fichier function.php de mon thème enfant dans le fichier php principal du nouveau plugin, il fera la même chose mais il sera indépendant. du thème, non ? Merci
Après avoir lu très attentivement l’intégralité de votre article, je crée mon premier plugin WordPress. Merci mec d'avoir partagé vos précieuses informations.
Bel article, ce sont des conseils utiles pour moi. Merci pour le partage.
Merci pour cet excellent article qui a renforcé ma confiance dans le toucher du code WordPress et la création de mes propres plugins.
Salut et merci pour l'info
Est-ce add_action ou add_filter dans le code ci-dessus ?
comme je le sais, « the_content » est un filtre et non une action. Donc, au lieu de add_action, vous devriez utiliser add_filter
Excellent article. Mais il y a un petit bug dans le code. Au lieu de add_action, vous devez utiliser add_filter car the_content est un filtre.
Merci beaucoup! très utile
Salut,
J'ai réalisé votre tutoriel et j'ai eu quelques idées concernant la création d'un plugin. Il me semble que c'est vraiment un article sympa pour tous les gars qui serait prolifique pour les débutants. On pourrait en gagner davantage et j'espère que vous m'aiderez.
Excellent! Une approche très simple et pratique pour développer des plugins WP, je l'ai aimé.
Je vais créer un plugin de calculatrice pour mon WP, que je n'ai trouvé nulle part en ligne.
Merci pour le partage
Puis-je utiliser ces étapes pour WordPress 5.3.x ?
Bonjour, merci pour les bases, comme la plupart l'ont dit, mais après avoir parcouru Wordpress, comme suggéré, je ne trouve pas la page « Comment ajouter » une page « Afficher les détails ». Vous savez, combien de personnes l'utilisent, les notes par étoiles, etc. Un lien ou un article sur ce sujet serait bien.
Merci
C'est wow ! Je pensais que créer un plugin me coûterait ciel et terre.
Merci pour l'excellent article
Merci exactement ce dont j'avais besoin !
C'est génial, en tant que personne essayant de décider si je veux me lancer dans le développement de plugins, cela a été vraiment utile.
Aujourd'hui, j'ai construit mon 1er plugin. Merci pour l'inspiration
C'était un article génial ! Je viens de créer un plugin rapide en utilisant le filtre d'utilisation de votre module BB. Waouh !
Je n'ai pas encore créé de plugin, mais je crée régulièrement du contenu personnalisé pour les thèmes. Quand est-il bon d’utiliser un plugin et quand le déconseilleriez-vous ?
Je réfléchis aux éléments de mon thème actuel que je souhaite décomposer en plugins pour faciliter le contrôle de version.
Je ne veux pas avoir une tonne de plugins activés sur le site, mais je cherche également à implémenter des plugins quand cela est intelligent de le faire et je suis intéressé par vos réflexions à ce sujet.
Joli.
Je pensais que créer un plugin WordPress était une tâche très difficile, mais après avoir lu ce blog, mon esprit a totalement changé.
merci.
Article parfait ! J’aime beaucoup votre message simple et parfait. Merci beaucoup pour votre joli partage. Je passerai beaucoup de temps dans le Codex pour apprendre vos conseils. Merci encore
Article tout simplement incroyable. C'est utile pour tous les blogueurs qui utilisent WordPress.
génial et inspirant aussi