WordPress How-To: Les bases du développement de plugins WP

Article écrit par:
  • Conseils sur les blogs
  • Mise à jour: août 12, 2013

Nous allons travailler sur une série d’articles centrés sur «comment faire X avec WordPress“. Ces articles seront un peu longs et ils sont principalement destinés aux webmasters et développeurs expérimentés; dans le cas où vous êtes nouveau sur WordPress, consultez mon Guide de votre premier blog WordPress.

Et maintenant, quelques notions de base.

Développer les fonctionnalités de WordPress en développant un nouveau plugin

WordPress Page d'accueil

WordPress est la plate-forme de gestion de contenu la plus populaire au monde. 60 compte plus d'un million d'utilisateurs de son paquet d'installation PHP auto-hébergé et des millions d'autres utilisateurs du service Web WordPress.com hébergé à distance. Ce n'est pas une coïncidence ou une erreur. WordPress est tout simplement l'application de gestion de contenu la plus complète, la plus abordable, la plus facilement utilisable au monde. Cependant, même ce titan de gestion de contenu n'est pas absolument parfait, et de nombreux utilisateurs trouvent finalement que le logiciel manque d'une ou deux fonctions essentielles sans lesquelles ils ne peuvent tout simplement pas vivre.

Entrer WordPress plugins.

Ces utilisateurs non satisfaits iront ensuite dans une quête, une recherche volumineuse, dans le but de trouver le bon plugin pour faire le travail. Certaines personnes trouvent ce plug-in nécessaire, MAIS beaucoup d'autres ne trouvent tout simplement pas ce qu'elles cherchent.

Certains utilisateurs de WordPress pourraient se contenter de simplement abandonner le combat et de se résigner à une vie où une caractéristique essentielle manque à leur site Web. Mais un groupe important de ces utilisateurs n'est tout simplement pas disposé à jeter l'éponge, et ils poursuivront le processus de conception de leur propre plugin sur mesure pour faire le travail. Cela peut sembler compliqué et intimidant, et certaines parties peuvent être. Certainement, solide connaissance du PHP sera nécessaire pour les plugins plus avancés qui ajoutent des fonctionnalités réelles à la fonctionnalité WordPress. Mais un plugin est une chose relativement facile à écrire, en particulier pour les fonctions de base qui sont standard dans WordPress et qui doivent simplement être «retravaillées» afin de mieux faire le travail et de le présenter de manière plus agréable.

Les utilisateurs qui ne veulent pas se contenter de la deuxième place et qui envisagent de créer leur propre plug-in n'ont qu'à suivre les étapes simples ci-dessous pour placer leur installation WordPress sur la voie d'une plus grande fonctionnalité et d'une compatibilité accrue avec leurs grandes idées et leurs grands projets de domination Internet. .

Étape 1: Créer un nouveau fichier dans le répertoire du plugin et lui donner un objectif

WP Plugins

La première étape pour créer un plugin consiste simplement à créer un nouveau fichier de plugin PHP dans le répertoire de plugins WordPress existant.

À l'heure actuelle, la plupart des utilisateurs doivent savoir où localiser ce répertoire car ils ont probablement téléchargé une poignée de plugins pour améliorer les fonctionnalités de leurs installations WordPress. Cependant, pour ceux qui abordent réellement ce processus en tant que novice complet, le répertoire contenant tous les fichiers pug est situé à l'emplacement suivant pour chaque version et chaque itération du logiciel WordPress:

/ public_html / wp-content / plugins /

Naviguez vers ce répertoire et créez un nouveau fichier (vide, à ce stade) nommé «my-custom-plugin.php.». Ce fichier contient tout notre travail, du début à la fin, et nous lui donnerons une nom évident car il n’est pas accidentellement supprimé ou activé prématurément au cours du processus de développement. Une fois ce fichier créé et chargé sur le serveur, utilisez un client FTP pour éditer directement ce fichier (à l'aide d'un éditeur de texte intégré) tant qu'il est toujours hébergé sur le serveur. C’est le meilleur moyen de modifier des fichiers distants, car il permet de sauvegarder et de télécharger des fichiers de manière essentiellement automatique et certainement plus facile que de gérer plusieurs versions du même fichier stockées dans des emplacements différents.

Le plugin va maintenant être nommé, décrit et se voit attribuer un «byline». Il s’agit du même type d’informations placé en haut de la feuille de style «style.css» du thème. Les développeurs de thèmes se sentiront comme à la maison en remplissant les informations ci-dessous. Placez cette information en haut du fichier du plugin avant tout autre code. Même la balise PHP d'ouverture ne doit pas être placée avant ces lignes commentées. Si ces lignes sont mal placées ou sont entièrement omises, le plugin lui-même n'apparaîtra pas dans le tableau de bord WordPress. Cela signifie qu'il ne peut pas être activé, utilisé, testé ou mis au point, et ce n'est pas bon. Voici ce qu'il faut remplir avant d'ouvrir le fichier et de définir une fonction:

