Dans la première partie de la série drsquoarticles sur la création de plug ins, nous commençons par quelques informations de base sur les plug ins, donc nous avons mis un exemple très simple de Hello World pour montrer que tout le monde peut créer un plug in de travail. Un lecteur attentif a peut être remarqué que la façon dont nous avons créé le plug in à lrsquoorigine était un peu grossière. Nous voulons juste voir quelque chose à lrsquoécran, et nous ne sommes pas trop préoccupés par ce qui se passe dans les coulisses. Cette fois, nous allons organiser plus de choses, en utilisant un kit pratique appelé modèle de plug in wordpress pour garder les choses normales dès le début. Nous lrsquoutiliserons pour exécuter les éléments de base du projet, puis nous effectuerons quelques étapes exploratoires dans les fichiers qursquoil génère.
Avant de commencer, examinons brièvement les raisons de cette approche. Comme Daniel Pataki l’a souligné dans son excellent modèle de plugin wordpress 101, Lorsque assemblez un plug in, il y a beaucoup d’espace de défilement: « la façon dont nous les avons écrits n’a pas beaucoup changé depuis que les plug ins WordPress ont été lancés il y a 10 ans. Il y a un fichier principal de plug in qui est essentiellement Wild West derrière son titre. Il n’y a pas de méthode normalisée pour créer des plug ins sauf en utilisant des crochets.
Ce nrsquoest pas forcément un problème. Il existe de nombreux plug ins simples qui nrsquoont pas besoin drsquoun cadre de gouvernance, et drsquoautres qui peuvent écrire un code de processus entièrement cohérent. Crsquoest à dire que la qualité du Code dans les plug ins nrsquoest généralement pas la meilleure et qursquoun cadre ou une méthode peut grandement lrsquoaméliorer », a déclaré Daniel Pataki. Le manuel officiel des plug ins nous fournit un bon point de départ à bien des égards et fournit une documentation fiable sur Les meilleures pratiques des plug ins.
Mais il nrsquoest pas nécessaire de faire les choses bien dès le début.
Les modèles de plug in WordPress nous aideront à rester cohérents. Avec des cadres comme les modèles de plug in WordPress, nous obtenons immédiatement deux choses: une structure soigneusement construite qui combine les meilleures pratiques en matière de normes de codage et nous guide vers un départ solide dans l’ensemble. Crsquoest un environnement drsquoapprentissage utile qui nous permet de naviguer facilement sans avoir à redessiner la roue. Crsquoest là que voulez commencer dans le contexte du premier développement du plug in. Passons à lrsquoinstallation réelle du cadre.
Le plug in Boilerplate WordPress le plug in Boilerplate WordPress s’adresse principalement aux développeurs intermédiaires, mais il peut aussi servir d’outil de formation pour les débutants. Les utilisateurs plus avancés voudront peut être commencer par le dépôt github officiel du projet, mais nous essayons de rendre les choses plus faciles à glisser et à déposer, donc nous allons adopter une autre approche. Il y a un générateur en ligne pratique qui nous permet drsquoéviter de nombreux correctifs manuels simplement en entrant quelques détails et en téléchargeant les fichiers générés dans le Répertoire local. Notre premier point de référence est WordPress plug in Template Builder.
WordPress plug in Template Builder nous permet d’économiser quelques étapes. Comme pouvez le voir dans la capture drsquoécran ci dessus, nous nrsquoavons qursquoà envoyer quelques détails de base pour générer un paquet téléchargeable prêt à répondre à nos besoins. Tout ce que nous avons à faire maintenant est de décompresser le fichier généré et de le déplacer dans le dossier WP content plugins de votre installation WordPress locale. Dans cet exemple, nous avons créé un site Web appelé www.randomquote. Dev, configuration rapide en utilisant desktopserver Magic. A.
Nous utilisons une série de citations RDM pour appeler le plug in mes citations aléatoires.
Il suffit de décompresser le dossier et de le faire glisser dans le répertoire plugins pour lrsquoinstaller. nous parcourons maintenant le plug in à lrsquoarrière plan du site local, nous verrons que notre futur plug in de devis aléatoires a été créé par magie: L’apparence initiale du plugin à l’arrière de WordPress. Bien sûr, il reste encore beaucoup à faire dans les coulisses. Commençons par regarder sous le capot pour voir ce que nous avons obtenu gratuitement dans les fichiers et dossiers que nous venons de . Lorsque nous regardons le dossier plugins My RDM quotes localement, il est clair que nous commençons par un dossier plus structuré qursquoauparavant.
Notre dossier par défaut a évidemment une certaine structure. Les quatre premiers dossiers de haut niveau sont mis en évidence. Ces capacités offrent un moyen utile et immédiat de séparer les préoccupations: Administrateur: Comme y attendiez à partir du nom, tout le Code administrateur sera ici. Cliquez à lrsquointérieur et verrez les dossiers que avez créés pour héberger CSS et JavaScript. Inclure: ce dossier contiendra la plupart des fonctionnalités utilisées pour configurer et supprimer les plug ins. Par défaut, il contient de nombreux fichiers utiles. On va vérifier tout de suite. Langue: ce dossier contient un fichier. Le pot par défaut permet une internationalisation complète. Public: Crsquoest là que les fonctionnalités destinées aux utilisateurs publics doivent être hébergées. De même, si naviguez à lrsquointérieur, remarquerez les dossiers CSS et Javascript existants. Maintenant que nous avons une vue drsquoensemble de lrsquoaménagement du territoire, choisissons quelques documents clés à noter dès le début.
Vérifier certains fichiers de plug in Chia
On prend les choses drsquoen haut. Dans le répertoire Home du dossier plug in, éditez deux fichiers Home: README. Txt: Ouvrez le dans un éditeur de texte et verrez un fichier modèle pratique qui aidera à organiser le fichier README parfait quand le moment est venu. Nom du plug in. PHP: dans notre cas, crsquoest ma référence RDM. Php. Crsquoest là que se trouve le plug in. ouvrez le fichier et faites défiler un peu vers le bas, verrez qursquoil enregistre également les crochets importants pour activer et désactiver les plug ins, et inclut nos classes de plug ins primaires. Ici, nous pouvons voir le titre du plug in et quelques paramètres en cours, ainsi que les options drsquoactivation et de désactivation. Faites défiler mon fichier de devis RDM. Il est évident qursquoil y a beaucoup drsquoéléments importants dans le dossier include qui peuvent être directement référencés, alors regardons les principaux éléments:
Les fichiers par défaut que nous obtenons dans le dossier incluent. Comme le montre la figure ci dessus, nous traitons immédiatement cinq fichiers clés prédéfinis, chacun définissant sa propre classe. Chaque plug in contiendra le nom du plug in (dans notre exemple, mes guillemets RDM) dans le nom de fichier: class plugin name activator. PHP: Crsquoest là que devez isoler ce qui se passe lorsque le plug in est actif. Désactivateur de nom de plug in de classe. PHP: ici, pouvez nettoyer lorsque désactivez le plug in. Classe plugin name i18n. PHP: Crsquoest là que les capacités drsquointernationalisation seront gérées. Chargeur de nom de plug in de classe. PHP: il srsquoagit drsquoun fichier clé, mais ne pouvez peut être pas le manipuler trop directement. Crsquoest un outil pour gérer les actions et les enregistrements de filtres définis par les crochets de fond du plug in. Nom du plug in de classe. PHP: Crsquoest là que la plupart des opérations se produisent. Le principal point à noter ici est que cette classe fournit deux méthodes, chacune pour la gestion
Construire le plugin wordpress partie 2: un bon départ