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

Warum sollte man sich für die Entwicklung von WordPress-Plugins entscheiden?

Der Grund, warum WordPress zu dem weltweit beliebtesten Content-Management-System geworden ist, liegt in seiner hohen Erweiterbarkeit – und diese Erweiterbarkeit ist vor allem seiner Plugin-Architektur zu verdanken. Durch die Entwicklung eigener Plugins kannst du deiner Website jede Funktion hinzufügen, die dir in den Sinn kommt, ohne den Kerncode von WordPress ändern zu müssen. Das bedeutet, dass diese Funktionen unabhängig von den verwendeten Themes existieren und auch nach einem Wechsel des Themes weiterhin funktionsfähig bleiben. Noch wichtiger ist: Ein gut entwickeltes Plugin kann die spezifischen Bedürfnisse von Nutzern erfüllen – und sogar zu einem eigenständigen Produkt oder Service werden.

Das Beherrschen der Plugin-Entwicklung bedeutet, dass Sie von einem Nutzer von WordPress zu einem Ersteller werden. Egal, ob Sie die individuellen Anforderungen Ihres Projekts erfüllen möchten oder durch die Entwicklung kommerzieller Plugins Einnahmen erzielen möchten – es ist unerlässlich, die grundlegenden Prinzipien und besten Praktiken der Plugin-Entwicklung zu verstehen. Diese Anleitung führt Sie Schritt für Schritt von der einfachsten Struktur an, bis Sie ein voll funktionsfähiges, standardkonformes Plugin erstellt haben.

Erstellen Sie die Struktur für Ihr erstes Plugin.

Ein standardmäßiges WordPress-Plugin ist eine Ordnerstruktur, die eine oder mehrere PHP-Dateien enthält. Der Wurzelordner muss außerdem eine Hauptdatei enthalten. Diese Hauptdatei muss spezifische Plugin-Headerinformationen enthalten, damit WordPress das Plugin erkennen und verwalten kann.

Empfohlene Lektüre WordPress-Plugin-Entwicklung meistern: Effiziente, benutzerdefinierte Funktionen von Grund auf erstellen。

Erstellen Sie die Hauptdatei des Plugins.

Das Erste, was Sie tun müssen, ist die Erstellung der Hauptdatei des Plugins. Diese Datei wird in der Regel nach dem Namen des Plugins benannt, zum Beispiel… my-first-plugin.phpAm Anfang dieses Files müssen Sie einen standardmäßigen Kommentar für die Plugin-Header hinzufügen.

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://yourwebsite.com/my-first-plugin
 * Description:       这是一个用于学习的 WordPress 自定义插件示例。
 * Version:           1.0.0
 * Author:            你的名字
 * Author URI:        https://yourwebsite.com
 * License:           GPL v2 or later
 * Text Domain:       my-first-plugin
 * Domain Path:       /languages
 */

Diese Anmerkung ist sozusagen die “Identifikationskarte” des Plugins. Plugin NameDer Name des Plugins ist das einzige erforderliche Feld; die anderen Felder dienen dazu, zusätzliche Informationen bereitzustellen. Die “Plugins”-Seite im WordPress-Backend liest diese Informationen ab und zeigt sie an. Nachdem Sie diese Datei erstellt haben, müssen Sie sie in den Installationsordner von WordPress legen. /wp-content/plugins/ Im Ordner kannst du direkt einen Unterordner mit dem Namen “my-first-plugin” erstellen und die Hauptdatei dort ablegen. Anschließend loggst du dich in das WordPress-Backend ein und kannst das Plugin in der Liste der verfügbaren Plugins sehen sowie aktivieren. Auch wenn es derzeit noch keine Funktionen besitzt, hast du bereits den ersten erfolgreichen Schritt gemacht.

Organisieren Sie Ihre Plugin-Dateien

Mit der Zunahme von Funktionen wird es schwierig, den gesamten Code in einer einzigen Hauptdatei zu halten – die Wartung wird dadurch erschwert. Eine gute Strukturierung der Dateien ist daher von großer Bedeutung. Ein typisches Plugin kann die folgenden Verzeichnisse enthalten:
* /includes/Hier werden die Dateien mit den Kernfunktionen sowie die Definitionen der Klassen gespeichert.
* /admin/Hier werden Dateien gespeichert, die mit der Backend-Verwaltungsoberfläche zusammenhängen.
* /public/Hier werden die Frontend-Funktionsdateien für die Besucher der Website gespeichert.
* /assets/Dient zum Speichern von statischen Ressourcen wie JavaScript-Dateien, CSS-Dateien und Bildern.
* /languages/Hier werden die Dateien für die internationale Lokalisierung (Formaten .po und .mo) abgelegt.