/*
Nom du plugin: Un plugin personnalisé utilisé pour apprendre les méthodes de WordPress
Plugin URI: http://www.your-website-here.com
Description: Ce plugin est utilisé pour montrer comment le code PHP, les variables WordPress, XHTML, CSS et autres informations sont placés dans un fichier PHP de plugin standard pour ajouter de nouvelles fonctionnalités à une installation WordPress standard.
Auteur: Votre nom ici
Version: 1.0
URI de l'auteur: http://www.your-website-here.com
*/

Une fois ces informations complétées, le plugin sera maintenant repéré par le tableau de bord WordPress et ses informations s'afficheront correctement aux côtés des autres plug-ins du panneau d'administration Activation / Suppression du plug-in. Le plugin a maintenant reçu un nom de fichier, un nom convivial et un objectif. Il ne manque plus que quelques fonctions. C'est là qu'intervient l'étape deux.

WP Plugins

Étape 2: Définir une fonction (ou des fonctions) de plug-in à utiliser sur un site Web WordPress

Cette démonstration du plugin supposera que le développeur a créé un champ personnalisé. Ce champ sera utilisé pour déterminer si des liens de médias sociaux sont inclus ou non dans la publication afin que les utilisateurs puissent partager la publication avec leurs amis et les membres de leur famille abonnés à leurs mises à jour de réseau social sur des sites tels que Twitter, Facebook, LinkedIn et MySpace. . Un champ personnalisé a été créé, dans ce cas, nommé «liens_sociaux».

En utilisant le code PHP dans le plugin, nous déterminerons si le champ de réseautage social contient des données. Si tel est le cas, une “barre” de liens de partage de médias sociaux sera affichée. S'il ne contient aucune donnée, ces liens seront omis. C’est un excellent moyen de désactiver le partage de messages sur votre site Web qui ne sont tout simplement pas destinés à être visionnés par le grand public, et le faire dans un plugin est un excellent moyen de garantir que cette fonctionnalité s’applique à tous les thèmes, modèle d'entrée d'un thème.

Ce processus est accompli en «ajoutant» une action au code WordPress. Pour ce faire, utilisez la commande PHP «add_action», garnie de plusieurs instructions «echo» et de la lentille existante du code WordPress pouvant être importée directement à partir de fichiers modèles WordPress existants. N'oubliez pas que pratiquement toute variable pouvant être utilisée dans un modèle est également valable pour l'inclusion dans un fichier de plug-in, bien que les balises PHP d'ouverture et de fermeture doivent être omises, car le code est déjà encapsulé dans une seule et même enveloppe entourant les balises PHP. .

Voici à quoi ressemble «l'action» ajoutée dans le fichier de plugin lorsqu'il est complètement rempli:

fonction liens_sociaux ($ post_ID) {
global $ wp_query;
$ ID = $ wp_query-> post-> ID;
if (get_post_meta (13); == 1)
{
retourne $ post_ID. «Boutons de lien de réseautage social»;
}
d'autre
{
retourne $ post_ID. “”;
}
}
add_action ('the_content', 'liens_sociaux');

Les premières lignes de code servent simplement à déterminer si des informations «méta» ont été renseignées dans le tableau de bord WordPress pour l'entrée en cours de visualisation. Ceci est effectué en interrogeant la base de données WordPress (à l'aide de la variable $ wp_query) et en recherchant des informations dans le champ méta numéro 13. Une identification numérique est attribuée à chaque champ personnalisé, tout comme les entrées, les commentaires et les pages. Ce nombre peut être utilisé dans les variables pour les instructions conditionnelles.

Ainsi, le plug-in commence par examiner le champ personnalisé de chaque entrée et voir si le contenu est présent ou non dans la table de base de données du champ. Ensuite, il passe par le conditionnel. Si le contenu est égal à «1», il continue. Dans ce cas, l’utilisation de «1» signifie «si le champ contient des données». L’inverse de cela serait «0», ce qui se traduirait par «si le champ ne contient aucune donnée». Ainsi, si le champ contient des données. , ou est égal à «1», la fonction passe à la première partie du conditionnel. Cette section fournit l’affichage de liens de partage de médias sociaux. Par souci de brièveté, ces liens n'ont pas été inclus avec la fonction. Cependant, ils peuvent faire semblant d'utiliser du XHTML simple dans les guillemets qui suivent l'instruction «return $ post_ID».

Si des données ne sont pas présentes dans le champ personnalisé, il est effectivement égal à «0» en ce qui concerne le code de ce plugin. Cependant, comme cette condition est une déclaration soit /, au lieu d'une déclaration avec de nombreux résultats différents, nous utilisons simplement la construction "else" pour indiquer au plug-in d'imprimer le contenu alternatif dans d'autres circonstances. Dans ce cas, il n’imprime simplement rien. Pour cette raison, tout ce qui doit être placé dans la fonction est:

retourne $ post_ID “”

Au bas de la déclaration, nous ajoutons notre nouvelle fonction en tant qu '«action» à la variable PHP existante «the_content». Cela ajoutera les boutons de partage de réseau social au bas d'une entrée directement après l'impression du contenu de l'entrée. Les déclarations entre parenthèses sont chronologiques, ce qui signifie que la nouvelle action («liens_sociaux») pourrait être placée avant «the_content» si ces boutons étaient censés être affichés au début du contenu, directement après que le titre de l'entrée ait été imprimé sur le contenu. écran.

