WordPress-Plugin-Entwicklungshandbuch: Von Null zu Eins – Erstellen Sie Ihr erstes benutzerdefinierte Plugin

Entwicklungsumgebung und Grundlegende Vorbereitungen

Bevor Sie mit dem Schreiben von Code beginnen, ist eine stabile und effiziente lokale Entwicklungsumgebung von entscheidender Bedeutung. Für die Entwicklung von WordPress-Plugins empfehlen wir integrierte Umgebungen wie XAMPP, MAMP oder Local by Flywheel – diese ermöglichen die einfache Einrichtung von Apache, MySQL und PHP mit nur einem Klick, ohne aufwendige Konfigurationsprozesse. Stellen Sie sicher, dass Ihre PHP-Version mindestens 7.4 und Ihre MySQL-Version mindestens 5.6 beträgt, um den neuesten Anforderungen der WordPress-Offiziellen zu entsprechen.

Als Nächstes benötigst du einen Code-Editor. Visual Studio Code, PhpStorm oder Sublime Text sind alle hervorragende Wahlmöglichkeiten – sie bieten Funktionen wie Syntax-Hervorhebung, Code-Vorschläge und Debugging-Möglichkeiten, die die Entwicklungseffizienz erheblich steigern. Außerdem solltest du ein Tool für die Versionsverwaltung installieren, wie z. B. Git, um deine Code-Änderungen zu verwalten. Dies ist eine Standardpraxis in der modernen Entwicklung.

Das Verständnis der grundlegenden Struktur von WordPress-Plugins ist der erste Schritt. Ein einfaches Plugin enthält mindestens eine Haupt-PHP-Datei, deren Header-Anmerkungen die “Identifikationskarte” des Plugins darstellen und dem WordPress-System Informationen über das Plugin mitteilen. Diese Datei kann auch eigenständig existieren oder als Eingangspunkt zu einem komplexeren Plugin-Verzeichnis dienen.

Empfohlene Lektüre WordPress-Plugin-Entwicklung von der Grundlage bis zur Meisterschaft: Erstellen Sie Ihr erstes benutzerdefiniertes Plugin。

Erstellen Sie Ihre erste Plugin-Datei.

Lassen Sie uns mit der Erstellung des einfachsten Plugins beginnen. Zuerst gehen Sie in das Verzeichnis Ihrer lokalen WordPress-Installation.wp-content/pluginsOrdnern: Hier erstellen Sie einen neuen Ordner und nennen Sie ihn…my-first-pluginAlle Dateien, die mit den Plugins zusammenhängen, werden in diesem Verzeichnis abgelegt.

UltaHost – WordPress-Hosting-Anbieter

30-tägige Geld-zurück-Garantie, unbegrenztes Bandbreiten- und Datenbankvolumen, kostenlose DDoS-Schutzmaßnahmen sowie ein Rabatt von 501 auf 4 Terabyte bei einer Kaufdauer von 3 Jahren.

Zugangsseite

In diesem Ordner erstellen Sie eine Haupt-PHP-Datei – nennen Sie sie beispielsweise „main.php“.my-first-plugin.phpDer Kopf dieser Datei muss einen bestimmten Block mit Anmerkungen zu den Plug-in-Informationen enthalten. Hier ist ein standardisiertes Beispiel:

<?php
/**
 * Plugin Name:       我的第一个插件
 * Plugin URI:        https://example.com/my-first-plugin
 * Description:       这是一个用于学习的简单WordPress插件示例。
 * Version:           1.0.0
 * Author:            你的名字
 * Author URI:        https://example.com
 * License:           GPL v2 or later
 * Text Domain:       my-first-plugin
 */

In diesem Kommentar ist “Plugin Name” eine Pflichtangabe – WordPress benötigt diese Information, um Ihr Plugin in der Liste der Backend-Plugins zu erkennen und anzuzeigen. Weitere Angaben wie die Versionnummer oder der Autor helfen den Nutzern, mehr über das Plugin zu erfahren. Nachdem Sie die Datei gespeichert haben, melden Sie sich im WordPress-Backend an und gehen Sie auf die Seite “Plugins”. Dort sollten Sie Ihr erstes Plugin in der Liste sehen und es aktivieren oder deaktivieren können. Derzeit verfügt das Plugin noch über keine Funktionen, aber Sie haben erfolgreich einen gültigen Plugin-rahmen erstellt.

Die Kernfunktionen für das Plugin hinzufügen