Diese modulare Struktur macht den Code nicht nur klarer, sondern erleichtert auch die Zusammenarbeit im Team sowie die Erweiterung weiterer Funktionen in Zukunft. Im Hauptdatei… my-first-plugin.php In diesem Kontext würdest du normalerweise Folgendes verwenden: require_once Um die Funktionen aus diesen Verzeichnissen einzubinden, müssen die entsprechenden Dateien importiert werden.

Verständnis der Kernentwicklungskonzepte von WordPress: Hooks und Filter

Der Kern der WordPress-Plugin-Entwicklung ist das sogenannte “Hook”-Mechanismus. Dieser ermöglicht es Ihnen, Ihren Code zu bestimmten Zeitpunkten in den Kernausführungsvorgang von WordPress einzubinden, um Funktionen zu ändern oder hinzuzufügen. Es gibt zwei Arten von Hooks: Actions und Filters.

Empfohlene Lektüre Vom Nullpunkt an das WordPress-Plugin-Entwicklung verstehen: Ein Leitfaden zur Implementierung fortgeschrittener Funktionen und besten Praktiken。

Mit Action-Hooks Funktionen hinzufügen

Action Hooks ermöglichen es Ihnen, Ihre eigenen Funktionen zu einem bestimmten Zeitpunkt während des Betriebs von WordPress auszuführen. Zum Beispiel möchten Sie eine Aktion ausführen, wenn ein Artikel veröffentlicht wird, oder ein Menü in die Seitenleiste des Administrationsbrowsers hinzufügen.

Hier ist ein einfaches Beispiel, das verwendet wird: wp_footer Dieser Aktionshook generiert eine Nachricht in der öffentlichen Bereich des Website-Fußes. Sie müssen den folgenden Code in die Hauptdatei Ihres Plugins einfügen.

function myplugin_add_footer_text() {
    echo '<p style="text-align:center;">Vielen Dank, dass Sie mein erstes Plugin verwendet haben!</p>';
}
add_action( 'wp_footer', 'myplugin_add_footer_text' );

Hier,myplugin_add_footer_text Es ist eine von uns definierte Funktion.add_action() Die Funktion “bindet” diese Funktion an… wp_footer Diese Aktion ist an einem Hook gebunden. Sobald WordPress auf die Fußzeile (Footer) des Blogs zugreift, wird unsere Funktion automatisch aufgerufen.

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

Inhalte mithilfe von Filter-Hooks ändern

Im Gegensatz zu Aktionshookern dienen Filterhookern dazu, Daten zu verändern. Ihre Funktion erhält einen Eingabewert und muss nach der Verarbeitung einen Wert zurückgeben. Beispiele dafür sind das Ändern des Titels eines Artikels oder die Anpassung der Darstellung des Inhalts.

Die folgenden Beispiele zeigen, wie dies verwendet werden kann. the_content Ein Filter, der am Ende aller Artikel und Seiteninhalte automatisch einen benutzerdefinierten Text hinzufügt.

function myplugin_append_to_content( $content ) {
    $custom_text = '<div class="myplugin-note"><p><em>Dieser Artikel wird durch meine eigens entwickelten Plugins verbessert und angezeigt.</em></p></div>';
    // 仅在主循环的单篇文章页面添加
    if ( is_single() &amp;&amp; in_the_loop() &amp;&amp; is_main_query() ) {
        return $content . $custom_text;
    }
    return $content;
}
add_filter( 'the_content', 'myplugin_append_to_content' );

Funktion myplugin_append_to_content Empfangen Sie die Originale… $contentWir überprüfen die Bedingungen, um sicherzustellen, dass der Text nur an den erforderlichen Stellen hinzugefügt wird, und geben anschließend den modifizierten Inhalt zurück.add_filter() Die Funktion hat die Registrierung abgeschlossen.

Empfohlene Lektüre WordPress-Plugin-Entwicklung von Anfänger bis Experte: Erstellung benutzerdefinierter Funktionen und effiziente Erweiterungen。

Erstellen Sie eine Verwaltungseite für das Plugin.

Die meisten Plugins benötigen eine Konfigurationsseite, damit die Benutzer Optionen einstellen können. WordPress bietet eine umfangreiche API, um ansprechende und standardisierte Verwaltungsoberflächen zu erstellen.

Hinzufügen des obersten Verwaltungsmenüs

Sie können ein neues oberes Menüelement in die linke Navigationsspalte des WordPress-Backends für Ihr Plugin hinzufügen. Dies erfolgt auf folgende Weise: add_menu_page() Die Funktion wird implementiert. Wir verwenden sie normalerweise… admin_menu Diese Funktion wird in diesem Aktionshookup aufgerufen.

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

