Von Grund auf: Ein vollständiger Leitfaden und praktisches Tutorial zur Entwicklung von WordPress-Plugins

Vorbereitungen vor der Entwicklung eines WordPress-Plugins

Bevor man mit dem Schreiben der ersten Zeile Code beginnt, sind ausführliche Vorbereitungen die Grundlage für den Erfolg des Projekts. Dazu gehört nicht nur die Einrichtung der technischen Umgebung, sondern auch eine klare Analyse der Anforderungen sowie eine sorgfältige Projektplanung.

Zunächst benötigen Sie eine lokale Entwicklungsumgebung. Es wird empfohlen, Tools wie Local by Flywheel, MAMP, XAMPP oder Docker zu verwenden, um schnell eine Umgebung für die Ausführung von WordPress mit PHP, MySQL sowie Apache/Nginx aufzubauen. Stellen Sie sicher, dass Ihre PHP-Version den neuesten Anforderungen von WordPress entspricht – in der Regel wird PHP 7.4 oder eine höhere Version benötigt.

Zweitens: Definieren Sie genau, welches Problem Ihr Plugin lösen soll. Soll es eine bestimmte Funktion für eine Website hinzufügen oder einen bestehenden Prozess optimieren? Eine klare Beschreibung des Plugins sowie eine Liste der Funktionen bilden die Grundlage für die weitere Entwicklung. Es wird empfohlen, Tools wie Trello oder einfache Dokumente zu verwenden, um die Versionenentwicklung sowie die einzelnen Funktionspunkte zu planen.

Empfohlene Lektüre Einführung in die Entwicklung von WordPress-Plugins: Der gesamte Prozess von der Grundkenntnis bis zur Veröffentlichung im App Store.。

Zum Schluss benötigen Sie einen Code-Editor oder eine integrierte Entwicklungsumgebung (IDE). Visual Studio Code, PhpStorm und Sublime Text sind alle hervorragende Optionen, da sie eine gute Unterstützung für die Entwicklung mit PHP und WordPress bieten – einschließlich Syntaxhervorhebung, Code-Vorschlägen und Debugging-Funktionen. Sobald Sie all diese Tools bereit haben, können Sie die Grundlage für Ihre Erweiterung erstellen: die Hauptdatei.

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

Erstellen Sie Ihr erstes WordPress-Plugin.

Alles fängt schwer an – doch die Erstellung einer ganz einfachen WordPress-Plugin-Datei ist außergewöhnlich einfach. In diesem Abschnitt werden Sie Schritt für Schritt durch den Aufbau der grundlegenden Struktur des Plugins, die Erstellung der Sicherheitsdeklaration sowie den Aktivierungsprozess geführt.

Erstellen Sie einen neuen Ordner, dessen Name einzigartig ist und die Funktion des Plugins beschreibt – zum Beispiel:my-first-pluginIn diesem Ordner erstellen Sie die Haupt-Plugin-Datei, die in der Regel mit dem Namen „mainPlugin.js“ oder ähnlichem bezeichnet wird.plugin-name.phpWir müssen diesen Dateien einen Namen geben. Diese Dateien stellen den Einstiegspunkt für die Plugins dar, und WordPress erkennt die Plugins, indem es die spezifischen Kommentarinformationen am Anfang dieser Dateien liest.

Am Anfang dieses Hauptfiles müssen Sie einen Plugin-Header-Comment hinzufügen, der den WordPress-Standards entspricht. Hier ist ein einfaches Beispiel:

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

In diesem Kommentar ist der “Plugin Name” erforderlich; alle anderen Angaben sind optional. Es wird jedoch dringend empfohlen, alle Felder vollständig auszufüllen. Nach Abschluss des Vorgangs sollten Sie die Plugin-Dateien in das Installationsverzeichnis von WordPress hochladen./wp-content/plugins/Der Pfad wurde bereits eingegeben. Gehen Sie auf die “Plugins”-Seite im WordPress-Backend, dort sehen Sie Ihre Plugins und können sie aktivieren. Zu diesem Zeitpunkt verfügen die Plugins noch über keine Funktionen, aber Sie haben erfolgreich ein Plugin erstellt, das von WordPress erkannt wird.

Empfohlene Lektüre Die Entwicklung von WordPress-Plugins ist ein Prozess von Null bis Eins, bei dem es darum geht, das beliebteste Content-Management-System der Welt zu verbessern.。

Eine einfache Funktion implementieren

Lassen Sie uns der leeren Plugin-Hülle die erste funktionale Eigenschaft hinzufügen: Eine automatische Einbeziehung einer Urheberrechtsangabe am Ende des Artikelinhalts. Dies wird Ihnen dabei helfen, das Hook-System von WordPress zu verstehen.

