Vom Nullen zum Einzelnen: Eine Schritt-für-Schritt-Anleitung, um die Kerntechniken der WordPress-Plugin-Entwicklung zu erlernen

Willkommen in der wunderbaren Welt der WordPress-Plugin-Entwicklung. Als weltweit beliebtestes Content-Management-System zeichnet sich WordPress durch seine hohe Erweiterbarkeit aus – und genau Plugins sind der Schlüssel zu dieser Erweiterbarkeit. Egal, ob Sie Lösungen für spezifische Funktionen entwickeln möchten oder Ihre Ideen in Produkte umsetzen, die andere nutzen können: Die Fähigkeit, Plugins zu erstellen, ist eine äußerst wertvolle Fertigkeit. Dieser Artikel führt Sie Schritt für Schritt von der Einrichtung der grundlegendsten Umgebung bis hin zur Erstellung Ihres ersten voll funktionsfähigen Plugins.

Die grundlegende Struktur und Funktionsweise von WordPress-Plugins

Bevor Sie mit dem Schreiben des Codes beginnen, ist es von entscheidender Bedeutung, die Struktur eines Plugins sowie dessen Funktionsweise in WordPress zu verstehen. Ein Plugin besteht im Grunde aus einer oder mehreren PHP-Dateien, die über die von WordPress bereitgestellte API (Application Programming Interface) mit dem Kernsystem interagieren.

Die Kerndatei des Plugins

Jeder Plugin muss eine Hauptdatei haben. Diese Hauptdatei trägt in der Regel den Namen des Plugins. my-first-plugin.phpAm Anfang dieses Files muss ein bestimmter Plugin-Hauptkommentar enthalten sein. WordPress erkennt und zeigt Plugins an, indem es diese Informationen liest.

Empfohlene Lektüre Kompletter Leitfaden für die Entwicklung von WordPress-Plugins: Von Grundlagen bis zur Meisterschaft in der Praxis。

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

Diese Anmerkung definiert Metadaten wie den Namen, die Beschreibung und die Version des Plugins in der Backend-Verwaltungsoberfläche. Ohne diese Metadaten kann WordPress das Plugin nicht erkennen.

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

Hook-Mechanism: Die Brücke zwischen Plugins und dem Kernsystem

Der Kernantrieb von WordPress ist das “Hook”-System, das es Plugins ermöglicht, zu bestimmten Zeitpunkten ihren eigenen Code einzufügen, um das Standardverhalten zu ändern oder zu erweitern. Es gibt hauptsächlich zwei Arten von Hooks: Aktionen (Actions) und Filter (Filters).

Action Hooks ermöglichen es Ihnen, benutzerdefinierten Code auszuführen, wenn bestimmte Ereignisse stattfinden – beispielsweise nach der Veröffentlichung eines Artikels, beim Einloggen eines Benutzers oder vor dem Laden einer Seite. add_action() Eine Funktion, die Ihre eigene Funktion mountet.

Filter-Hooks ermöglichen es Ihnen, Daten zu ändern. Bevor die Daten an die Datenbank oder in den Browser gesendet werden, können Sie sie abfangen und bearbeiten. Dies wird durch… add_filter() Sie werden von Funktionen implementiert. Das Verständnis und die geschickte Nutzung dieser beiden Hooks bilden die Grundlage für die Entwicklung fortgeschrittener Plugins.

Aufbau der Entwicklungsumgebung und das Erste Plugin

Bevor Sie mit dem Kodieren beginnen, ist eine zuverlässige lokale Entwicklungsumgebung unerlässlich. Sie ermöglicht es Ihnen, Tests und Fehlersuche unbeschwert durchzuführen, ohne die Online-Website zu beeinträchtigen.

Empfohlene Lektüre Technischer Leitfaden für den gesamten Prozess des Webseitenbaus: Praxis und Optimierungsstrategien von der Grundlage bis zur Live-Veröffentlichung。

