Vom Nullpunkt aus die WordPress-Plugin-Entwicklung meistern: Ein umfassender Leitfaden und praktische Übungen

WordPress-Plugins sind die Kernmethode, um die Funktionen von WordPress zu erweitern. Sie ermöglichen es Entwicklern, nahezu jede Funktion auf eine Website hinzuzufügen, ohne den Kerncode zu ändern. Egal ob es sich um einfache Shortcodes oder um komplexe E-Commerce-Systeme handelt – alles kann mithilfe von Plugins realisiert werden. Das Verständnis der Plugin-Entwicklung bedeutet, dass Sie in der Lage sind, spezifische Anforderungen individuell zu erfüllen, wiederverwendbare Funktionsmodule zu erstellen oder sogar eigene Produkte zu entwickeln. Dieser Artikel wird Sie von den grundlegenden Konzepten bis hin zur praktischen Entwicklung führen und Ihnen die wesentlichen Fähigkeiten im Bereich der WordPress-Plugin-Entwicklung vermitteln.

Grundlagen der WordPress-Plugin-Entwicklung und Vorbereitung der Umgebung

Bevor du die erste Zeile Code schreibst, musst du das grundlegende Aufbaukonzept des Plugins verstehen und die Entwicklungsumgebung einrichten.

Die grundlegende Struktur von Plugins sowie die Organisation ihrer Dateien

Die einfachste WordPress-Plugin kann aus nur einer Datei bestehen. Diese Hauptdatei muss spezifische Plugin-Hauptkommentare enthalten, anhand derer WordPress die Informationen zum Plugin erkennt. Diese Hauptdatei wird in der Regel mit dem Namen „plugin.php“ bezeichnet. your-plugin-name.php。

Empfohlene Lektüre Tiefgehend und leicht verständlich: Der vollständige Leitfaden, um die WordPress-Plugin-Entwicklung von Grund auf zu beherrschen。

Die Formatierung der Kommentare im Kopfbereich der Plugins sieht wie folgt aus:

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

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

Diese Anmerkung definiert Metadaten wie den Namen, die Version und den Autor des Plugins – sie ist sozusagen die “Identität” des Plugins. Die Plugin-Dateien sollten an der entsprechenden Stelle abgelegt werden. /wp-content/plugins/ Im Verzeichnis kann entweder eine einzelne PHP-Datei oder ein Ordner mit dem Namen des Plugins befinden. Der Ordner enthält die Hauptdatei sowie weitere Ressourcen.

Aufbau einer lokalen Entwicklungsumgebung

Eine zuverlässige lokale Entwicklungsumgebung ist von großer Bedeutung. Es wird empfohlen, Tools wie Local by Flywheel, XAMPP oder MAMP zu verwenden, um schnell eine WordPress-Umgebung mit PHP, MySQL sowie Apache/Nginx aufzubauen. Darüber hinaus benötigen Sie einen Code-Editor, beispielsweise Visual Studio Code oder PHPStorm, sowie passende Plugins für die intelligente Erkennung von PHP- und WordPress-Code, um die Entwicklungseffizienz zu steigern.

Stellen Sie sicher, dass Ihre Umgebung eine PHP-Version verwendet, die der auf dem Zielserver verwendeten ähnelt (PHP 7.4 oder höher wird empfohlen), und… wp-config.php Öffnen Sie es auf dem Computer. WP_DEBUG Muster, um Fehler und Warnungen während des Entwicklungsprozesses erfassen zu können.

define( 'WP_DEBUG', true );

Core development concepts: Hooks and filters

Die Kernphilosophie der WordPress-Plugin-Entwicklung basiert auf den sogenannten “Hooks”. Diese ermöglichen es Ihnen, benutzerdefinierten Code zu bestimmten Zeitpunkten oder an bestimmten Stellen einzufügen, ohne die Kerndateien des WordPress-Systems direkt ändern zu müssen. Es gibt zwei Arten von Hooks: Actions und Filters.

Empfohlene Lektüre WordPress-Plugin-Entwicklung von Grund auf: Prinzipien, Praxis und fortgeschrittene Techniken。

Verstehen von Aktionshookern (Action Hooks)

