Die ultimative Anleitung zur Entwicklung von WordPress-Plugins: Der Weg vom Anfänger zum Experten in der Praxis

Um ein WordPress-Plugin zu entwickeln, ist es zunächst wichtig, dessen grundlegende Struktur zu verstehen. Ein Plugin besteht im Wesentlichen aus einer oder mehreren PHP-Dateien, die den spezifischen Spezifikationen von WordPress folgen und über das Hook-System mit dem Kern von WordPress interagieren, um die Funktionalität der Website zu erweitern oder zu ändern. Für die Entwicklung eines Plugins benötigen Sie mindestens eine Hauptdatei, die die standardmäßigen Kommentare am Anfang der Datei enthält – diese sind entscheidend dafür, dass WordPress das Plugin erkennt.

Erstellen Sie Ihr erstes Plugin.

Lassen Sie uns mit der Erstellung des einfachsten “Hello World”-Plugins beginnen. Dieser Prozess wird Ihnen dabei helfen, die Struktur von Plugins sowie die Verfahren zur Aktivierung und Deaktivierung von Plugins kennenzulernen.

Erstellen Sie die Hauptdatei des Plugins.

Zunächst einmal, im Verzeichnis Ihrer WordPress-Installation:wp-content/pluginsIm Ordner erstellen Sie einen neuen Ordner, zum Beispiel…my-first-pluginIn diesem Ordner erstellen Sie eine Datei mit dem Namenmy-first-plugin.phpDie Haupt-PHP-Datei befindet sich in dieser Datei. Der Name dieser Datei entspricht in der Regel dem Namen des Verzeichnisses.

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

Öffnenmy-first-plugin.phpDatei: Geben Sie die folgenden Standard-Plugin-Header-Informationen ein:

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

Diese Anmerkung ist von entscheidender Bedeutung. WordPress erkennt bestimmte Muster durch Scannen…wp-content/pluginssowie alle PHP-Dateien in den Unterordnern darinPlugin Name:Diese Funktion erkennt Plugins und zeigt sie auf der Backend-Plugin-Verwaltungsseite an.

Implementieren der grundlegenden Funktionen sowie der Aktivierungs-Hooks

Als Nächstes fügen wir der Erweiterung eine einfache Funktion hinzu: Eine Zeile mit benutzerdefiniertem Text wird am Fuß der Website-Seite angezeigt. Außerdem nutzen wir die Lebenszyklus-Hooks von WordPress, um zu zeigen, welche Aktionen ausgeführt werden können, wenn die Erweiterung aktiviert oder deaktiviert wird.

Unter den Kopfzeilen (Header-Comments) fügen Sie den folgenden Code hinzu:

// 定义一个函数，在页脚输出信息
function my_first_plugin_display_footer_text() {
    echo '<p style="text-align: center;">Willkommen bei der Nutzung meines ersten WordPress-Plugins!</p>';
}
// 使用 ‘wp_footer’ 动作钩子挂载我们的函数
add_action( 'wp_footer', 'my_first_plugin_display_footer_text' );

// 插件激活时执行的操作
function my_first_plugin_activate() {
    // 可能在这里创建数据库表、设置默认选项等
    update_option( 'my_first_plugin_installed', current_time( 'mysql' ) );
}
register_activation_hook( __FILE__, 'my_first_plugin_activate' );

// 插件停用时执行的操作
function my_first_plugin_deactivate() {
    // 清理临时数据，但保留可能由用户创建的数据
    delete_option( 'my_first_plugin_installed' );
}
register_deactivation_hook( __FILE__, 'my_first_plugin_deactivate' );

Melden Sie sich jetzt in Ihrem WordPress-Backend an und gehen Sie auf die Seite “Plugins”. Dort sollten Sie ein Plugin mit dem Namen “Mein erstes Plugin” sehen. Klicken Sie auf “Aktivieren”. Anschließend besuchen Sie die Frontend-Seite Ihrer Website und scrollen Sie bis zum Ende – dort sollten Sie den hinzugefügten benutzerdefinierten Text sehen. Dieses einfache Beispiel veranschaulicht den grundlegenden Ablauf vom Erstellen bis zum Betrieb eines Plugins.

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

Ein tieferes Verständnis des WordPress-Hook-Systems

Hooks sind die Grundlage für die Entwicklung von WordPress-Plugins. Sie ermöglichen es Ihnen, Ihren eigenen Code an bestimmten Stellen während der Ausführung des Kerncodes einzufügen, ohne die Kerndateien selbst ändern zu müssen. Es gibt hauptsächlich zwei Arten von Hooks: Actions und Filters.

