Leitfaden zur Entwicklung von WordPress-Plugins: Eine Schritt-für-Schritt-Anleitung, um Ihr eigenes Plugin von Grund auf zu erstellen

Verständnis der Grundlagen von Plugins sowie der Einrichtung einer Entwicklungsumgebung

Bevor Sie mit dem Schreiben von Code beginnen, ist es von entscheidender Bedeutung, die grundlegenden Konzepte von WordPress-Plugins zu verstehen und eine geeignete lokale Entwicklungsumgebung vorzubereiten. Ein Plugin ist im Grunde genommen ein Verzeichnis, das eine oder mehrere PHP-Dateien enthält, und erweitert oder modifiziert die Kernfunktionen von WordPress mithilfe des von WordPress bereitgestellten Hook-Systems. Im Gegensatz zu Themes konzentriert sich ein Plugin darauf, neue Funktionen hinzuzufügen, anstatt das Erscheinungsbild der Website zu verändern; selbst wenn Sie das Theme wechseln, bleiben die Funktionen des Plugins in der Regel unverändert.

Um mit der Entwicklung zu beginnen, benötigen Sie zunächst eine lokale WordPress-Umgebung. Dies lässt sich mithilfe von Tools wie Local by Flywheel, MAMP, XAMPP oder direkt mit Docker-Containern einfach realisieren. Nach der Installation von WordPress lokal müssen Sie nun in die entsprechenden Konfigurationen einsteigen bzw. die Einrichtungen anpassen, um die Entwicklungsumgebung optimal nutzen zu können.wp-content/pluginsVerzeichnis. Hier befinden sich alle Plugins. Erstellen Sie ein neues Verzeichnis, zum Beispiel…my-first-pluginIn diesem Ordner musst du eine Haupt-PHP-Datei erstellen, deren Name in der Regel dem Namen des Ordners entspricht. Zum Beispiel:my-first-plugin.phpDieses Hauptdatei ist der Einstiegspunkt für das Plugin und enthält eine Reihe spezieller Kommentarzeilen, die WordPress mitteilen, welchen Namen das Plugin hat, welche Beschreibung es bietet, welche Version es verwendet, wer der Autor ist und weitere wichtige Informationen.

Es wird empfohlen, die Funktion im Entwicklungsumfeld zu aktivieren.WP_DEBUGModus. Öffnen Sie den Ordner im Wurzelverzeichnis von WordPress…wp-config.phpDatei: Finden Sie oder fügen Sie die folgende Zeile hinzu:

Empfohlene Lektüre Praktischer Leitfaden zur Entwicklung von WordPress-Plugins: Erstellen Sie Ihr erstes Plugin von Grund auf.。

define( ‘WP_DEBUG’, true );
define( ‘WP_DEBUG_LOG’, true );
define( ‘WP_DEBUG_DISPLAY’, false );

Dies wird Fehler und Warnungen in die Protokolle aufnehmen.wp-content/debug.logDie Dateien helfen dir dabei, Probleme während des Entwicklungsprozesses schnell zu lokalisieren. Zudem kann die Verwendung eines leistungsstarken Codeeditors oder einer Integrated Development Environment (IDE) – wie z. B. VS Code oder PhpStorm – die Entwicklungseffizienz erheblich steigern. Diese Tools bieten in der Regel gute Syntaxunterstützung sowie hilfreiche Tipps und Warnungen für PHP und WordPress.

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 Ihre erste Plugin-Datei.

Wir werden den gesamten Prozess – von der Erstellung einer Datei bis zur Aktivierung eines Plugins – durch die Entwicklung eines einfachen “Hello World”-Plugins durchlaufen. Dieses Plugin wird eine Begrüßungsnachricht an der oberen Seite des Administrationsbrowsers der Website anzeigen.

In Ihrem Plugin-Verzeichnis…my-first-pluginIn diesem Prozess wird die Hauptdatei erstellt.my-first-plugin.phpDie grundlegende Struktur des Dateinhalts muss mit den Kommentaren am Anfang des Plugins beginnen:

<?php
/**
 * Plugin Name:       我的第一个插件
 * Plugin URI:        https://yourwebsite.com/my-first-plugin
 * Description:       这是一个用于学习插件开发的示例插件，它将在后台显示欢迎信息。
 * Version:           1.0.0
 * Author:            开发者姓名
 * Author URI:        https://yourwebsite.com
 * License:           GPL v2 or later
 * Text Domain:       my-first-plugin
 * Domain Path:       /languages
 */

Diese Kommentarzeilen sind obligatorisch. WordPress nutzt sie, um Ihre Plugins auf der “Plugins”-Verwaltungseite zu erkennen und anzuzeigen.Text DomainZur Internationalisierung (i18n) verwendet…Domain PathDer Verzeichnis, in dem sich die Sprachdateien befinden, wurde angegeben (falls erforderlich).

Als Nächstes fügen wir die Kernfunktionen hinzu. In diesem Beispiel werden wir…admin_noticesHook: Fügen Sie den folgenden Code unter die Kopf-Anmerkung hinzu:

Empfohlene Lektüre Eine vollständige Anleitung zur Entwicklung von WordPress-Plugins: Ein praktischer Leitfaden von den Grundlagen bis zur Expertenebene.。

// 使用 admin_notices 钩子在管理后台输出提示信息
add_action( ‘admin_notices’, ‘my_first_plugin_display_admin_greeting’ );

/**
 * 在管理后台显示欢迎信息的函数
 * @return void
 */
function my_first_plugin_display_admin_greeting() {
    // 检查当前用户是否有权限，确保只在后台显示
    if ( ! current_user_can( ‘manage_options’ ) ) {
        return;
    }
    ?>
    <div class="notice notice-success is-dismissible">
        <p><?php _e( ‘欢迎使用我的第一个插件！插件开发之旅正式开始！’, ‘my-first-plugin’ ); ?></p>
    </div>
    &lt;?php
}

Nachdem Sie die Datei gespeichert haben, melden Sie sich im Backend Ihrer WordPress-Website an und gehen Sie auf die Seite “Plugins”. Dort sollten Sie ein Plugin mit dem Namen “Mein erstes Plugin” in der Liste der Plugins sehen. Klicken Sie auf die Schaltfläche “Aktivieren”. Nach der Aktivierung sollten Sie, wenn Sie eine beliebige Backend-Verwaltungsseite (z. B. das Dashboard) aktualisieren, eine grüne Erfolgsmeldung sehen, die die Begrüßung enthält, die in unserem Code definiert wurde. Dies ist eine minimale, aber vollständige Funktionsumsetzung, die überprüft, ob Ihre Entwicklungsumgebung sowie die Struktur der Plugins korrekt sind.

WordPress-Kerntechnologien: Hooks und Filter

Das Verständnis und die geschickte Anwendung von Hooks ist der Kern der WordPress-Plugin-Entwicklung. Es gibt zwei Arten von Hooks: Actions und Filters. Action-Hooks ermöglichen es Ihnen, benutzerdefinierten Code zu einem bestimmten Zeitpunkt einzufügen und auszuführen – beispielsweise nach der Veröffentlichung eines Artikels oder vor dem Laden des Seitenkopfes. Den Hook, den wir oben verwendet haben…admin_noticesEs handelt sich dabei um einen Aktionshook (Action Hook). Filterhooks hingegen ermöglichen es Ihnen, Daten zu ändern, die während des Prozesses erzeugt oder übertragen werden – beispielsweise den Titel eines Artikels oder die Ergebnisse einer Plugin-Abfrage.

Wie fügt man eine benutzerdefinierte Aktion hinzu?