Action Hooks ermöglichen es Ihnen, benutzerdefinierte Funktionen zu ausführen, zu bestimmten Zeitpunkten in WordPress – beispielsweise beim Veröffentlichen eines Artikels oder beim Laden des Seitenkopfes. add_action() Die Funktion “montiert” Ihre eigene Funktion an den entsprechenden Hook.

Zum Beispiel auf der Frontend-Seite einer Website… Einige Inhalte können hinzugefügt werden, wenn gewünscht. wp_head Action Hook:

function myplugin_add_custom_head_content() {
    echo '<meta name="my-custom-tag" content="Hello from my plugin">';
}
add_action( 'wp_head', 'myplugin_add_custom_head_content' );

Wenn WordPress auf diese Stelle kommt… wp_head Wenn die Position festgelegt wird, wird die von uns bereitgestellte Montagefunktion aufgerufen. myplugin_add_custom_head_content Funktion.

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

Verstehen der Filter-Hook-Mechanismen

Filter-Hooks dienen dazu, Daten zu modifizieren. Sie ermöglichen es Ihnen, Daten vor ihrer Verwendung oder Speicherung in einer Datenbank zu ändern. add_filter() Eine Funktion, die den Filter anwendet.

Ein klassisches Beispiel ist die Änderung der Anzeige des Artikeltitels. Der folgende Code fügt vor allen Artikeltiteln den Text “Wichtig:” hinzu:

function myplugin_prepend_to_title( $title ) {
    if ( is_single() ) {
        $title = '重要：' . $title;
    }
    return $title;
}
add_filter( 'the_title', 'myplugin_prepend_to_title' );

Die Funktion nimmt den ursprünglichen Titel als Parameter entgegen und muss diesen nach der Modifikation zurückgeben. Das WordPress-Kern sowie viele Plugins bieten Hunderte von Aktionen und Filter-Hooks an, die die Hauptmethode der Interaktion zwischen Plugins und dem System darstellen.

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

Erstellen Sie Ihr erstes Funktions-Plugin.

Lassen Sie uns anhand eines vollständigen Praxisbeispiels einen “Artikel-Lesezeit-Einschätzung”-Plugin erstellen, das Hook-Funktionen, Shortcodes sowie Einstellmöglichkeiten kombiniert.

Hauptdatei des Plugins und Implementierung der Funktionen

Zunächst einmal… /wp-content/plugins/ In dem Verzeichnis wird ein Ordner erstellt. post-reading-timeUnd erstellen Sie darin die Hauptdatei. post-reading-time.phpFüllen Sie die Informationen für den Kopfbereich des Plugins aus.

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

Als Nächstes implementieren wir die Kernfunktionsmethode. Diese Methode berechnet die Lesezeit eines Artikels (unter der Annahme, dass die durchschnittliche Lesegeschwindigkeit 200 Wörter pro Minute beträgt) und gibt eine formatierte Zeichenkette zurück.

function prt_calculate_reading_time( $post_id ) {
    $post_content = get_post_field( 'post_content', $post_id );
    // 清除短代码和HTML标签，只计算纯文字
    $clean_content = strip_shortcodes( $post_content );
    $clean_content = wp_strip_all_tags( $clean_content );
    $word_count = str_word_count( $clean_content );

$reading_time = ceil( $word_count / 200 ); // 假设每分钟读200字

return sprintf(
        _n( '约 %d 分钟读完', '约 %d 分钟读完', $reading_time, 'post-reading-time' ),
        $reading_time
    );
}

Die Ergebnisse werden mithilfe von Shortcodes und automatischer Einbettung angezeigt.

Um den Nutzern mehr Flexibilität zu bieten, stellen wir zwei Möglichkeiten zur Anzeige der Lesezeit zur Verfügung. Die erste Möglichkeit besteht darin, einen Kurzcode zu erstellen. [reading_time]。

Wir verwenden… add_shortcode() Funktion zur Registrierung von Kurzcodes:

function prt_reading_time_shortcode( $atts ) {
    $atts = shortcode_atts( array(
        'id' => get_the_ID(),
    ), $atts, 'reading_time' );

return '<span class="post-reading-time">'`.prt_calculate_reading_time($atts['id'])`.'</span>'php
add_shortcode('reading_time', 'prt_reading_time_shortcode');

Benutzer können im Artikel-Editor Inhalte einfügen. [reading_time] Damit wird die Lesezeit des aktuellen Artikels angezeigt.

Die zweite Methode besteht darin, die Lesezeit automatisch am Ende des Artikelinhalts hinzuzufügen. Dafür ist… the_content Filter-Hook:

function prt_display_reading_time_after_content( $content ) {
    if ( is_single() && in_the_loop() && is_main_query() ) {
        $reading_time_html = '<div class="post-reading-time-container">';
        $reading_time_html .= prt_calculate_reading_time( get_the_ID() );
        $reading_time_html .= '</div>';
        $content .= $reading_time_html;
    }
    return $content;
}
add_filter( 'the_content', 'prt_display_reading_time_after_content' );

So wird die Lesezeit automatisch am Ende jedes einzelnen Artikels angezeigt, ohne dass man kurze Codes manuell einfügen muss.

Plugin-Sicherheit, Optimierung und Vorbereitung auf die Veröffentlichung

Ein qualifizierter Plugin muss nicht nur funktionieren, sondern auch sicher, effizient und einfach für andere zu verwenden sein.

Datenvalidierung, Entschlüsselung und Berechtigungsprüfung

Sicherheit steht an erster Stelle. Alle Daten, die von Benutzern oder aus externen Quellen eingegeben werden, müssen überprüft und entsprechend behandelt (z. B. durch Entschlüsselung oder Auswertung) werden.
– **Validierung**: Überprüft, ob die Daten dem erwarteten Format entsprechen (z. B. ob es sich um Zahlen, E-Mails usw. handelt), und wird vor der Speicherung in der Datenbank durchgeführt. Dazu können verschiedene Methoden verwendet werden. sanitize_text_field()、intval() Zum Beispiel können Sie die folgenden Funktionen verwenden:
– Escape: Beim Ausgeben von Daten an den Browser muss sichergestellt werden, dass diese nicht als bösartiger Code interpretiert werden. Dazu werden spezielle Zeichen verwendet („Escape-Zeichen“). esc_html()、esc_attr()、esc_url() Zum Beispiel können Sie die folgenden Funktionen verwenden:
– Berechtigungsprüfungen (Capability Checks): Vor der Ausführung von Verwaltungsvorgängen werden diese durchgeführt. current_user_can() Prüfen Sie, ob der aktuelle Benutzer über die entsprechenden Berechtigungen verfügt. current_user_can( 'edit_posts' )。

Leistungsverbesserung und Codeorganisation

Mit der Zunahme der Funktionen sollte der Code modularisiert werden. Verschiedene Funktionen – wie Backend-Einstellungen, Frontend-Anzeigen und API-Verarbeitung – sollten in separate Dateien aufgeteilt und über eine Hauptdatei eingebunden werden. require_once oder include_once Um die Dateien zu organisieren.

Für komplexe Abfragen oder Operationen, die häufig ausgeführt werden, sollten Sie in Betracht ziehen, die WordPress-Transients-API zu verwenden, um diese zu cachen. set_transient() und get_transient()Damit der Druck auf die Datenbank verringert wird.

Internationalisierung und Vorbereitung auf die Veröffentlichung

Damit das Plugin von Nutzern weltweit verwendet werden kann, muss es internationalisiert (i18n) werden. Das bedeutet, dass alle für die Benutzer bestimmten Zeichenketten mit Übersetzungsfunktionen umschlossen werden müssen.
1. Verwenden Sie __( '文本', 'text-domain' ) Bitte geben Sie den zu übersetzenden Text an.
2. In den Kommentaren am Anfang des Plugins definieren Text Domain(Wie ‘post-reading-time’) und stellen sicher, dass es mit den später generierten Inhalten übereinstimmt. .pot Die Dateinamen und die Domainnamen stimmen überein.
3. 使用工具如 Poedit 或 WP-CLI 的 wp i18n make-pot Befehl zur Erstellung von Sprachvorlagen-Dateien (.pot).

Vor der Veröffentlichung stellen Sie sicher, dass der Code den WordPress-Codestandards entspricht, und verfassen Sie außerdem eine klare Beschreibung bzw. Dokumentation dazu. readme.txt Die Datei sollte im von WordPress vorgeschriebenen Format erstellt werden und die Funktionen des Plugins, die Installationsanweisungen, Screenshots sowie die Aktualisierungsprotokolle detailliert beschreiben.

Zusammenfassungen

Die Entwicklung von WordPress-Plugins ist ein systematischer Prozess, der von der Erkenntnis der Grundstruktur und des Beherrschens der Hook-Mechanismen über die sichere und effiziente Implementierung von Funktionen bis hin zur Internationalisierung und Veröffentlichung reicht. Indem Sie mit der Erstellung eines einfachen Funktionsteils beginnen, können Sie allmählich das Betriebsverhalten von WordPress sowie die Entwicklungsrichtlinien besser verstehen. Der Schlüssel liegt darin, sich an die besten Praktiken zu halten: Hookes geschickt für eine nicht-invasive Entwicklung zu nutzen, strenge Sicherheitsmaßnahmen zu ergreifen und stets auf die Leistung und Wartbarkeit des Codes zu achten. Die kontinuierliche Erforschung des Kerncodes sowie der Implementierung hochwertiger Open-Source-Plugins ist der beste Weg, um Ihre Fähigkeiten zu verbessern.

FAQ Häufig gestellte Fragen

Welche Vorkenntnisse sind für die Entwicklung von WordPress-Plugins erforderlich?

Sie sollten über grundlegende Kenntnisse der PHP-Programmiersprache verfügen, einschließlich Variablen, Funktionen, Arrays, bedingter Anweisungen und Schleifen. Zudem sollten Sie sich mit HTML, CSS und JavaScript auskennen, um die Frontend-Präsentation und -Interaktion zu gestalten. Ein Verständnis der grundlegenden Konzepte von WordPress – wie Artikeln, Seiten und Kategorien – wird Ihnen die Arbeit beim Entwickeln erleichtern.

Wie debugge ich mein WordPress-Plugin?

Die effektivste Methode ist es, den Debugging-Modus von WordPress zu aktivieren. wp-config.php Einstellungen im File define( 'WP_DEBUG', true ); und define( 'WP_DEBUG_LOG', true );Auf diese Weise werden alle Fehler und Warnungen aufgezeichnet. /wp-content/debug.log In den Dateien sollte vermieden werden, Inhalte direkt an die Benutzer anzuzeigen. Außerdem sollten Sie die Browser-Entwicklungstools nutzen, um Netzwerkanfragen und JavaScript-Fehler zu überprüfen. error_log() Es ist eine gängige Methode zur Fehlersuche, dass Funktionen im Code Werte von Variablen in die Protokolle („Logs“) ausgeben.

Wie ist mein Plugin mit dem Theme oder anderen Plugins kompatibel?

Der Schlüssel zur Beibehaltung der Kompatibilität besteht darin, die WordPress-Standards einzuhalten und Hook-Funktionen vorsichtig zu verwenden. Vermeiden Sie direkte Änderungen an der Struktur der Kern-Datenbanktabellen oder die Nutzung nicht öffentlich zugänglicher Funktionen (die oft mit „non-public“ oder „internal“ gekennzeichnet sind). _ (Fangen Sie mit einem Unterstrich an.) Fügen Sie Ihren Funktionen, Klassen und Optionen einzigartige Präfixe hinzu (z. B. myplugin_Damit Namenskonflikte vermieden werden, werden Filter-Hooks bereitgestellt, die es anderen Entwicklern ermöglichen, das Verhalten Ihres Plugins zu ändern – genauso wie Sie das Verhalten des WordPress-Kerns anpassen können.

Wie füge ich einer meiner Plugins eine Seite für die Backend-Einstellungen hinzu?

Sie können die “Settings API” von WordPress verwenden, um professionelle Backend-Einstellungsseiten hinzuzufügen. Dies umfasst mehrere Schritte: add_menu_page() oder add_submenu_page() Menüseite zur Funktionenregistrierung – danach die Funktion verwenden. register_setting()、add_settings_section() und add_settings_field() Mithilfe von Funktionen wie diesen werden die Felder und Bereiche definiert. Abschließend wird eine Callback-Funktion erstellt, die die HTML-Formulare der Einstellungsseite ausgibt. Diese Vorgehensweise ermöglicht die automatische Abwicklung von Berechtigungsprüfungen, unsicheren Überprüfungen sowie der Speicherung von Optionen und ist daher die am meisten empfohlene Methode.