function myplugin_add_admin_menu() {
    add_menu_page(
        '我的插件设置', // 页面标签
        '我的插件',     // 菜单标题
        'manage_options', // 所需权限
        'myplugin-settings', // 菜单 Slug
        'myplugin_settings_page_html', // 显示页面内容的回调函数
        'dashicons-admin-generic', // 图标（可选）
        80 // 菜单位置（可选）
    );
}
add_action( 'admin_menu', 'myplugin_add_admin_menu' );

Erstellen Sie die Inhalte der Einstellungsseite.

Jetzt müssen wir die oben erwähnte Callback-Funktion definieren. myplugin_settings_page_htmlUm die HTML-Inhalte der Einstellungsseite zu rendern, wird eine bestimmte Technologie verwendet. Eine einfache Version davon sieht wie folgt aus:

function myplugin_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
            // 输出设置字段和非ce字段
            settings_fields( 'myplugin_options' );
            do_settings_sections( 'myplugin-settings' );
            submit_button( '保存设置' );
            ?>
        <input type="hidden" name="trp-form-language" value="de"/></form>
    </div>
    &lt;?php
}

Diese Funktion erstellt ein Formular, das dem Design des WordPress-Benutzeroberflächens entspricht. Um die Einstellungen vollständig zu verarbeiten, benötigen Sie außerdem… register_setting(), add_settings_section() und add_settings_field() Mithilfe von Funktionen wie diesen werden die einzelnen Einstellungsparameter definiert, was den vollständigen “Settings API”-Workflow bildet. Dies ist die empfohlene Methode zur sicheren Speicherung und Abfrage von Plugin-Optionen.

Implementierung einer praktischen Plugin-Funktion: Zählung der Anzahl der Artikelansichten

Lassen Sie uns die oben genannten Konzepte kombinieren, um eine praktische Funktion zu erstellen: die Anzahl der Aufrufe jedes Artikels zu zählen und anzuzeigen.

Erstellen von Datenbankfeldern und Speichern von Daten

Zunächst müssen wir bei der Veröffentlichung eines Artikels einen Ort schaffen, an dem die Anzahl der Aufrufe gespeichert werden kann. Üblicherweise verwenden wir dafür die Funktion der Post-Meta-Daten (Artikelmetadaten) in WordPress. add_post_meta Eine Funktion wäre eine Möglichkeit, aber eine elegantere Lösung wäre es, diesen Wert beim Aufrufen des Artikels zu überprüfen und zu aktualisieren.

function myplugin_track_post_views( $post_id ) {
    if ( ! is_single() ) {
        return;
    }
    if ( empty( $post_id ) ) {
        global $post;
        $post_id = $post->ID;
    }
    // 获取当前浏览次数
    $count = get_post_meta( $post_id, 'myplugin_post_views', true );
    // 如果为空，初始化为0
    $count = $count ? absint( $count ) : 0;
    $count++;
    // 更新数据库
    update_post_meta( $post_id, 'myplugin_post_views', $count );
}
// 在模板重定向时触发，确保只对真实访客计数
add_action( 'template_redirect', 'myplugin_track_post_views' );

Die Anzahl der Aufrufe wird auf der Frontend-Seite angezeigt.

Nachdem die Daten gespeichert wurden, benötigen wir eine Funktion, um sie abzurufen und anzuzeigen. Wir können einen Shortcode erstellen, der es den Nutzern ermöglicht, diesen in den Artikelinhalt oder in Widgets in der Seitenleiste einzufügen.