Zuerst müssen wir eine Funktion erstellen, um die Logik zum Hinzufügen von Urheberrechtshinweisen umzusetzen. Wir nennen diese Funktion…myplugin_add_footer_text。

function myplugin_add_footer_text($content) {
    // 确保只在网站前端的主文章循环中执行
    if (is_single() && in_the_loop() && is_main_query()) {
        $footer_text = '<p><em>Dieser Artikel wird Ihnen von meinem ersten Plugin präsentiert.</em></p>';
        $content .= $footer_text;
    }
    return $content;
}

Als Nächstes müssen wir diese Funktion an einen bestimmten Ausführungspunkt in WordPress “montieren” – dieser Prozess wird als “Haken hinzufügen” („Add Hook“) bezeichnet. Hier verwenden wir…the_contentFilter-Hook: Fügen Sie den folgenden Code in die Hauptdatei Ihres Plugins hinzu:

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

add_filter('the_content', 'myplugin_add_footer_text');

Nachdem Sie die Datei gespeichert haben, aktualisieren Sie die Seite eines Artikels auf Ihrer Website – Sie werden feststellen, dass am Ende des Inhalts der von Ihnen definierte Urheberrechtstitel angezeigt wird. Mit diesem einfachen Beispiel haben Sie bereits das Kernprinzip der Plugin-Entwicklung verstanden: Funktionen erstellen und anschließend verwenden.add_actionoderadd_filterDie „Hook“-Mechanismen verbinden Funktionen mit dem Lebenszyklus von WordPress.

Hinein ins Detail: WordPress-Hooks und APIs

Das Hook-System ist das Herzstück der WordPress-Plugin-Entwicklung – es ermöglicht es Ihnen, Ihren Code zu bestimmten Zeitpunkten oder an bestimmten Stellen auszuführen. Das Verständnis und die geschickte Anwendung von Hooks ist der Schlüssel zur Erstellung komplexer Funktionen.

WordPress-Hooks lassen sich hauptsächlich in zwei Kategorien einteilen: Aktionen (Actions) und Filter (Filters). Aktionshooks werden ausgelöst, wenn bestimmte Kernereignisse in WordPress stattfinden – beispielsweise beim Veröffentlichen eines Artikels oder beim Laden der Administrationsoberfläche. Ihre Funktionen können dann bestimmte Aktionen durchführen. Filterhooks hingegen dienen dazu, Daten zu modifizieren; sie ermöglichen es Ihnen, die Werte von Daten zu ändern, bevor diese verwendet oder gespeichert werden – beispielsweise den Inhalt oder den Titel eines Artikels.

Empfohlene Lektüre Von Anfänger bis Experte: WordPress-Plugins entwickeln – eine Schritt-für-Schritt-Anleitung zum Erstellen benutzerdefinierter Funktionen.。

Erstellen Sie eine Aktionshook-Funktion:

function myplugin_log_post_published($ID, $post) {
    // 当文章发布时，在错误日志中记录一条信息（仅用于演示）
    error_log("文章 {$post->post_title} (ID: {$ID}) 已发布。");
}
// 将函数挂载到 `publish_post` 这个动作钩子上
add_action('publish_post', 'myplugin_log_post_published', 10, 2);

Erstellen Sie eine Filter-Hook-Funktion:

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

function myplugin_excerpt_length($length) {
    // 将默认的摘要长度从55个词修改为20个词
    return 20;
}
// 将函数挂载到 `excerpt_length` 这个过滤器钩子上
add_filter('excerpt_length', 'myplugin_excerpt_length');

Wenn verwendet…add_actionoderadd_filterBei der Verwendung von mehreren Callback-Funktionen stellen der dritte und vierte Parameter jeweils die Priorität sowie die Anzahl der übergebenen Parameter dar. Durch eine sinnvolle Einstellung dieser Parameter kann die Ausführungsreihenfolge der Funktionen präzise gesteuert werden.

Die Nutzung der WordPress-API zur Konfiguration

Um es den Plugin-Nutzern zu ermöglichen, das Verhalten des Plugins anzupassen, müssen Sie eine Konfigurationsseite erstellen. WordPress stellt eine API für die Einstellungen bereit, um diesen Prozess zu vereinfachen. Dies beinhaltet in der Regel drei Hauptfunktionen:register_settingDient zum Registrieren einer Reihe von Einstellungen.add_settings_sectionDient dazu, ein Einstellungsgebiet auf der Seite hinzuzufügen.add_settings_fieldZum Hinzufügen bestimmter Felder in diesem Bereich.

Funktion zur Erstellung einer Optionenseite:

