Vom Nullpunkt an: Das ultimative Handbuch und Praxislehrbuch für die Entwicklung von WordPress-Plugins

Die Kernkonzepte der WordPress-Plugin-Entwicklung

Bevor man sich tief in die Code-Struktur einarbeitet, ist es von entscheidender Bedeutung, die grundlegenden Prinzipien von WordPress-Plugins zu verstehen. Ein WordPress-Plugin ist im Grunde genommen ein PHP-Skript oder eine Sammlung von Skripten, das die Kernfunktionen von WordPress durch das standardisierte WordPress-Hook-System erweitert oder modifiziert. Der Schlüssel dazu liegt darin, nahtlos in den Ablauf von WordPress integriert zu werden, ohne dass die Kerndateien direkt geändert werden müssen.

Eine „Kerndatei“ bezieht sich auf eine PHP-Datei, die bestimmte Kommentare im Dateihaupt („File Header“) enthält. Diese Kommentare dienen dazu, dass WordPress einen Plugin erkennen kann. Zum Beispiel ist die Hauptdatei eines grundlegenden Plugins eine solche Kerndatei. my-first-plugin.php Der Anfang muss die folgenden Informationen enthalten:

<?php
/**
 * Plugin Name: 我的第一个插件
 * Description: 这是一个用于演示的简单WordPress插件。
 * Version: 1.0.0
 * Author: 你的名字
 */

Sobald diese Datei an der gewünschten Stelle platziert wird… /wp-content/plugins/ Im Verzeichnis kann die “Plugins”-Seite im WordPress-Backend dieses Plugin erkennen und auflisten.

Empfohlene Lektüre Komplettanleitung zur Entwicklung von WordPress-Themen: Erstellen Sie professionelle Website-Themen von Grund auf。

Das Betriebsmechanismus von Plugins basiert auf zwei zentralen Konzepten: Action Hooks und Filter Hooks. Action Hooks ermöglichen es Ihnen, Ihren eigenen Code zu bestimmten Zeitpunkten während der Ausführung von WordPress einzufügen – beispielsweise nach der Veröffentlichung eines Artikels oder vor dem Laden der Stylesheets im Seitenkopf. Dazu werden Funktionen verwendet. add_action() Es ist möglich, Ihre Funktionen an diese “Hook-Points” anzubinden. Die Filter-Hook-Points ermöglichen es Ihnen, die Daten zu ändern, bevor sie verwendet oder in die Datenbank gespeichert werden – beispielsweise den Inhalt, den Titel oder einen Auszug eines Artikels. Dies wird durch… add_filter() Die Funktionalität wird durch die Implementierung von Funktionen erreicht. Das Verständnis und die geschickte Anwendung des Hook-Systems ist ein entscheidender Schritt, um von einem WordPress-Nutzer zu einem Entwickler zu werden.

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 Funktions-Plugin.

Lassen Sie uns mit einem praktischen und nützlichen Beispiel beginnen: Die Erstellung eines Plugins, das automatisch eine Urheberrechtsangabe am Ende der Webseitenartikel hinzufügt. Dieser Prozess umfasst die Erstellung des Plugins, die Verwendung von Filter-Hooks sowie die grundlegende Einrichtung der Plugin-Optionen.

Zunächst einmal, in Ihrer lokalen oder Testumgebung… /wp-content/plugins/ Erstellen Sie in dem Verzeichnis ein neues Verzeichnis und nennen Sie es „…“ (füllen Sie das Leerzeichen mit dem gewünschten Namen aus). my-copyright-noticeIn diesem Ordner erstellen Sie die Haupt-Plugin-Datei. my-copyright-notice.phpUnd schreiben Sie den folgenden Code dazu:

<?php
/**
 * Plugin Name: 文章版权声明
 * Description: 自动在文章内容末尾附加自定义版权声明。
 * Version: 1.0.0
 * Author: 开发者
 */

// 防止直接访问
if ( ! defined( 'ABSPATH' ) ) {
    exit;
}

/**
 * 在文章内容后追加版权声明
 */