Die Aktion wurde erfolgreich durchgeführt.add_action()Funktion hinzufügen. Die Syntax lautet:add_action( ‘hook_name’, ‘your_function_name’, priority, accepted_args )Die Priorität (priority) ist eine Ganzzahl; je kleiner die Zahl, desto früher wird die Aktion ausgeführt. Der Standardwert beträgt 10. Zum Beispiel möchten Sie nach dem Artikelinhalt einige benutzerdefinierte HTML-Elemente hinzufügen:

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_action( ‘the_content’, ‘my_custom_content_append’ );
function my_custom_content_append( $content ) {
    // 只在单篇文章主循环内生效
    if ( is_single() && in_the_loop() && is_main_query() ) {
        $extra_content = ‘<div class="“my-custom-box”"><p>Dies ist benutzerdefinierte Inhaltsmaterial, das über einen Plugin hinzugefügt wurde.</p></div>’;
        $content .= $extra_content;
    }
    return $content;
}

Bitte beachten Sie, dass – obwohl…the_contentEs handelt sich um einen Filter – dieser muss die modifizierte Version zurückgeben.$contentWordPress nutzt dies ebenfalls als Auslösepunkt für Aktionen. Eine noch strengere Vorgehensweise wäre es, jedoch…add_filter。

Wie fügt man einen benutzerdefinierten Filter hinzu?

Der Filter funktioniert einwandfrei.add_filter()Funktion hinzufügen. Syntax undadd_action()Ähnlich. Ein häufiges Beispiel ist die Änderung der Länge von Artikelauszügen.

add_filter( ‘excerpt_length’, ‘my_custom_excerpt_length’, 999 );
function my_custom_excerpt_length( $length ) {
    // 将默认的55个词改为20个词
    return 20;
}

Sie können Ihre eigenen „Hooks“ erstellen, damit Ihre Erweiterung auch von anderen Entwicklern oder Themes erweitert werden kann.do_action()Um einen Aktionshookup zu definieren, verwenden Sie…apply_filters()Definieren Sie einen Filter-Hook – das ist der Schlüssel zur Erstellung modularer, erweiterbarer Plugins.

Empfohlene Lektüre Der komplette Leitfaden zur WordPress-Plugin-Entwicklung: Von Null bis zu fortgeschrittenen Fortschritten。

Fortgeschrittene Funktionen von Plugins und Best Practices

Wenn die Funktionen eines Plugins allmählich komplexer werden, werden eine gute Codeorganisation, Sicherheit, Wartbarkeit und Leistung von entscheidender Bedeutung. Eine gängige Vorgehensweise ist die Verwendung objektorientierter Programmierung (OOP), um die Codestruktur zu organisieren, indem relevante Funktionen und Daten in einer Hauptklasse zusammengefasst werden.

Die Kodierung wird mithilfe objektorientierter Programmierung verschlüsselt.

Es ist sinnvoll, eine Hauptklasse zu erstellen, um den Zustand und die Methoden der Plugins besser zu verwalten und Funktionsnamenkonflikte zu vermeiden. Hier ist ein einfaches Beispiel für eine OOP-Struktur:

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

<?php
/**
 * Plugin Name:       进阶示例插件
 */
if ( ! class_exists( ‘My_Advanced_Plugin’ ) ) {
    class My_Advanced_Plugin {
        /**
         * 构造方法，用于初始化钩子
         */
        public function __construct() {
            add_action( ‘init’, array( $this, ‘register_custom_post_type’ ) );
            add_action( ‘admin_menu’, array( $this, ‘add_admin_menu_page’ ) );
            add_filter( ‘the_title’, array( $this, ‘filter_post_title_prefix’ ), 10, 2 );
        }

/**
         * 注册一个自定义文章类型
         */
        public function register_custom_post_type() {
            $args = array(
                ‘public’ => true,
                ‘label’  => ‘我的产品’,
                ‘supports’ => array( ‘title’, ‘editor’, ‘thumbnail’ ),
                ‘has_archive’ => true,
            );
            register_post_type( ‘my_product’, $args );
        }

/**
         * 在文章标题前添加前缀的过滤器
         * @param string $title 原标题
         * @param int    $id    文章ID
         * @return string 修改后的标题
         */
        public function filter_post_title_prefix( $title, $id = null ) {
            if ( ! is_admin() && in_the_loop() ) {
                $title = ‘[精品] ’ . $title;
            }
            return $title;
        }

// ... 其他方法
    }
    // 实例化插件类
    new My_Advanced_Plugin();
}