Die Verwendung von Aktionshaken (Action Hooks)

Action Hooks werden ausgeführt, wenn bestimmte Ereignisse stattfinden – beispielsweise beim Veröffentlichen eines Artikels oder beim Laden des Kopf- oder Fußbereichs einer Seite. Sie sollen keine Werte zurückgeben, sondern lediglich einen bestimmten Codeabschnitt ausführen. Wir haben diese Funktion bereits in unserem ersten Plugin verwendet.wp_footerDieser Aktions-Hook.

Ein weiteres häufiges Beispiel ist…initEin „Hook“ ist ein Mechanismus, der bei der Initialisierung von WordPress ausgelöst wird und häufig zum Registrieren benutzerdefinierter Artikeltypen oder Kategorien verwendet wird.

function my_plugin_custom_init() {
    // 在这里注册自定义文章类型
}
add_action( 'init', 'my_plugin_custom_init' );

Aktions-Hooks werden durchadd_action( $hook_name, $function_to_add, $priority, $accepted_args )Funktionsmontage.

Verwendung von Filter-Hooks

Filter-Hooks dienen dazu, Daten zu modifizieren. Sie werden Ihnen vor der Verwendung der Daten übergeben – beispielsweise beim Speichern in einer Datenbank oder beim Ausgeben in einem Browser – und Sie geben die geänderten Werte anschließend zurück.the_contentDie Filter ermöglichen es Ihnen, den Inhalt der Artikel zu ändern.

function my_plugin_add_disclaimer_to_content( $content ) {
    if ( is_single() ) {
        $disclaimer = '<p><em>Dieser Artikel wurde von meinem Plugin verarbeitet.</em></p>';
        $content .= $disclaimer;
    }
    return $content; // 必须返回修改后的内容
}
add_filter( 'the_content', 'my_plugin_add_disclaimer_to_content' );

Die Filter-Hooks werden durchadd_filter( $hook_name, $function_to_add, $priority, $accepted_args )Funktionsmontage. Priorität$priorityEs wird die Ausführungsreihenfolge festgelegt, wenn mehrere Funktionen an denselben Hook gebunden werden. Je kleiner die Zahl ist, desto höher die Priorität.

Empfohlene Lektüre Ein Leitfaden für Anfänger zur Entwicklung von WordPress-Plugins: Erstellen Sie Ihr erstes funktionales Plugin von Grund auf.。

Best Practices für Plugin-Architektur und Sicherheit

Mit der zunehmenden Komplexität der Plugin-Funktionen sind eine gute Architektur sowie strenge Sicherheitsmaßnahmen entscheidend, um die Stabilität, Wartbarkeit und Sicherheit der Plugins zu gewährleisten.

Object-Oriented Programming (OOP) wird angewendet.

对于功能丰富的插件，建议使用类（Class）来组织代码。这有助于封装功能，避免函数名冲突，并使代码结构更清晰。

<?php
/**
 * Plugin Name: 高级示例插件
 */
if ( ! class_exists( 'Advanced_Sample_Plugin' ) ) {
    class Advanced_Sample_Plugin {
        public function __construct() {
            // 在构造函数中挂载钩子
            add_action( 'wp_footer', array( $this, 'display_message' ) );
            add_filter( 'the_title', array( $this, 'modify_title' ) );
        }

public function display_message() {
            echo &#039;<p>Botschaft aus der Kategorie „Advanced Plugins“.</p>';
        }

public function modify_title( $title ) {
            return '前缀 - ' . $title;
        }
    }
    // 初始化插件类
    new Advanced_Sample_Plugin();
}

Sichere Schutzmaßnahmen umsetzen

Die Sicherheit von WordPress-Plugins ist von entscheidender Bedeutung. Das wichtigste Prinzip lautet: Vertrauen Sie niemals den von Benutzern eingegebenen Daten. Alle Daten, die von Benutzern übermittelt werden, sollten daher sorgfältig überprüft und behandelt werden, um potenzielle Sicherheitsrisiken zu vermeiden.$_GET，$_POST，$_COOKIEAlle von überglobalen Variablen abgerufenen Daten müssen überprüft, bereinigt und entschlossen werden.