function mycn_add_copyright_to_content( $content ) {
    // 确保只在主循环的单篇文章中显示
    if ( is_single() && in_the_loop() && is_main_query() ) {
        $site_url = get_site_url();
        $current_year = date( 'Y' );
        // 构建版权文本，这里用 2026 作为示例，实际开发可动态获取
        $copyright_text = sprintf(
            &#039;<p><em>© 2026 %s. Dieser Text wurde von… <strong>%s</strong> Original – Bitte geben Sie die Quelle an, wenn Sie etwas weiterverbreiten.</em></p>',
            esc_html( get_bloginfo( 'name' ) ),
            esc_url( $site_url )
        );
        $content .= $copyright_text;
    }
    return $content;
}
// 将函数挂载到 ‘the_content’ 过滤器
add_filter( 'the_content', 'mycn_add_copyright_to_content' );

Dieses Plugin demonstriert die grundlegende Verwendung von Filtern.mycn_add_copyright_to_content Die Funktion nimmt den Inhalt des Artikels entgegen. $contentDurch bedingte Abfragen wird sichergestellt, dass die Urheberrechtsangaben nur auf der Seite eines einzelnen Artikels und nur im Rahmen der Hauptabfrage hinzugefügt werden. Anschließend wird der Inhalt modifiziert und zurückgegeben.add_filter( ‘the_content’， ‘mycn_add_copyright_to_content’ ) Diese Zeile von Code führt die Einbettung der Funktion durch.

Für das Plugin wird eine Verwaltungsoberfläche sowie weitere Optionen hinzugefügt.

Ein ausgereiftes Plugin sollte in der Regel es den Nutzern ermöglichen, eigene Einstellungen vorzunehmen. Dies wird durch die Erstellung von Optionenseiten im WordPress-Backend erreicht. Wir werden dem oben genannten Copyright-Plugin eine Einstellungsseite hinzufügen, über die die Nutzer den Copyright-Text anpassen können.

Empfohlene Lektüre Wie Sie ein WordPress-Theme mit einzigartigen Funktionen und herausragendem Design an professionelle Anforderungen anpassen。

Zunächst müssen wir eine Funktion erstellen, um ein Menüelement für die Einstellungen zu registrieren. Dies wird in der Regel beim Initialisieren des Administrators durchgeführt.

Bitte korrigieren Sie Ihren Text, damit er klar und verständlich ist. Falls Sie Hilfe bei der Übersetzung benötigen, geben Sie den genauen Inhalt an. my-copyright-notice.php Fügen Sie den folgenden Code zum Dateiinhalt hinzu:

// 添加管理员菜单
function mycn_add_admin_menu() {
    add_options_page(
        '版权声明设置', // 页面标题
        '文章版权',     // 菜单标题
        'manage_options', // 权限
        'my_copyright_notice', // 菜单slug
        'mycn_settings_page_html' // 回调函数，用于输出页面HTML
    );
}
add_action( 'admin_menu', 'mycn_add_admin_menu' );

// 初始化插件的设置
function mycn_settings_init() {
    // 注册一个新的设置项到 ‘mycn_settings’ 组
    register_setting( ‘mycn_settings’, ‘mycn_copyright_text’ );

// 在 ‘mycn_settings’ 组内添加一个设置区块
    add_settings_section(
        ‘mycn_settings_section’,
        ‘自定义版权文本’,
        null, // 可选的区块描述回调函数
        ‘mycn_settings’
    );

// 向区块中添加字段
    add_settings_field(
        ‘mycn_copyright_field’,
        ‘版权声明’,
        ‘mycn_copyright_field_html’,
        ‘mycn_settings’,
        ‘mycn_settings_section’
    );
}
add_action( ‘admin_init’， ‘mycn_settings_init’ );

// 设置字段的HTML输出
function mycn_copyright_field_html() {
    $option = get_option( ‘mycn_copyright_text’， ‘© 2026 [site_name]. 本文原创自 [site_url]。’ );
    ?>
    <textarea name="‘mycn_copyright_text’" rows="‘5’" cols="‘50’"><?php echo esc_textarea( $option ); ?></textarea>
    <p class="“description”">Es werden Kurzzeichen unterstützt: [site_name] für den Namen der Website und [site_url] für die Website-Adresse.</p>
    <?php
}

// 设置页面的HTML结构
function mycn_settings_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( ‘mycn_settings’ );
            do_settings_sections( ‘mycn_settings’ );
            submit_button();
            ?>
        <input type="hidden" name="trp-form-language" value="de"/></form>
    </div>
    &lt;?php
}