Diese Struktur organisiert verwandte Funktionen zusammen, wodurch der Code klarer und leichter zu verwalten ist.

Sicherheit und Leistung der Plugins gewährleisten

Sicherheit ist die oberste Priorität bei der Entwicklung von Plugins. Vertrauen Sie niemals auf die Eingaben der Benutzer. Für alle Daten, die von den Benutzern übermittelt werden…$_GET、$_POSToder$_REQUESTDie erhaltenen Daten müssen verifiziert (Validation), gesäubert (Sanitization) und enthaltenes Sonderzeichen müssen entsprechend behandelt (Escaping) werden. WordPress bietet eine Reihe von Hilfsfunktionen dafür:
* 验证：check_ajax_referer()， wp_verify_nonce()
* 清理：sanitize_text_field()， sanitize_email()， absint()
* 转义：esc_html()， esc_url()， wp_kses_post()

Bevor Sie Daten in HTML, Attribute oder URLs ausgeben, verwenden Sie unbedingt die entsprechenden Escape-Funktionen. Was die Leistung betrifft, sollten Sie Hooks klug einsetzen, um zu vermeiden, dass ressourcenintensive Abfragen bei jedem Seitenladen ausgeführt werden. Überlegen Sie es sich, die Transients-API von WordPress zu nutzen, um nicht-kritische, wiederholbare Abfrageergebnisse für eine bestimmte Zeit zu speichern.

Implementierung der Einstellungsseite für das Plugin

Die meisten Plugins benötigen eine Einstellungsseite, auf der der Benutzer die entsprechenden Einstellungen vornehmen kann. Dies erfolgt in der Regel durch…add_options_page()oderadd_menu_page()Funktionen wie „Wait“ werden montiert (d.h. sie werden in das System eingefügt bzw. aktiviert), um bestimmte Abläufe zu steuern oder zu verarbeiten.admin_menuDie Implementierung erfolgt mithilfe von „Hooks“. Die Einstellungen sollten über die WordPress-Settings-API sicher registriert, gespeichert und überprüft werden. Dazu gehört auch die Verwendung der entsprechenden Funktionen der API.register_setting()、add_settings_section()undadd_settings_field()Funktionen wie diese sorgen nicht nur für Sicherheit (z. B. durch die Überprüfung von Nonces), sondern bieten auch ein einheitliches Erscheinungsbild der WordPress-Backend-Oberfläche.

Zusammenfassungen

Die Entwicklung von WordPress-Plugins ist ein Prozess, bei dem Kreativität in funktionale Lösungen umgewandelt wird – und dieser Prozess beginnt mit dem Verständnis der Grundstruktur von Plugins sowie der Einrichtung der lokalen Umgebung. Durch die Erstellung des einfachsten “Hello World”-Plugins haben wir den gesamten Weg von der Erstellung der Dateien bis zur Aktivierung der Funktionen praktiziert. Der Kern der Entwicklung besteht darin, das leistungsstarke Hook-System von WordPress – bestehend aus Aktionen und Filtern – gründlich zu verstehen und geschickt einzusetzen. Diese Hook-Systeme bilden die Verbindung zwischen WordPress’ Kernfunktionen und anderen Komponenten. Mit der Erweiterung der Funktionalitäten eines Plugins sind objektorientierte Programmiermethoden, die Einhaltung sicherer Kodierungsstandards (Validierung, Reinigung, Entschlüsselung von Daten) sowie die Nutzung der Settings-API zur Erstellung von Einstellseiten entscheidende Schritte, um ein stabiles, sicheres, wartbares und erweiterbares Plugin zu erstellen. Indem Sie diesen Richtlinien und besten Praktiken folgen, werden Sie in der Lage sein, hochwertige WordPress-Plugins von einfachen Tools bis hin zu komplexen Anwendungen zu entwickeln.

FAQ Häufig gestellte Fragen

