Créer un plugin Random Quote pour WordPress

Il y a quelques années, je commençais vraiment à développer des plugins pour WordPress lorsque je suis tombé sur un petit exercice exceptionnel qui m'a appris beaucoup de bases sur la création de plugins. J'ai commencé avec cette idée très simple: créer un petit plugin pratique qui génère une citation au hasard pour la description du thème actuel. Aujourd'hui, je vais revenir sur le plugin qui m'a vraiment aidé à me mouiller les pieds en vous expliquant comment le faire vous-même..

Les connaissances minimales requises pour ce tutoriel ne sont que quelques connaissances de base de PHP (elles sont destinées aux débutants qui souhaitent se lancer dans le développement de plugins).. La mission pour cette leçon: créer un plugin qui générera un devis de manière aléatoire à chaque rechargement de la page. Lorsque le plugin est activé dans la section Plugins, il fonctionnera de manière silencieuse. Il ne crée aucune ressource, nous n'avons donc pas besoin de la procédure de désinstallation..


Étape 1 Données de base du plugin

Les lignes de code suivantes sont essentiellement ce qui indique à WordPress que ce que vous construisez est un "plugin". WordPress a simplement besoin du nom du plugin. L'ordre des lignes n'est pas important, mais vous remarquerez beaucoup de similitudes dans cet "en-tête" si vous avez déjà créé un modèle de page ou un thème..

Le fichier doit être dans UTF-8 codage.

 / * Nom du plugin: Citation aléatoire d'Adam Version: 0.1 URI du plugin: http://burucs.com Description: remplace la description du site par une citation aléatoire Auteur: Adam Burucs URI de l'auteur: http://burucs.com * /

Étape 2 La fonction générateur

Notre premier morceau de code fonctionnel est la fonction de générateur. Il consiste en un tableau local unidimensionnel, rempli des différentes citations et à la fin de la routine, nous sélectionnons une citation de manière aléatoire. Nous utilisons le PHP intégré rand Pour cette fonction, notez que les valeurs de début et de fin sont incluses dans la plage générée..

Selon les normes de codage WordPress détaillées, nous devrions utiliser la convention de dénomination par défaut suivante: deux monogrammes minuscules de l'auteur et l'abréviation du nom du plugin..

 function ab_arq_generate () $ quotes = array ('Le silence est d'or.', 'Rien à quoi ça ressemble.', 'Rendez tout juste!', 'Mieux vaut tard que jamais.', 'Voir c'est croire.'); return $ quotes [rand (0, count ($ quotes) -1)]; 

Étape 3 Fonction qui remplace la description par défaut par la citation

Dans cette section, nous utilisons une fonction d’aide qui utilise la procédure principale écrite précédemment..

 fonction ab_arq_change_bloginfo ($ text, $ show) if ('description' == $ show) $ text = ab_arq_generate ();  return $ text; 

Étape 4 Utilisez le système de filtrage

Le système de filtrage est un concept important dans le monde monumental de WordPress. Les filtres sont les fonctions auxquelles votre plugin peut s’attacher pour modifier les données. Dans notre cas, avec ce grand potentiel, nous remplaçons la description par défaut du thème actuel. En cours, nous devons utiliser la fonction bloginfo.

 add_filter ('bloginfo', 'ab_arq_change_bloginfo', 10, 2);

Étape 5 Code final

Voici le produit final de ce que nous avons fait dans cette leçon facile.

 / * Nom du plugin: Citation aléatoire d'Adam Version: 0.1 URI du plugin: http://burucs.com Description: remplace la description du site par une citation aléatoire Auteur: Adam Burucs URI de l'auteur: http://burucs.com * / function ab_arq_generate ( ) $ quotes = array ('Le silence est d'or.', 'Rien à quoi ça ressemble.', 'Faites tout bien!', 'Mieux vaut tard que jamais.', 'Voir c'est croire.'); return $ quotes [rand (0, count ($ quotes) -1)];  function ab_arq_change_bloginfo ($ text, $ show) if ('description' == $ show) $ text = ab_arq_generate ();  return $ text;  add_filter ('bloginfo', 'ab_arq_change_bloginfo', 10, 2);

Étape 6 Bonus Astuce

Jusqu'à présent, je vous ai montré les bases de la création de ce plugin, mais vous pouvez l'étendre de plusieurs façons si vous le souhaitez. Par exemple: Et si nous devons traiter plus de citations? Nous pouvons choisir parmi plusieurs options. Premièrement: nous pourrions créer un fichier php supplémentaire avec le tableau à inclure dans le plugin. Deuxièmement: utiliser une table de base de données dédiée. Troisièmement: récupérer les données d'un serveur distant (quelques possibilités supplémentaires à développer).

Notez que si vous choisissez de créer la version dédiée de la table, vous devez créer une bonne fonction de désinstallation distincte dans votre plugin.!

Comme aujourd’hui, nous voulions seulement couvrir les bases, je vais m’arrêter ici et vous diriger vers un autre excellent article de Tom McFarlin intitulé «Introduction au développement de plug-in»..