Als Nächstes müssen wir die vorherigen Änderungen überarbeiten. mycn_add_copyright_to_content Die Funktion soll so verwendet werden, dass sie die von den Benutzern gespeicherten Einstellungen heranzieht und den darin enthaltenen Kurzcodes ersetzt.

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

function mycn_add_copyright_to_content( $content ) {
    if ( is_single() && in_the_loop() && is_main_query() ) {
        $text = get_option( ‘mycn_copyright_text’， ‘© 2026 [site_name]. 本文原创自 [site_url]。’ );
        $text = str_replace(
            array( ‘[site_name]’， ‘[site_url]’ ),
            array( esc_html( get_bloginfo( ‘name’ ) )， esc_url( get_site_url() ) ),
            $text
        );
        $content .= ‘<p><em>’ . wp_kses_post( $text ) . ‘</em></p>’;
    }
    return $content;
}

Jetzt können Benutzer im “Einstellungen”-Menü im WordPress-Backend das Untermenü “Artikelurheberrechte” sehen und dort den eigenen Text für die Urheberrechtsangabe anpassen.

Best Practices für die Sicherheit, das Debuggen und die Internationalisierung von Plugins

Beim Entwicklung eines Plugins für die Nutzung durch andere muss man auf Sicherheit, Stabilität und Wartbarkeit achten. Hier sind einige wichtige Best Practices:

Sicherheit: Vertrauen Sie niemals den von Benutzern eingegebenen Daten. Alle Daten, die von Benutzern, der Datenbank oder Drittanbieter-APIs stammen, müssen vor der Ausgabe auf dem Bildschirm, der Eintragung in die Datenbank oder der Verwendung für Dateioperationen entsprechend entschärft oder gereinigt werden. WordPress bietet eine Vielzahl von Sicherheitsfunktionen – beispielsweise zur Behandlung von HTML-Daten. esc_html()Für die Verwendung von URLs… esc_url()Für die Verwendung von HTML-Attributen… esc_attr()Wenn es notwendig ist, bestimmte sichere HTML-Tags zuzulassen, sollte dies entsprechend erfolgen. wp_kses_post() oder wp_kses()Am Anfang des Plugins müssen Sie unbedingt… if ( ! defined( ‘ABSPATH’ ) ) exit; Damit verhindert man, dass auf die Dateien direkt zugegriffen werden kann.

Empfohlene Lektüre Vollständiger Leitfaden zur WordPress-Plugin-Entwicklung: von den Grundlagen bis zur praktischen Veröffentlichung im Store。

Debugging: Aktivieren während des Entwicklungsprozesses. WP_DEBUG Konstanten sind von entscheidender Bedeutung. In Ihrem… wp-config.php Einstellungen im File define( ‘WP_DEBUG’， true);Dies wird alle PHP-Fehler, Warnungen und Benachrichtigungen auf dem Bildschirm anzeigen (nur in der Entwicklungsumgebung). Gleichzeitig wird dies in Kombination mit anderen Funktionen verwendet. error_log() Funktionen sowie Debugging-Tools wie Query Monitor können Ihnen dabei sehr helfen, Variablen und SQL-Abfragen nachzuvollziehen.

Übersetzungsvorbereitung (Internationalisierung/i18n): Damit Ihr Plugin von Nutzern auf der ganzen Welt verwendet werden kann, sollten alle nutzerorientierten Zeichenketten für die Übersetzung vorbereitet sein. Das bedeutet, dass keine hartcodierten chinesischen oder englischen Texte verwendet werden, sondern die Übersetzungsfunktionen von WordPress genutzt werden.

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

Beispielsweise: Ändern Sie die vorherigen Informationen zum Plugin wie folgt:

/**
 * Plugin Name: 文章版权声明
 * Description: 自动在文章内容末尾附加自定义版权声明。
 * Version: 1.0.0
 * Author: 开发者
 * Text Domain: my-copyright-notice
 */

In dem Code werden übersetzbare Zeichenketten mit < __( ‘string’， ‘text-domain’ ) oder _e( ‘string’， ‘text-domain’ ) Funktionsverpackung. Zum Beispiel bei der Definition von Seitenfunktionen:

function mycn_settings_page_html() {
    if ( ! current_user_can( ‘manage_options’ ) ) {
        return;
    }
    ?>
    <div class="“wrap”">
        <h1><?php echo esc_html( __( ‘版权声明设置’， ‘my-copyright-notice’ ) ); ?></h1>
        ...
    </div>
    &lt;?php
}