Konfigurieren Sie die lokale Entwicklungsumgebung.

Es wird empfohlen, integrierte lokale Serverlösungen wie Local by Flywheel, XAMPP oder MAMP zu verwenden. Diese Tools ermöglichen die einstufige Installation der für WordPress erforderlichen PHP-, MySQL- und Webserverumgebungen. Nach der Installation können Sie eine neue WordPress-Website erstellen, die für die Entwicklung von Plugins genutzt werden kann.

Erstellen und aktivieren Sie ein einfaches Plugin.

Auf Ihrer lokalen WordPress-Website… wp-content/plugins Erstellen Sie unter dem Verzeichnis einen neuen Ordner, zum Beispiel my-first-pluginIn diesem Ordner erstellen Sie die Hauptdatei. my-first-plugin.phpUnd fügen Sie die oben erwähnten Kommentare zum Plugin-Header hinzu.

Nachdem Sie die Datei gespeichert haben, melden Sie sich in Ihrem WordPress-Backend an und gehen Sie zum Menü “Plugins”. Dort sollten Sie “Mein erstes Plugin” in der Liste der Plugins sehen. Klicken Sie auf “Aktivieren”, und Ihr erstes Plugin ist nun aktiv und kann verwendet werden! Obwohl es derzeit keine Funktionen bietet, haben Sie erfolgreich den grundlegenden Rahmen für das Erstellen eines Plugins erstellt.

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

Implementierung der Kernfunktionen sowie Sicherheitspraktiken

Der Sinn eines Plugins liegt in seiner Funktion. Lassen Sie uns dem Plugin eine einfache, aber praktische Funktion hinzufügen: Es soll automatisch einen benutzerdefinierten Text am Ende des Artikelinhalts einfügen.

Die Inhalte eines Artikels mit einem Filter ändern.

Wir werden dies nutzen. the_content Dieser Filter-Hook: Fügen Sie den folgenden Code in die Hauptdatei Ihres Plugins hinzu:

function myplugin_add_text_to_content( $content ) {
    // 检查是否为单篇文章页面
    if ( is_single() ) {
        $custom_text = '<p><em>Vielen Dank fürs Lesen! Dieser Artikel wurde durch meine erste Erweiterung hinzugefügt.</em></p>'if ( ! function_exists( 'myplugin_add_text_to_content' ) ) {  
    function myplugin_add_text_to_content( $content ) {  
        $custom_text = get_option( 'myplugin_custom_text' );  
        if ( ! empty( $custom_text ) ) {  
            $content .= "\n';  
            $content .= $custom_text;  
        }  
        return $content;  
    }  
    add_filter( 'the_content', 'myplugin_add_text_to_content' );  
};

Dieser Code definiert eine Funktion. myplugin_add_text_to_contentEs empfängt den Inhalt der Artikel. $content Als Parameter. Im Inneren der Funktion wird dieser Parameter verwendet. is_single() Verwenden Sie Bedingungsschaltungen, um sicherzustellen, dass der Text nur auf der Seite eines einzelnen Artikels angezeigt wird. Zum Schluss… add_filter() Mount this function to… the_content Der Text wird nun im Filter gespeichert. Speichern Sie die Datei und aktualisieren Sie die Seite des Blogartikels – dann sollten Sie den hinzugefügten Text sehen.

Empfohlene Lektüre Ich zeige Ihnen Schritt für Schritt, wie Sie von Grund auf eine professionelle, unabhängige WooCommerce-Webseite erstellen können.。

Grundlegende Überlegungen zur Sicherheit von Plugins

Sicherheit ist von größter Bedeutung bei der Entwicklung von Plugins. Vertrauen Sie niemals blind auf die Eingaben der Benutzer oder die Daten der Website.
1. 转义输出：当将任何数据输出到浏览器时，必须进行转义，以防止跨站脚本（XSS）攻击。WordPress 提供了如 esc_html(), esc_attr(), esc_url() Dazu gehören auch Hilfsfunktionen.
2. 验证和清理输入：对于从用户表单或 URL 参数接收的数据，在使用前必须进行验证（检查格式是否正确）和清理（移除非法字符）。可以使用函数如 sanitize_text_field()。
3. 非现安全：如果你的插件涉及数据修改（如保存设置），必须使用 WordPress 的非现（Nonce）机制来验证请求的意图，防止跨站请求伪造（CSRF）攻击。

Eine Verwaltungsoberfläche für das Plugin hinzufügen

Die meisten Plugins benötigen eine Einstellungsseite, die von den Benutzern konfiguriert werden kann. Wir werden eine einfache Optionenseite erstellen, die es den Benutzern ermöglicht, den Text anzupassen, der am Ende des Artikels angezeigt werden soll.

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

Erstellen Sie ein Verwaltungsmenü und -seite.

Wir können es verwenden. add_menu_page() oder add_options_page() Eine Funktion, die ein Menüelement in das WordPress-Backend hinzufügt. Der folgende Code erstellt eine Seite mit Optionen, die sich unter dem Untermenü “Einstellungen” befindet:

function myplugin_add_admin_menu() {
    add_options_page(
        '我的插件设置',          // 页面标题
        '我的插件',              // 菜单标题
        'manage_options',        // 所需权限
        'myplugin-settings',     // 菜单Slug
        'myplugin_render_settings_page' // 用于渲染页面的回调函数
    );
}
add_action( 'admin_menu', 'myplugin_add_admin_menu' );

Als Nächstes müssen wir die Callback-Funktion definieren. myplugin_render_settings_page Hier ist der HTML-Code für die Einstellungsseite sowie die Logik zur Speicherung der Formulare. Die Optionen werden sicher mithilfe der WordPress Settings-API verarbeitet; als Einstiegsbeispiel wird jedoch eine vereinfachte Version bereitgestellt:

function myplugin_render_settings_page() {
    ? >
    <div class="wrap">
        <h2>Meine Plugin-Einstellungen</h2>
        <form action="/de/options.php/" method="post" data-trp-original-action="options.php">
            <?php settings_fields( 'myplugin_settings_group' ); ?>
            <label for="custom_text">Benutzerdefinierter Text:</label><br/>
            <textarea id="custom_text" name="myplugin_custom_text" rows="4" cols="50"><?php echo esc_textarea( get_option( 'myplugin_custom_text' ) ); ?></textarea>
            <p class="submit">
                <input type="submit" name="submit" class="button-primary" value="Änderungen speichern" />
            </p>
        <input type="hidden" name="trp-form-language" value="de"/></form>
    </div>
    &lt;?php
}

Registrierungseinstellungen vornehmen und Daten verarbeiten.

Wir müssen eine Einstellungsoption registrieren und sicherstellen, dass sie sicher gespeichert wird. Dies erfolgt in der Regel bei der Initialisierung des Plugins:

function myplugin_register_settings() {
    register_setting(
        'myplugin_settings_group', // 设置分组
        'myplugin_custom_text',    // 选项名称
        'sanitize_textarea_field'  // 清理回调函数
    );
}
add_action( 'admin_init', 'myplugin_register_settings' );

Zum Schluss ändern Sie die Funktion, mit der der Artikelinhalt hinzugefügt wurde, und wählen Sie die Datenbankoptionen aus. myplugin_custom_text Die gespeicherte Textdatei des Benutzers wird gelesen, anstatt auf fest eingebetteten (härt gekodierten) Text zu zurückzugreifen.

Zusammenfassungen

Dieser Artikel hat Sie auf eine “von Null bis Eins”-Reise durch die Entwicklung von WordPress-Plugins mitgenommen. Wir haben mit dem Verständnis der grundlegenden Struktur von Plugins sowie des Hook-Mechanismus im Kern von WordPress begonnen, schrittweise eine lokale Entwicklungsumgebung eingerichtet, das erste Plugin erstellt und aktiviert. Anschließend haben wir anhand eines Beispiels, bei dem Text zu Artikeln hinzugefügt wurde, gelernt, wie Filter verwendet werden, und auf Sicherheitspraktiken hingewiesen. Zum Schluss haben wir der Plugin eine konfigurierbare Verwaltungsseite hinzugefügt.

Nachdem du diese Kernfähigkeiten erlernt hast, verfügst du über die Grundlagen, um tiefer in die Entwicklung von WordPress-Plugins einzutauchen. Als Nächstes kannst du fortgeschrittene Themen wie benutzerdefinierte Artikeltypen, Metadaten (Meta Box), Shortcodes, REST-API-Endpunkte sowie Ajax-Aufrufe untersuchen, um so WordPress-Plugins mit komplexeren Funktionen und mehr Leistung zu erstellen.

FAQ Häufig gestellte Fragen

Welche Vorkenntnisse sind erforderlich, um Plugins zu entwickeln?

Sie sollten über grundlegende Kenntnisse der PHP-Programmiersprache verfügen, da sowohl der Kern von WordPress als auch seine Plugins in PHP geschrieben sind. Ebenfalls hilfreich ist ein Verständnis von HTML, CSS und grundlegenden JavaScript-Funktionen – insbesondere wenn Sie Benutzeroberflächen erstellen müssen. Ein Verständnis der grundlegenden Konzepte von MySQL-Datenbanken ist außerdem von Vorteil.

Wie füre ich den Code meines Plugins zum Debuggen ein?

Die am häufigsten verwendete Debugging-Methode bei der Entwicklung mit WordPress ist die Aktivierung von… WP_DEBUGSie können dies auf der Website tun. wp-config.php In der Datei wird Folgendes festgelegt: define(‘WP_DEBUG’， true); Ändern Sie den Wert in dieser Zeile auf… trueDies wird alle PHP-Fehler, Warnungen und Benachrichtigungen auf dem Bildschirm anzeigen und in eine Protokolldatei aufzeichnen. Darüber hinaus wird… error_log() Es ist auch eine sehr praktische Debugging-Methode, wenn eine Funktion die Variableninformationen in das Fehlerprotokoll des Servers schreibt.

Wie sollte meine Erweiterung die Unterstützung für mehrere Sprachen handhaben?

Um dein Plugin internationalisieren zu können, musst du die Übersetzungsfunktionen von WordPress verwenden (z. B. __()， _e()Alle für die Benutzer bestimmten Zeichenketten sollen mit einer bestimmten Schicht umhüllt werden. Anschließend wird mit einem Tool wie Poedit eine Übersetzung erstellt. .pot Template-Dateien – Übersetzer können darauf basierend Übersetzungen in verschiedenen Sprachen erstellen. .po und .mo Schließlich wird die Datei im Hauptdatei des Plugins verwendet. load_plugin_textdomain() Eine Funktion, die die Übersetzungsdateien lädt.

Nach Abschluss der Entwicklung: Wie kann man den Plugin in das offizielle Verzeichnis einreichen?

Zuerst stellen Sie sicher, dass Ihr Plugin vollständig den offiziellen WordPress-Codestandards sowie der GPL-Lizenz entspricht. Anschließend beantragen Sie auf WordPress.org einen SVN-Repository für Ihr Plugin. Sie müssen die Quellcode Ihres Plugins mithilfe von SVN-Tools in diesen Repository hochladen. /trunk 目录。同时，准备高质量的 readme.txt Dateien, Screenshoten der Plugins sowie deren Icons. Nach der Einreichung überprüft das offizielle Review-Team dein Plugin. Sobald es genehmigt wird, kann es im offiziellen Verzeichnis veröffentlicht werden.