Lorsque la fonction est terminée et que l'action est ajoutée à la boucle WordPress directement après que le corps principal du contenu de l'entrée a été imprimé sur la page, le plug-in est essentiellement terminé. C'est le moment opportun pour ajouter la balise PHP de fermeture, enregistrer le fichier et le télécharger sur le serveur pour utilisation.

Étape 3: Activer le plugin et l'essayer

La partie la plus importante du processus consiste à activer le plug-in et à vérifier que ses fonctions fonctionnent comme prévu et ne causent pas de problèmes avec les plug-ins existants ni avec les fonctionnalités WordPress standard. C’est également le bon moment pour vérifier l’intégrité du code PHP et vous assurer que toute sortie (XHTML ou autre) s’imprime comme vous le souhaitez.

Si des erreurs se produisent pendant le processus d'activation et de test, il est important de vérifier le fichier de plug-in et de s'assurer que toutes les instructions sont correctement ouvertes et fermées. Cela implique de vérifier la ponctuation, dans de nombreux cas, y compris les parenthèses, les points-virgules, les crochets et les lettres minuscules. N'oubliez pas que PHP est sensible à la casse, et qu'il est également sensible à la ponctuation: toute instruction non fermée continue essentiellement à l'infini et peut empêcher le chargement des pages, ou le chargement extrêmement lent.

Lorsque tous les problèmes ont été résolus, le travail est en grande partie terminé. Cependant, vous devez prendre en compte quelques considérations supplémentaires pour les autres scénarios.

Étape 4: Création d'un fichier Lisez-moi du plugin

Créer un plugin WordPress

Si le plug-in est destiné à un usage privé uniquement, il n'y a aucune raison de créer un fichier «Lisez-moi» sauf si, bien entendu, vous craignez d'oublier ce qu'il fait, comment il a été construit ou comment il fonctionne au sein de celui-ci. la boucle WordPress elle-même. Cependant, de nombreux développeurs créent des plugins dans l’intention de les distribuer à la communauté WordPress au sens large et, avec plus d’un million d’utilisateurs, il s’agit d’une manière lucrative de promouvoir un site Web et de gagner un revenu secondaire.

Ces utilisateurs sont pratiquement obligés de créer un document Lisez-moi qui décrit les fonctions du plug-in, explique comment installer le fichier sur le serveur et comment le configurer et personnaliser ses fonctions. Ce fichier peut également contenir des informations telles que le journal des modifications, qui détaillent chaque modification et mise à jour apportées au plug-in au fil du temps. Cependant, l'important est d'expliquer ce que fait le plugin, comment il fonctionne et comment l'installer. Les utilisateurs novices ne sauront pas quoi faire s'ils ne sont pas guidés tout au long du processus, tout comme les développeurs de plugins novices ne savaient pas comment créer une nouvelle fonction WordPress jusqu'à la dernière étape de ce guide.

Lorsque le fichier de plug-in est terminé et associé à un fichier Lisez-moi (généralement un fichier .txt), il est temps de placer les deux documents dans leur propre dossier et de les compresser à l'aide du format de fichier ZIP standard. Le plugin peut ensuite être chargé dans la communauté de plugins et de thèmes WordPress Extend, ainsi que sur le serveur du développeur pour une solution auto-hébergée.

Relativement facile à faire, en particulier avec les variables et les fonctions de WordPress

Le grand avantage de développer un nouveau plugin pour WordPress est que le fichier peut utiliser n’importe quelle fonction, variable ou boucle PHP existante, que WordPress a déjà définie et initialisée. Cela facilite l'extension des fonctionnalités de WordPress et leur utilisation sur de nombreux thèmes, et rend le processus de développement du plugin aussi simple que de créer un nouveau thème pour le logiciel lui-même.

Rappelez-vous toujours de tester les bugs, les erreurs de validation et les conflits de fonctions avant de mettre le plugin en utilisation active ou de le partager avec la communauté WordPress plus large. Lorsque ce processus est terminé et que le plug-in fonctionne correctement, la phase de développement est terminée et vous serez libre de profiter du succès et des nouvelles fonctionnalités que vous venez de créer. ;)

Lectures supplémentaires sur le RSH

Pour creuser plus à ce sujet, consultez La liste de Jerry des plugins WordPress 20 Essential, 25 Handy Code Snippets Pour les développeurs WordPress, WordPress les plus recherchés, astuces et astuces; et, si vous recherchez un bon hébergement WordPress, vérifiez ce que j’utilise depuis peu - Moteur WP - c'est un hôte assez cher (donc pas recommandé aux débutants) mais vous en avez pour votre argent.

À propos de Jerry Low

Fondateur de WebHostingSecretRevealed.net (WHSR) - une critique d'hébergement approuvée et utilisée par les utilisateurs de 100,000. Plus de 15 ans d'expérience dans l'hébergement web, le marketing d'affiliation et le référencement. Contributeur à ProBlogger.net, Business.com, SocialMediaToday.com, et plus encore.