function myplugin_settings_page() {
    add_options_page(
        '我的插件设置', // 页面标题
        '我的插件',     // 菜单标题
        'manage_options', // 权限
        'myplugin-settings', // 菜单 Slug
        'myplugin_render_settings_page' // 用于输出页面内容的回调函数
    );
}
add_action('admin_menu', 'myplugin_settings_page');

Dann musst du dies umsetzen.myplugin_render_settings_pageDie Funktion dient dazu, ein Formular anzuzeigen und zu verwenden.settings_fieldsunddo_settings_sectionsEine Funktion, die die von der WordPress-API automatisch verarbeiteten Formularfelder ausgibt.get_optionIn der Funktion können Sie ganz einfach an beliebiger Stelle im Plugin-Code die von den Benutzern gespeicherten Optionswerte abrufen.

Fortgeschrittene Praktiken im Plugin-Entwicklung und die Veröffentlichung

Wenn die Funktionen Ihrer Plugins immer weiter verbessert werden und die Menge des Codes zunimmt, werden eine gute Codeorganisation, Sicherheitsmaßnahmen sowie Unterstützung für die Internationalisierung von entscheidender Bedeutung.

Um den Code klar zu halten, ist es empfehlenswert, den Code für verschiedene Funktionen in separate Dateien aufzuteilen. Zum Beispiel sollten die Registrierung von Hooks sowie die Kernfunktionen in die Hauptdatei gelegt werden, während der Code, der mit der Einstellungsseite zusammenhängt, in einer eigenen Datei abgelegt wird.admin/Unterordnete Verzeichnisse – dort sollte der Code für die Frontend-Funktionen abgelegt werden.public/Unterordnete Verzeichnisse werden verwendet, und Inhalte werden unter Verwendung von Bedingungen geladen. Die Anwendung objektorientierter Programmierung (OOP) ist ebenfalls eine hervorragende Praxis zur Verwaltung komplexer Plugins, da sie Daten und Funktionen besser abgrenzen und strukturieren kann.

Sicherheit ist die Lebensader bei der Entwicklung von Plugins. Alle von den Nutzern erfassten Daten (z. B.)$_GET， $_POST， $_COOKIEAlle Elemente müssen überprüft und desinfiziert werden. WordPress bietet eine Vielzahl von Funktionen dafür, wie zum Beispiel…sanitize_text_field， wp_kses_post， intvalBeim Ausgeben von Daten an den Browser oder in eine Datenbank ist es ebenfalls notwendig, diese zu entschließen (zu „escape“). Dazu werden spezielle Zeichen verwendet, um mögliche Probleme bei der Interpretation der Daten zu vermeiden.esc_html， esc_attroderwp_ksesFunktionen: Für Datenbankoperationen muss die Funktionalität von WordPress verwendet werden.$wpdbKlassen und ihre…prepareMethoden zur Verhinderung von SQL-Injection.

Die Internationalisierung des Plugins umsetzen.

Damit Ihre Erweiterung von Nutzern auf der ganzen Welt genutzt werden kann, ist die Internationalisierung ein unerlässlicher Schritt. Dies umfasst hauptsächlich zwei Schritte:__()oder_e()Funktionen wie „wait“ umfassen alle zu übersetzenden Zeichenketten sowie die korrekte Ladung der Textfelder.

Im Plugin-Header haben wir bereits den Text-Domain-Name definiert. Bei der Initialisierung des Plugins (meist im Hauptfile) müssen die Sprachdateien geladen werden:

function myplugin_load_textdomain() {
    load_plugin_textdomain('my-first-plugin', false, dirname(plugin_basename(__FILE__)) . '/languages/');
}
add_action('init', 'myplugin_load_textdomain');

Danach kannst du etwas verwenden, das ähnlich wie… ist.__('Hello World', 'my-first-plugin')Die Schreibweise „“ wird verwendet, um Zeichenketten zu markieren. Übersetzer können Werkzeuge wie Poedit verwenden, um die generierten Ergebnisse zu bearbeiten..potErstellung von Vorlagendateien.pound.moÜbersetzen Sie die Datei und legen Sie sie im Plugin ab./languages/Im Verzeichnis.

Schließlich, wenn die Funktionen des Plugins stabil sind, kannst du es in das offizielle WordPress-Plugin-Verzeichnis einreichen, damit es von mehr Menschen genutzt werden kann. Dafür musst du den Plugin-Code zusammenpacken und eine ausführliche Beschreibung verfassen.readme.txtDateien müssen gemäß den Entwicklungsstandards der Community erstellt und verwaltet werden.

Zusammenfassungen