Danach kannst du Tools wie Poedit verwenden, um diese Zeichenketten zu extrahieren und daraus neue Inhalte zu erstellen. .pot Vorlagen-Dateien, die Übersetzer zum Erstellen verwenden können. .po/.mo Sprachdateien.

Zusammenfassungen

Die Entwicklung von WordPress-Plugins ist ein Prozess, bei dem Kreativität in funktionale Lösungen umgewandelt wird, die tief in das weltweit beliebteste Content-Management-System integriert werden. Beginnen Sie mit dem Verständnis des Kernmechanismus der „Hooks“ – so können Sie schnell mit der Erstellung einfacher Funktionen beginnen. Die Erstellung einer Verwaltungsoberfläche und von Optionen für Ihr Plugin erhöht dessen Professionalität und Nutzbarkeit. Die Einhaltung von Best Practices in Bezug auf Sicherheit, Debuggbarkeit und Internationalisierung ist entscheidend, um sicherzustellen, dass Ihr Plugin stabil, sicher und leicht zu verbreiten ist. Denken Sie daran: Die beste Lernmethode ist die praktische Umsetzung – starten Sie mit einer konkreten Anforderung und entwickeln Sie Ihr Plugin schrittweise weiter.

FAQ Häufig gestellte Fragen

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

Sie benötigen eine solide Grundlage in der PHP-Programmierung, da die Plugins hauptsächlich in PHP geschrieben sind. Außerdem sollten Sie über grundlegende Kenntnisse von HTML, CSS und JavaScript verfügen, um die Frontend-Ausgabe sowie die Verwaltung von Benutzeroberflächen zu gestalten. Ein Verständnis der grundlegenden Architektur von WordPress – einschließlich Themes, Artikeltypen, Kategorien sowie insbesondere des Systems von Aktionen- und Filter-Hooks – ist unerlässlich.

Wie fange ich an, ein nicht funktionierendes Plugin zu debuggen?

Zunächst einmal, in deinem… wp-config.php Aktiviert im File. WP_DEBUG und WP_DEBUG_LOGDies wird die Fehlermeldung in eine Protokolldatei schreiben, anstatt sie den Besuchern anzuzeigen. Zweitens stellen Sie sicher, dass Ihr Plugin aktiviert ist. Überprüfen Sie anschließend die Syntax des Codes und stellen Sie sicher, dass alle Funktionsnamen, Hook-Names sowie Dateipfade korrekt sind. var_dump() oder error_log() Entfernen Sie die Werte der Schlüsselvariablen oder installieren Sie ein professionelles WordPress-Debugging-Plugin (z. B. Query Monitor), um die Probleme zu ermitteln.

In welchem Ordner sollte meine Erweiterung platziert werden?

Ihr Plugin muss im Installationsverzeichnis von WordPress platziert werden. /wp-content/plugins/ Im Verzeichnis. Du kannst direkt in diesem Verzeichnis eine PHP-Datei erstellen (geeignet für minimalistische Plugins), aber es ist üblicher, für dein Plugin ein eigenes Verzeichnis zu erstellen und die Hauptdatei sowie weitere Ressourcen-Dateien (wie JS, CSS, Bilder) in dieses Verzeichnis zu legen. Die Namen des Verzeichnisses und der Haupt-PHP-Datei sollten eindeutig sein, um Konflikte mit anderen Plugins zu vermeiden.

Wie kann ich meine Erweiterung in das offizielle WordPress-Plugin-Verzeichnis einreichen?

Zunächst müssen Sie sich bei WordPress.org registrieren und Ihr Plugin einreichen. Der Code Ihres Plugins muss den offiziellen Code-Standards entsprechen, einschließlich Sicherheitsaspekten, fehlendem bösartigem Code sowie geeigneten Kommentaren in den Datei-Headern. Sie müssen außerdem einen gültigen… readme.txt Die Datei entspricht den offiziellen Anforderungen hinsichtlich des Formats. Nach der Einreichung wird sie von einem Team von Plugin-Überprüfern manuell geprüft – dieser Prozess kann einige Wochen in Anspruch nehmen. Sobald die Prüfung abgeschlossen ist, kann dein Plugin von Nutzern weltweit gesucht und installiert werden.