Anfänger der WordPress -Plugin -Entwicklung: Verwenden Sie WordPress Plugin -Kessel
WordPress-Plug-In-Entwicklung verfügt über eine niedrige Lernkurve und es gibt keine einzige Möglichkeit, Plug-Ins zu erstellen. Plugins können so einfach sein wie Hello Dolly, nur eine einzige Datei. Die WordPress-Plugin-Kesselplatte ist so konzipiert, dass Sie eine standardisierte, qualitativ hochwertige Grundlage bieten, mit der Sie Ihr nächstes großartiges Plugin erstellen können. Im ersten Teil dieser Serie werden wir die Tiefe der Boilerplate, einschließlich der Struktur von Dateien und Ordnern sowie die Codeorganisation der Boilerplate, untersuchen.
Schlüsselpunkte
Hintergrund
Die WordPress-Plugin-Kesselplatte wurde ursprünglich von Tom McFarlin initiiert, um einen standardisierten objektorientierten Ansatz zum Erstellen von WordPress-Plugins bereitzustellen. Da die Boilerplate auf der Plug-in-API aufgebaut ist und den von WordPress empfohlenen Codierungs- und Dokumentationsstandards folgt, können Sie sicher sein, dass Sie sich in einer sicheren und zuverlässigen Umgebung befinden. Die Boilerplate wurde kürzlich auf Version 3.0.0 aktualisiert, wodurch erhebliche Verbesserungen der Codeorganisation und die weitere Trennung des internen Fokus von Plugins erhöht werden. Wenn Sie bereits mit der Entwicklung von Plugins mit Legacy -Boilerplate (V2.6.2) vertraut sind, kann es einige Zeit dauern, was in der neuesten Version neu ist, einschließlich der neuen Ordnerstruktur. Diese Kesselplatte wird nicht mehr von Tom McFarlin selbst (zum Zeitpunkt des Schreibens) aufrechterhalten, und er hat den Stab an Devin Vinson weitergegeben. Die Entwicklung dauert immer noch wie geplant. Melden Sie sie also in Ihrem Github -Repository, wenn Sie Fragen haben. Wir begrüßen auch Ihren Beitrag.
Holen Sie sich eine Vorlagenkopie
Der einfachste Weg, um eine Kesselkopie des WordPress -Plugins zu erhalten, besteht darin, das Git -Repository selbst zu klonen.
<code>git clone https://github.com/DevinVinson/WordPress-Plugin-Boilerplate.git</code>
Oder Sie können ZIP -Dateien jederzeit aus Ihrem GitHub -Repository herunterladen. Da Version 3.0.0 veröffentlicht wird, können Sie das Plugin nicht einfach direkt in Ihr WP-In-Content/Plugins-Verzeichnis kopieren. Dies liegt daran, dass der tatsächliche Quellcode des Plugins nicht im Root -Verzeichnis enthalten ist, sondern sich tatsächlich in einem Unterverzeichnis namens Trunk befindet. Mach dir jetzt keine Sorgen, wir werden die neue Ordnerstruktur später in diesem Artikel diskutieren. Die Datei ReadMe.md beschreibt eine vollständige Beschreibung der ordnungsgemäßen Installation der Boilerplate. Kurz gesagt, Sie können:
Nachdem Sie dies getan haben, sollten Sie jetzt ein Plugin namens WordPress Plugin -Boilerplate in der Liste der Plugins im Administratorfeld finden, vorausgesetzt, Sie haben keine Änderungen an der Boilerplate selbst vorgenommen. Aktivieren Sie einfach das Plugin und beginnen Sie!
Passen Sie das Plug-In mit dem Online-Generator
an Wenn Sie aktiviert sind, haben Sie ein "normales" Plugin, das im Grunde genommen nichts tut - zumindest vorerst. Sie müssen auch die Suche und ersetzen Vorgänge auf der gesamten Boilerplate-Code-Basis ausführen, die sehr mühsam und zeitaufwändig sein können. Glücklicherweise hat Enrique Chavez einen inoffiziellen Generator erstellt, der den Prozess automatisiert. Besuchen Sie einfach https://www.php.cn/link/6340831392e9cd8af9598274f4b3c5c0
und füllen Sie das Formular am unteren Teil der Seite aus, um eine personalisierte Kopie des Wordpress -Plugin -Tabors zu generieren.Ordnerstruktur
Schauen wir uns genauer an, wie WordPress -Plugin -Boilerplate 3.0.0 im Vergleich zu älteren Versionen organisiert ist. Wie bereits erwähnt, ist der tatsächliche Plugin -Code in einem Unterverzeichnis namens Trunk und nicht im Stammverzeichnis enthalten. Dies soll den Standards folgen, die im offiziellen WordPress -Plugin -Repository verwendet werden, das drei Hauptverzeichnisse enthält: Vermögenswerte, Zweige und Kofferraum. Die Kesselplatte liefert bereits zwei davon: Vermögen und Kofferraum. Hier sind die vollständigen Verzeichnisse und Dateien, die in der Boilerplate enthalten sind (zum Zeitpunkt des Schreibens):
<code>git clone https://github.com/DevinVinson/WordPress-Plugin-Boilerplate.git</code>
Folgendes ist eine kurze Beschreibung der Funktionen jeder Datei und des Ordners:
.gitignore
: Bietet einen angemessenen Standard .gitignore
für die meisten Inhalte, die im Git -Repository nicht vorhanden sind. CHANGELOG.md
: Standardänderungsprotokoll für Kesselplattenänderungen, einschließlich des Änderungsdatums. README.md
: Ein nützlicher Starter mit den aufgeführten Installationsanweisungen sowie einige andere Teile wie Werkzeugempfehlungen und Bestätigungen. assets
: Dieses Verzeichnis enthält empfohlene Ressourcen, die Sie bereitstellen müssen, wenn Sie das Plugin im WordPress -Plugin -Repository veröffentlichen. Alle in diesem Verzeichnis enthaltenen Bilder sind die empfohlene Beschluss zur Veröffentlichung. trunk
: Dies ist das eigentliche Plugin, das Sie entwickeln werden. Es gibt einige Ordner, die die Codebasis in administrative und öffentlich ausgerichtete Funktionen unterteilen. Wir werden ausführlich erklären, was jedes Unterverzeichnis bedeutet. admin
: Das Verzeichnis enthält drei Verzeichnisse, nämlich admin
, css
und js
. Wie der Name schon sagt, sollten hier alle verwaltungsorientierten Funktionen platziert werden. Standardmäßig werden partials
und plugin-name-admin.js
Ihrem WP-Admin hinzuzufügen. plugin-name-admin.css
bietet gemeinsame Funktionen, bei denen Sie verwaltungsspezifische Hooks definieren können. class-plugin-name-admin.php
public
sehr ähnlich. Der einzige Unterschied besteht darin, dass das Verzeichnis admin
verwendet wird, um alle öffentlich ausgerichteten Funktionscode-Grundlagen zu speichern. public
languages
.pot
includes
LICENSE.txt
README.txt
plugin-name.php
in dieser Datei ebenfalls registriert. register_activation_hook
register_deactivation_hook
Wie bereits erwähnt, gibt es im Verzeichnis
fünf Standardklassen. Mal sehen, was jede Klasse tut:class-plugin-name-activator.php
: Diese Klasse wird während der Plug-in-Aktivierung instanziiert. Es hat nur eine statische Methode activate()
, die bei register_activation_hook
registriert ist. Verwenden Sie diese Klasse, wenn Sie bestimmte Aktionen ausführen müssen, wenn das Plugin aktiviert ist, z. B. das Erstellen einer benutzerdefinierten Tabelle oder das Speichern von Standardoptionen. class-plugin-name-deactivator.php
: Die entsprechende Kategorie von class-plugin-name-deactivator.php
. Es hat auch nur eine statische Methode deactivate()
, mit der während der Plugin -Deaktivierung eine beliebige Funktion ausgeführt werden kann. class-plugin-name-i18n.php
: Der Ausgangspunkt der Plug-in I18N-Funktion. Es verfügt über eine Eigenschaft $domain
, die Plugin -Textfelder gespeichert hat. Diese Eigenschaft kann mithilfe der öffentlichen Methode set_domain()
festgelegt werden. Schließlich wird die load_plugin_textdomain()
-Methode in dieser Klasse aufgerufen, wenn das Plugin geladen ist. class-plugin-name-loader.php
: Die wichtigste Klasse in der Vorlage. Es enthält zwei Eigenschaften $actions
und $filters
, wobei alle im Plugin registrierten Hooks gespeichert werden. Es bietet zwei einfache Wrapper -Funktionen add_action()
und add_filter()
zum Hinzufügen einer Aktion oder zum Filter zu den Eigenschaften $actions
und $filters
. Dies ist nicht mit WordPress -Standardfunktionen von WordPress zu verwechseln, da diese Klassen sie nicht direkt registrieren. Alle Hooks werden nur während einer anderen Methode als add_action()
registriert. add_filter()
run()
class-plugin-name.php
-Methode festgelegt. Alle zuvor registrierten Verwaltungs- und öffentlichen Haken können auch hier definiert werden. Diese Klasse bietet auch einfache GET -Methoden wie load_dependencies()
, um den Plugin -Namen zurückzugeben, set_locale()
, um die aktuelle Plugin -Version zurückzugeben, und get_plugin_name()
, um die Instanz von get_version()
zu erhalten. get_loader()
class-plugin-name-loader.php
Kurz gesagt, WordPress -Plugin -Boilerplate bietet einen großartigen Ausgangspunkt für Plugin -Entwickler. Es folgt den empfohlenen WordPress -Codierungsstandards sowie den WordPress -Dokumentationsstandards, sodass Sie von Anfang an auf dem richtigen Weg sind. Darüber hinaus wird das Veröffentlichen eines WordPress -Plugin -Repositorys einfacher, da die Boilerplate bereits das meiste von dem bietet, was Sie benötigen. Sobald wir mit der Code -Organisation und der Ordnerstruktur vertraut sind, werden wir untersuchen, wie Sie im zweiten Teil dieser Serie aktuelle Plugins mithilfe von WordPress -Plugin -Boilerplate entwickeln.
Das obige ist der detaillierte Inhalt vonBeschleunigen Sie die Entwicklung mit dem WordPress -Plugin -Kesselplatte. Für weitere Informationen folgen Sie bitte anderen verwandten Artikeln auf der PHP chinesischen Website!