function myplugin_display_post_views_shortcode( $atts ) {
    $atts = shortcode_atts( array(
        'id' => get_the_ID(),
    ), $atts, 'myplugin_views' );

$post_id = absint( $atts['id'] );
    $views = get_post_meta( $post_id, 'myplugin_post_views', true );
    $views = $views ? $views : 0;

return '<span class="myplugin-view-count">Anzahl der Aufrufe: '. esc_html($views). '</span>'php
add_shortcode('myplugin_views', 'myplugin_display_post_views_shortcode');

Jetzt müssen die Benutzer lediglich einen Kurzcode im Artikel-Editor eingeben. [myplugin_views]Oder Sie können ein “Shortcode”-Helfsmittel hinzufügen und diesen Code eingeben – dadurch wird die Anzahl der Aufrufe des Artikels auf der Seite angezeigt. Dieses vollständige Beispiel umfasst den gesamten Prozess der Datenspeicherung („Hooks“), der Datenabrufung sowie der Darstellung auf der Benutzeroberfläche („Shortcodes“).

Zusammenfassungen

Mit dieser Anleitung haben Sie den gesamten Prozess der Erstellung eines eigenen WordPress-Plugins von Grund auf durchlaufen. Zunächst haben wir die grundlegende Struktur eines Plugins kennengelernt und eine Hauptdatei erstellt, die die standardmäßigen Kopfinformationen enthält. Anschließend haben wir uns ausführlich mit den Grundlagen der WordPress-Plugin-Entwicklung beschäftigt – insbesondere mit den sogenannten “Hooks” (Aktionen und Filtern) – und gelernt, wie man sie verwendet, um Funktionen hinzuzufügen oder zu ändern. Danach haben wir eine professionelle Administrationsseite für das Plugin erstellt, die eine Schlüsselrolle bei der Interaktion mit den Benutzern spielt. Abschließend haben wir die Theorie in die Praxis umgesetzt, indem wir an einem praktischen Beispiel (der Zählung der Artikelaufrufe) gezeigt haben, wie eine vollständige Funktionskette von der Datenerfassung bis zur Anzeige auf der Benutzeroberfläche realisiert wird.

Denken Sie daran: Die Entwicklung hochwertiger Plugins bedeutet nicht nur, dass die Funktionen ordnungsgemäß funktionieren, sondern auch, dass auf die Sicherheit, Wartbarkeit, Leistung des Codes sowie die Einhaltung der WordPress-Programmierstandards geachtet wird. Durch kontinuierliches Üben und das Erkunden weiterer WordPress-APIs werden Sie in der Lage sein, Plugins zu erstellen, die leistungsstark und bei den Nutzern beliebt sind.

FAQ Häufig gestellte Fragen

Welche Vorkenntnisse sind erforderlich, um Plugins zu entwickeln?

Sie benötigen eine solide Grundlage in der PHP-Programmierung, da WordPress sowie seine Plugins hauptsächlich in PHP entwickelt wurden. Ebenso ist ein grundlegendes Verständnis von HTML, CSS und JavaScript von großer Bedeutung – dies ermöglicht es Ihnen, Benutzeroberflächen und interaktive Funktionen zu erstellen. Ein Grundwissen über die Grundkonzepte von MySQL-Datenbanken hilft Ihnen außerdem dabei, die Art und Weise zu verstehen, wie WordPress Daten speichert.

Wie debugge ich mein WordPress-Plugin?

Zuerst stellen Sie sicher, dass in Ihrer… wp-config.php Aktivieren Sie im File den Debugging-Modus für WordPress. WP_DEBUG Die Konstante ist auf trueDies wird PHP-Fehler und Warnungen auf dem Bildschirm anzeigen. Zweitens wird… error_log() Die Funktion schreibt die Debugging-Informationen in das Fehlerprotokoll des Servers – das ist eine sehr zuverlässige Methode zum Debuggen. Bei komplexen Variablen kann diese Methode auch in Kombination mit anderen Verfahren eingesetzt werden. print_r() oder var_dump() Und error_log()Darüber hinaus können Sie die Entwicklertools Ihres Browsers (Taste F12) nutzen, um Probleme mit JavaScript- und CSS-Code auf der Frontend-Seite zu debuggen.

Wie kann meine Erweiterung mit verschiedenen Versionen von WordPress kompatibel sein?

Während der Entwicklung sollte man regelmäßig die offizielle WordPress-Entwicklungsdokumentation durchsehen, um sich über die Veränderungen von Funktionen und Hooks in den verschiedenen Versionen informieren zu können. function_exists() oder version_compare() Verwenden Sie bedingte Anweisungen, um zu überprüfen, ob eine Funktion oder ein Feature verfügbar ist, und bieten Sie somit eine abwärtskompatible Alternativlösung an. Geben Sie in der Beschreibung des Plugins klar an, für welche WordPress-Versionen die Kompatibilität gewährleistet wird. Es ist die beste Praxis, die Kompatibilität kontinuierlich in Testumgebungen für verschiedene WordPress-Versionen zu überprüfen.

Was sollte man bei der Entwicklung von kommerziellen Plugins berücksichtigen?

Bei der Entwicklung von kommerziellen Plugins müssen Sicherheit, Codequalität und Benutzererfahrung an erster Stelle stehen. Es ist erforderlich, ein zuverlässiges und sicheres Authentifizierungssystem zu implementieren – beispielsweise mithilfe von Lizenzschlüsseln. Eine klare und rechtzeitige Bereitstellung von Benutzerdokumentation sowie technischer Unterstützung ist von großer Bedeutung. Stellen Sie sicher, dass Sie die offiziellen WordPress-Plug-in-Entwicklungshandbücher sowie die GPL-Lizenzvereinbarungen einhalten. Überlegen Sie außerdem die Nutzung professioneller Plattformen wie Freemius oder Easy Digital Downloads für den Vertrieb, die Bereitstellung von Updates sowie die Verwaltung von Support-Anfragen.