Ein aktivierter Plugin benötigt das Hook-System von WordPress, um Code auszuführen. Es gibt zwei Arten von Hooks: Action Hooks und Filter Hooks. Action Hooks ermöglichen es dir, Code zu bestimmten Zeitpunkten einzufügen, um Funktionen auszuführen, während Filter Hooks es dir ermöglichen, die während des Prozesses übergebenen Daten zu modifizieren.

Verwenden Sie Aktionshaken, um ein Verwaltungsmenü hinzuzufügen.

Um es den Benutzern zu ermöglichen, mit dem Plugin zu interagieren, müssen wir in der Regel eine Einstellungsseite im WordPress-Backend hinzufügen. Dies kann auf verschiedene Weise erfolgen…add_action()Die Funktion wird montiert.admin_menuDiese Aktion wird mit einem Hook umgesetzt.

Empfohlene Lektüre Das ultimative Handbuch für die Entwicklung von WordPress-Plugins: Erstellen Sie Ihr erstes benutzerdefiniertes Plugin von Grund auf。

Zunächst definieren wir in der Haupt-Plugin-Datei eine Funktion, die die HTML-Inhalte der Einstellungsseite ausgibt. Diese Funktion kann beispielsweise „generateSettingsPageHTML“ genannt werden.mfp_settings_page_htmlDann erstellen wir eine weitere Funktion, zum Beispiel…mfp_add_admin_menuIn dem wird WordPress verwendet.add_menu_page()Eine Funktion wird verwendet, um einen neuen obersten Menüeintrag zu registrieren. Zum Schluss wird…add_action('admin_menu', 'mfp_add_admin_menu')Die Registrierungsfunktion muss im System installiert („gemountet“) werden.

Die Inhalte von Artikeln mithilfe von Filter-Hooks ändern

Neben den Backend-Funktionen werden Plugins häufig verwendet, um die Frontend-Inhalte einer Website zu ändern. Zum Beispiel können wir am Ende jedes Artikels automatisch eine Urheberrechtsangabe hinzufügen. Dafür ist die Nutzung von Plugins erforderlich.the_contentDieser Filter-Hook.

Wir definieren eine Funktion – nennen wir sie zum Beispiel „myFunction“.mfp_add_copyright_to_contentEs nimmt einen Parameter entgegen – nämlich den ursprünglichen Inhalt des Artikels – und fügt am Ende angepassten HTML-Text hinzu. Anschließend wird der Artikel weiterverarbeitet.add_filter('the_content', 'mfp_add_copyright_to_content')Registrieren Sie diese Funktion als Filter. Dadurch wird sie bei jedem Aufruf des Artikelinhalts in WordPress zuerst ausgeführt. Die Urheberrechtsinformationen werden hinzugefügt, bevor der Inhalt ausgegeben wird.

hosting.com Shared Hosting

Hohe Leistung mit AMD EPYC-CPUs, NVMe-SSD-Speicher und LiteSpeed, fachkundiger Inhouse-Support rund um die Uhr, erweiterte Sicherheitsmaßnahmen einschließlich SSL, Brute-Force-, Malware- und DDoS-Schutz, Einsparungen von bis zu 73%

Zugangsseite

Plugin-Sicherheit, Optimierung und Veröffentlichung

Die Entwicklung neuer Funktionen ist nur der erste Schritt – es ist genauso wichtig, die Sicherheit und Leistung des Plugins zu gewährleisten. Alle von den Nutzern eingegebenen Daten müssen vor dem Eintritt in die Datenbank oder der Ausgabe auf der Seite streng überprüft, entschärft und gereinigt werden. WordPress bietet eine Vielzahl von Sicherheitsfunktionen, die dabei helfen, potenzielle Sicherheitslücken zu vermeiden.sanitize_text_field()(Bereinigung des Textes)esc_html()(Escape HTML) undwp_kses()(Erlaubte HTML-Tags können verwendet werden; achten Sie darauf, sie an den richtigen Stellen einzusetzen.)

Um die Wartbarkeit und Leistung des Plugins zu verbessern, wird empfohlen, den Code nach den Prinzipien der objektorientierten Programmierung (OOP) zu organisieren und die Funktionen in Klassen zu verpacken. Zudem sollte die WordPress-Transients-API sinnvoll genutzt werden, um zeitaufwendige Abfrageresultate oder Daten aus entfernten Quellen zu speichern, um wiederholte Berechnungen bei jedem Seitenladen zu vermeiden.