1. Überprüfung: Stellen Sie sicher, dass die Daten dem erwarteten Format entsprechen (z. B. ob es sich um eine E-Mail-Adresse oder eine Zahl handelt). Verwenden Sie dazu geeignete Methoden.sanitize_email()，is_email()Zum Beispiel können Sie die folgenden Funktionen verwenden:
2. Reinigung: Entfernen Sie ungültige oder unsichere Zeichen aus den Daten. Für Texteingaben wird dazu eine entsprechende Verarbeitungsmethode verwendet.sanitize_text_field()Für Inhalte, bei denen HTML erlaubt ist, wird folgende Methode verwendet:wp_kses_post()oderwp_kses()。
3. Entschlüsselung: Stellen Sie sicher, dass Daten beim Ausgeben in HTML, JavaScript oder URLs sicher kodiert werden. Verwenden Sie dazu geeignete Methoden zur Entschlüsselung, um Sicherheitsrisiken zu vermeiden.esc_html()，esc_js()，esc_url()Zum Beispiel können Sie die folgenden Funktionen verwenden:

Zum Beispiel: Die Verarbeitung eines Kurzzeichen-Attributs…

function my_shortcode_handler( $atts ) {
    // 使用 shortcode_atts 设置默认值并提取属性
    $atts = shortcode_atts( array(
        'url' => '#',
    ), $atts, 'my_shortcode' );

// 清理并转义 URL 属性
    $clean_url = esc_url( $atts['url'] );

return "<a href='/de/{$clean_url}/'>Sichere Links</a>"php
add_shortcode('my_shortcode', 'my_shortcode_handler');

Für das Plugin eine Verwaltungsoberfläche sowie Internationalisierung hinzufügen.

Ein ausgereiftes Plugin benötigt in der Regel Konfigurationsoptionen und sollte die Unterstützung mehrerer Sprachen berücksichtigen.

Erstellen einer Seite mit administrativen Einstellungen

Verwenden Sie die WordPress-Settings-API, um sichere, standardisierte Verwaltungsseiten zu erstellen. Dies ist die empfohlene Methode, da sie sich um die Sicherheit (Nonce-Validierung) sowie die Einheitlichkeit der Formular-UI kümmert.

Hier ist ein vereinfachtes Beispiel für die Hinzufügung eines obersten Menüs und einer Einstellungsseite:

class My_Plugin_Admin {
    public function __construct() {
        add_action( 'admin_menu', array( $this, 'add_admin_menu' ) );
        add_action( 'admin_init', array( $this, 'settings_init' ) );
    }

public function add_admin_menu() {
        add_menu_page(
            '我的插件设置', // 页面标题
            '我的插件',     // 菜单标题
            'manage_options', // 权限
            'my-plugin',      // 菜单slug
            array( $this, 'options_page_html' ) // 回调函数，输出页面内容
        );
    }

public function settings_init() {
        register_setting( 'my_plugin_settings', 'my_plugin_options' ); // 注册设置

// 添加设置区域和字段
        add_settings_section( 'my_plugin_section', '主要设置', null, 'my-plugin' );
        add_settings_field( 'api_key', 'API密钥', array( $this, 'api_key_field_html' ), 'my-plugin', 'my_plugin_section' );
    }

public function api_key_field_html() {
        $options = get_option( 'my_plugin_options' );
        ?>
        <input type='text' name='my_plugin_options[api_key]' value='<?php echo esc_attr( $options['api_key'] ?? '' ); ?>'>
        <?php
    }

public function options_page_html() {
        // 检查用户权限
        if ( ! current_user_can( 'manage_options' ) ) return;
        ?>
        <div class="wrap">
            <h1>\n</h1>
            <form action="/de/options.php/" method="post" data-trp-original-action="options.php">
                <?php
                settings_fields( 'my_plugin_settings' );
                do_settings_sections( 'my-plugin' );
                submit_button();
                ?>
            <input type="hidden" name="trp-form-language" value="de"/></form>
        </div>
        &lt;?php
    }
}
new My_Plugin_Admin();

Die Internationalisierung des Plugins umsetzen.

Damit das Plugin von Nutzern auf der ganzen Welt genutzt werden kann, muss es mehrsprachig unterstützt werden. Dies wird erreicht durch die Verwendung von…__( ‘Text’， ’text-domain’ )und_e( ‘Text’， ’text-domain’ )Die Übersetzungsfunktionen umfassen den gesamten für die Benutzer sichtbaren Text, um die Übersetzung zu realisieren. Das hast du zuvor in den Kommentaren am Anfang des Plugins definiert.Text Domain: my-first-pluginGenau dafür wurde es vorbereitet.

1. In Ihrem Code sollten Sie für alle zu übersetzenden Zeichenketten die entsprechende Übersetzungsfunktion verwenden.

    echo __( ‘欢迎使用我的插件！’， ‘my-first-plugin’ );
    $title = esc_html__( ‘设置页面’， ‘my-first-plugin’ );

2. Verwenden Sie Tools wie Poedit, um die Übersetzungsstrings im Plugin-Code zu scannen und eine Übersetzungsdatenbank zu erstellen..potTemplate-Dateien. Die Übersetzer erstellen basierend darauf die entsprechenden Dateien für jede Sprache..poUnd das kompilierte….moDateien (wie)zh_CN.po/mo）。
3. Legen Sie diese Sprachdateien im Plugin-Verzeichnis ab.languagesIm Ordner befinden sich die Übersetzungen. WordPress lädt automatisch die entsprechenden Übersetzungen nach den Spracheinstellungen der Website herunter.

Zusammenfassungen

Die Entwicklung von WordPress-Plugins ist ein Prozess, der von einfachen Skripten bis hin zu komplexen Anwendungen reicht. Der Schlüssel dazu liegt darin, das Hook-System zu verstehen und geschickt zu nutzen, um Ihre Funktionen nahtlos in den Lebenszyklus von WordPress zu integrieren – mithilfe von Aktionen (Actions) und Filtern (Filters). Die Einhaltung objektorientierter Architekturprinzipien verbessert die Struktur und Wartbarkeit des Codes. Sicherheit ist die Grundlage jeder Entwicklung: Jede Benutzereingabe muss überprüft, gereinigt und die Ausgabe entsprechend formatiert werden. Abschließend erstellen Sie eine professionelle Backend-Oberfläche über die Settings-API und nutzen internationale Funktionen, um Ihr Plugin weltweit verfügbar zu machen. Beginnen Sie mit der Entwicklung eines einfachen Plugins – es ist der ideale Einstieg in die Welt der WordPress-Plugin-Entwicklung.my-first-plugin.phpFang an, diese Konzepte schrittweise in die Praxis umzusetzen – so wirst du in der Lage sein, leistungsstarke, sichere und beliebte WordPress-Plugins zu entwickeln.

FAQ Häufig gestellte Fragen

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

Sie müssen die PHP-Programmiersprache beherrschen, da die Plugins hauptsächlich in PHP geschrieben sind. Außerdem sollten Sie über grundlegende Kenntnisse von HTML, CSS und JavaScript verfügen, um Benutzeroberflächen und Interaktionen zu erstellen. Am wichtigsten ist es, die grundlegenden Funktionsweisen von WordPress zu verstehen – insbesondere Themen, Hooks, Schleifen und Methoden der Datenspeicherung.

Kann ich das Plugin lokal testen, ohne dass es die Online-Website beeinträchtigt?

Auf jeden Fall – und das wird sogar stark empfohlen. Du solltest die Entwicklung der Plugins in deiner lokalen Entwicklungsumgebung (z. B. mit Tools wie XAMPP, MAMP oder Local by Flywheel) oder auf einem separaten Testserver durchführen. So kannst du vermeiden, dass Fehler im Code dazu führen, dass die Online-Website abstürzt oder Daten verloren gehen.

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

WordPress bietet eine Vielzahl an Debugging-Tools. Zunächst einmal…wp-config.phpAktivieren des Debugging-Modus im File: DefinitionWP_DEBUGKonstanten sind…truePHP-Fehler, Warnungen und Benachrichtigungen werden direkt auf der Seite angezeigt. Für eine umfassendere Fehlersuche kann man weitere Werkzeuge verwenden.error_log()Die Funktion schreibt die Informationen in das Server-Fehlerprotokoll oder verwendet spezielle Debugging-Plugins wie Query Monitor, die detaillierte Informationen zu Datenbankabfragen, Hooks und PHP-Fehlern liefern können.

Nach der Fertigstellung des Plugins: Wie kann es in das offizielle WordPress-Verzeichnis eingereicht werden?

Sie müssen auf WordPress.org zugreifen und dort ein Konto erstellen. Anschließend müssen Sie Ihre Plugin-Code mit dem Subversion (SVN)-Tool in das von WordPress bereitgestellte SVN-Repository übertragen. Vor der Übertragung stellen Sie sicher, dass der Plugin-Code den offiziellen Entwicklungsstandards und -richtlinien für Plugins entspricht – einschließlich Aspekten wie Sicherheit, Codequalität, Dokumentation und Internationalisierung. Nach der Genehmigung wird Ihr Plugin im offiziellen Verzeichnis veröffentlicht und dort für Nutzer zum Herunterladen und Installieren zur Verfügung gestellt.