Welche Vorkenntnisse sind erforderlich, um ein WordPress-Plugin für ### zu entwickeln?
Sie sollten über grundlegende Kenntnisse der PHP-Programmiersprache verfügen, da die Plugins hauptsächlich in PHP geschrieben sind. Ebenso ist ein grundlegendes Verständnis von HTML, CSS und JavaScript von Vorteil, wenn Sie Plugins mit Frontend-Interaktionen erstellen möchten. Am wichtigsten ist jedoch, dass Sie sich mit den grundlegenden Konzepten von WordPress auskennen – wie Artikeln, Seiten, Kategorien, Benutzerrollen sowie dem besonders wichtigen Hook-System.

Wie kann ich ein in Entwicklung befindliches WordPress-Plugin debuggen?

Es wird dringend empfohlen, die Funktion in der Entwicklungsumgebung zu aktivieren.WP_DEBUGDie entsprechenden Einstellungen wurden bereits im Abschnitt zur Einrichtung der Umgebung im Haupttext beschrieben. Dadurch werden PHP-Fehler, Warnungen und Benachrichtigungen in die Protokolldateien geschrieben. Darüber hinaus können Sie…error_log()Funktionen oder Hilfsfunktionen wie…var_dump()Zusammenarbeitwp_die()Um die Werte der Variablen zu überprüfen, sind die Konsole sowie die Netzwerk-Tabellen der Browser-Entwicklungstools unerlässlich. Sie helfen bei der Fehlersuche bei JavaScript- und AJAX-Anfragen.

Wie kann mein Plugin mit verschiedenen Versionen von WordPress kompatibel sein?

Im Plugin-Code solltest du überprüfen, ob bestimmte Funktionen oder Klassen in der aktuellen WordPress-Version vorhanden sind, bevor du sie verwendet. Dafür kannst du entsprechende Tests durchführen.function_exists()oderis_admin()Bedingungsprüfungen wie diese werden in der Beschreibung des Plugins durch Kommentare im Plugin-Header angegeben.Requires at least:Verwende Felder, um die minimale erforderliche WordPress-Version anzugeben. Es ist eine gute Gewohnheit, regelmäßig die Kompatibilität deines Plugins mit den neuesten Versionen des WordPress-Kerns zu testen.

Wie kann ich meine Erweiterung internationalisieren, sodass sie mehrere Sprachen unterstützt?

Sie müssen die Übersetzungsfunktionen von WordPress verwenden, um alle Textzeichenketten zu umschließen, die übersetzt werden sollen. Zum Beispiel:__( ‘文本’, ‘your-plugin-text-domain’ )Bitte geben Sie den zu übersetzenden Text an._e( ‘文本’, ‘your-plugin-text-domain’ )Es soll direkt eine Rückmeldung erfolgen. Du musst dies in den Kommentaren am Anfang des Plugins korrekt einstellen.Text DomainundDomain PathDanach wird mit einem Tool wie Poedit eine neue Übersetzung erstellt..potTemplate-Dateien – Übersetzer können darauf basierend neue Inhalte erstellen..pound.moSprachdateien.

Nach Abschluss der Entwicklung: Wie kann man das Plugin in den offiziellen Plugin-Katalog einreichen?

Zunächst musst du auf der offiziellen WordPress-Website ein Konto registrieren und das Plugin zur Überprüfung einreichen. Dein Code muss den offiziellen Kodierstandards und -richtlinien entsprechen – insbesondere hinsichtlich Sicherheit, Fehlen von bösartigem Code sowie der Kompatibilität mit der GPL-Lizenz. Die Struktur deines Plugin-Verzeichnisses sollte die Haupt-PHP-Datei sowie weitere notwendige Dateien enthalten.readme.txtDateien (in einem Format, das bestimmten Standards entspricht), sowie optionalen Screenshoten und Icons. Der Überprüfungsprozess kann etwas Zeit in Anspruch nehmen; das Team wird deinen Code überprüfen und sicherstellen, dass er den Anforderungen entspricht.