Wenn die Funktionen deines Plugins vollständig entwickelt und die Tests abgeschlossen sind, kannst du darüber nachdenken, es zu veröffentlichen. Du musst dazu eine klare und verständliche Dokumentation sowie eine benutzerfreundliche Oberfläche vorbereiten, die die Nutzung des Plugins erleichtert.readme.txtDie Dateien müssen dem Format von WordPress.org entsprechen und die Funktionen des Plugins, die Installationsanleitung, die Aktualisierungsprotokolle sowie häufig gestellte Fragen beschreiben. Wenn Sie das Plugin in den offiziellen Plugin-Katalog einreichen möchten, müssen Sie ein SVN-Repository erstellen und die dortigen Code-Standards sowie die Einreichungsrichtlinien befolgen. Für kommerzielle Plugins ist außerdem die Einrichtung eigener Verkaufs- und Aktualisierungsserver erforderlich.

Empfohlene Lektüre Die vollständige Beherrschung der WordPress-Plugins-Entwicklung: Erstellung benutzerdefinierter Funktionen von Grund auf.。

Zusammenfassungen

Mit dieser Anleitung haben wir den Kernprozess der WordPress-Plugin-Entwicklung durchlaufen: Von der Einrichtung der Umgebung und der Erstellung der grundlegenden Dateistruktur über die Nutzung von Aktionen und Filter-Hooks, um dem Plugin Leben einzuhauchen, bis hin zu Aspekten wie Sicherheit, Optimierung und der Vorbereitung auf die Veröffentlichung. Der eigentliche Zweck der Plugin-Entwicklung besteht darin, die Kernfunktionen von WordPress zu erweitern – und das Hook-System dient als Brücke zwischen Ihrem Code und der Welt von WordPress. Sobald Sie diese Grundlagen beherrschen, können Sie durch die Durchsicht der offiziellen Plugin-Dokumentationen sowie des Kerncodes weitere, komplexe APIs und Möglichkeiten erkunden und so leistungsstarke, sichere und beliebte Plugins entwickeln.

FAQ Häufig gestellte Fragen

Welche Dateien muss ein Plugin enthalten?

Die einfachste Erweiterung („Plugin“) kann aus einer einzigen PHP-Datei bestehen, die die korrekten Datei-Hauptkommentare enthält. Mit zunehmender Komplexität der Funktionen umfasst sie jedoch in der Regel mehrere PHP-Dateien, JavaScript-Code, CSS-Dateien, Bildressourcen sowie weitere Komponenten.readme.txtBeschreibendes Dokument: Die zentrale Haupt-PHP-Datei ist erforderlich.

InterServer Shared Hosting

Shared Hosting $2.50 USD pro Monat, erster Monat $0.1 USD Promo-Code tryinterserver, 461 Cloud-Apps Skripte, ein Klick installieren.

Zugangsseite

Wie kann ich verhindern, dass meine Erweiterung mit anderen Erweiterungen konfliktiert?

Es ist die beste Praxis, allen Funktionen, Klassen, Konstanten und globalen Variablen einen eindeutigen Präfix hinzuzufügen, um Namenskonflikte zu vermeiden. Häufig werden Abkürzungen von Plugins oder spezifische Bezeichnungen als Präfix verwendet.mfp_odermy_plugin_Gleichzeitig kann die Verpackung des Codes in Klassen auch die Auswirkungen auf das Scope effektiv isolieren.

Wie fügt man einer Erweiterung konfigurierbare Einstellungsoptionen hinzu?

Es wird empfohlen, die WordPress Settings API zur Erstellung sicherer, standardisierter Einstellungsseiten zu verwenden. Sie bietet Funktionen zum Registrieren von Einstellungen, zum Hinzufügen von Einstellungsfeldern und -abschnitten sowie zur automatischen Verarbeitung der Speicherung, Überprüfung von Optionen und der Nicht-Cross-Site-Request-Authentication (Nonce)-Überprüfung – was eine deutliche Erleichterung gegenüber der manuellen Handhabung darstellt.$_POSTDie Daten müssen viel sicherer und zugleich viel benutzerfreundlicher sein.

Wie fügt man während der Entwicklung Fehler in einem Plugin hin?

Zuerst stellen Sie sicher, dass Ihre…wp-config.phpIn der Datei ist der WordPress-Debugging-Modus aktiviert.WP_DEBUGDie Konstante ist auftrueAußerdem kann man professionelle Debugging-Plugins wie Query Monitor installieren und aktivieren. Diese helfen Ihnen dabei, Datenbankabfragen, die Ausführung von Hooks, PHP-Fehler sowie Leistungsprobleme zu überwachen – sie sind unverzichtbare Werkzeuge im Entwicklungsprozess.