Die Entwicklung von WordPress-Plugins ist eine praktische Reise, bei der Ideen in leistungsstarke Funktionen umgewandelt werden. Beginnen Sie mit dem Aufbau der Umgebung und der Erstellung grundlegender Plugin-Dateien, und arbeiten Sie sich schrittweise an die Kernmechanismen sowie die API-Einstellungen heran. Später werden Sie Themen wie die Organisation des Codes, Sicherheit und Internationalisierung behandeln. Der Schlüssel zu diesem gesamten Prozess liegt darin, die ereignisgesteuerte Architektur von WordPress zu verstehen und die Kernfunktionen mithilfe von Aktionen und Filter-Hooks nahtlos zu erweitern. Denken Sie daran: Mit einer kleinen Funktion zu beginnen, schrittweise zu iterieren und stets die Sicherheit des Codes sowie die Benutzererfahrung an erste Stelle zu setzen, ist der beste Weg, um zu einem erfolgreichen Plugin-Entwickler zu werden.

FAQ Häufig gestellte Fragen

Welche Programmiersprachen sind für die Entwicklung von WordPress-Plugins mit ### erforderlich?
Um WordPress-Plugins zu entwickeln, ist es in erster Linie notwendig, die PHP-Sprache zu beherrschen, da der Kern von WordPress selbst in PHP programmiert ist. Die Frontend-Funktionen beinhalten in der Regel HTML, CSS und JavaScript. Für die Interaktion mit Datenbanken sind grundlegende SQL-Kenntnisse ebenfalls hilfreich.$wpdbDie Klasse enthält die meisten Operationen.

Wie debugge ich mein WordPress-Plugin?

Während der Entwicklungsphase wird empfohlen, den Debugging-Modus von WordPress einzuschalten.wp-config.phpIn der Datei wird Folgendes festgelegt:WP_DEBUGDie Konstante ist auftrueSie können auch folgendes verwenden:error_log()Die Funktion protokolliert die Informationen im Fehlerprotokoll des Servers. Für eine detailliertere Fehlersuche können professionelle Plugins wie Xdebug oder Query Monitor verwendet werden, um die Ausführung des Codes sowie die Abfragen an die Datenbank nachzuverfolgen.

Wie kann meine Erweiterung mit Drittanbieter-Diensten oder APIs interagieren?

Plugins können über die HTTP-API von WordPress verwendet werden (z. B.wp_remote_get()， wp_remote_post()Es ermöglicht eine sichere und stabile Kommunikation mit externen Diensten. Die HTTP-API von WordPress verfügt über integrierte Funktionen wie Timeout-Verarbeitung und SSL-Validierung, was sie zuverlässiger macht als die direkte Verwendung der PHP-Funktionen curl oder file_get_contents. Bei der Verarbeitung von Antworten ist es unerlässlich, Fehler zu überprüfen und angemessene Fehlerbehandlungen durchzuführen.

Wie kann ich einer meiner Plugins benutzerdefinierte Datenbanktabellen hinzufügen?

Obwohl die WordPress-Optionenliste ausreicht, um die meisten Konfigurationsdaten zu speichern, eignet sich strukturierte Daten möglicherweise besser für die Speicherung in benutzerdefinierten Tabellen. Sie können dies in den Aktivierungs-Hooken von Plugins umsetzen (mit…)register_activation_hookDie SQL-Anweisung zur Erstellung der Tabelle wird im Prozess der Funktionenregistrierung ausgeführt. Es muss unbedingt verwendet werden…$wpdb->prefixStellen Sie sicher, dass der Tabellennamen-Prefix korrekt ist, und verwenden Sie…dbDeltaEs gibt Funktionen, die es ermöglichen, Tabellendatenstrukturen sicher zu erstellen oder zu aktualisieren. Jede Abfrage an benutzerdefinierten Tabellen sollte über diese Funktionen erfolgen.$wpdbDie Objekte werden entsprechend verarbeitet.

Wie stelle ich sicher, dass mein Plugin mit anderen Plugins oder Themes kompatibel ist?

Die besten Praktiken zur Aufrechterhaltung der Kompatibilität sind: Verwendung der WordPress-Core-API und Standard-Hooks; Hinzufügen eines eindeutigen Präfixes (z. B. unter Verwendung des Plugin-Akronyms) für Funktionen, Klassen und Optionennamen; Einbettung von Funktionen in Klassen oder Namespaces, um Namenskonflikte zu vermeiden; Vermeidung der direkten Änderung globaler Variablen; und Überprüfung, ob bereits etwas vorhanden ist, bevor Aktionen ausgeführt werden, die den globalen Status beeinflussen könnten (z. B. Registrierung von Shortcodes, benutzerdefinierte Artikeltypen). Testen Sie vor der Veröffentlichung so weit wie möglich in verschiedenen Umgebungen.