Vom Nullpunkt zum Erreichen des ersten Erfolgs: Ein umfassender Leitfaden zur schrittweisen Entwicklung deines ersten WordPress-Plugins

Vorbereitung der Entwicklungsumgebung für WordPress-Plugins

Bevor du mit dem Schreiben des Codes beginnst, ist es von entscheidender Bedeutung, eine stabile Entwicklungsumgebung aufzubauen, die von deinem lokalen Rechner isoliert ist. Dies schützt nicht nur deine Hauptwebseite, sondern ermöglicht es dir auch, frei zu experimentieren und zu debuggen.

Eine effiziente Umgebung umfasst in der Regel drei Kernkomponenten: Erstens ein Webserver-Softwarepaket, wie Apache oder Nginx. Zweitens eine PHP-Umgebung, deren Version mit der zu deployenden WordPress-Version kompatibel ist. Schließlich eine MySQL- oder MariaDB-Datenbank. Obwohl es möglich ist, diese Softwarepakete manuell einzeln zu installieren, empfehlen wir dringend die Verwendung einer lokalen Server-Integrationsumgebung.

Es gibt auf dem Markt zahlreiche hochwertige Integrationsumgebungen zur Auswahl, wie zum Beispiel Local by Flywheel, XAMPP, MAMP oder DevKinsta. Diese Tools verpacken die oben genannten Komponenten und bieten die Möglichkeit einer einstufigen Installation und Inbetriebnahme. Sie enthalten in der Regel auch entwicklerfreundliche Funktionen wie die E-Mail-Überwachung, die Klonierung von Webseiten sowie die einstufige Konfiguration von SSL-Zertifikaten, was deine Entwicklungseffizienz erheblich steigern kann.

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

Neben der Serverumgebung benötigen Sie auch einen Code-Editor. Sie können entweder eine vollständig ausgestattete integrierte Entwicklungsumgebung (wie PhpStorm) wählen oder einen leichten, aber erweiterbaren Editor (wie Visual Studio Code). Für die Entwicklung von Plugins sollten die Plugins zumindest Funktionen wie PHP-Code-Vorschläge, Syntax-Hervorhebung und Datei-Verwaltung bieten. Die Installation bestimmter Plugins in den Texteditor (z. B. WordPress-relevanter Code-Snippets oder PHP Intelephense) macht den Programmierprozess wesentlich reibungsloser.

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

Verstehen der Struktur der Kerndateien des Plugins

WordPress-Plugins sind im Wesentlichen Sammlungen aus einer oder mehreren PHP-Dateien, die einer bestimmten Struktur und Vereinbarung folgen, damit das WordPress-Kernsystem sie erkennen und laden kann.

Jeder Plugin beginnt mit einer Hauptdatei. Diese Hauptdatei ist der “Einstiegspunkt” des Plugins und muss eine bestimmte Dateihauptkommentarzeile enthalten. Diese Dateihauptkommentarzeile besteht aus einem mehrzeiligen Kommentarblock, der Metadaten des Plugins enthält – wie den Namen des Plugins, eine Beschreibung, die Version, den Autor usw. WordPress nutzt diese Informationen, um dein Plugin in der Backend-Verwaltungsoberfläche anzuzeigen. Der Name der Hauptdatei kann angepasst werden, ist aber in der Regel standardmäßig festgelegt. plugin-name.php In dieser Form.

Hier ist ein grundlegendes Beispiel für die Kopfzeile der Hauptdatei eines Plugins:

<?php
/**
 * Plugin Name: 我的第一个自定义插件
 * Plugin URI:  https://example.com/my-first-plugin
 * Description: 这是我从零开始开发的第一个WordPress插件，用于演示和学习。
 * Version:     1.0.0
 * Author:      你的名字
 * Author URI:  https://example.com
 * License:     GPL v2 or later
 * Text Domain: my-first-plugin
 */

Sobald die Hauptdatei fertiggestellt ist, muss sie an der richtigen Stelle platziert werden. Die Kerndatei des Plugins muss sich in einem bestimmten Verzeichnis befinden. /wp-content/plugins/ In einem separaten Ordner innerhalb des Verzeichnisses. Der Name des Ordners sollte kurz, eindeutig sein und aus kleinen Buchstaben sowie Bindestrichen bestehen. Zum Beispiel kann unser Plugin in diesem Ordner abgelegt werden. /wp-content/plugins/my-first-plugin/ Unter dem Pfad befindet sich die Hauptdatei. my-first-plugin.php Platzieren Sie es einfach im Root-Verzeichnis dieses Ordners.

Empfohlene Lektüre Analyse der WordPress-Plugin-Entwicklung: Ein umfassender Leitfaden zur Erstellung benutzerdefinierter Funktionsmodule von Grund auf。

Schreiben Sie Ihre erste Funktion.

Jetzt fügen wir der Erweiterung die erste interaktive Funktion hinzu. WordPress ermöglicht es Erweiterungen mithilfe des “Hook”-Mechanismus, zu bestimmten Zeitpunkten Funktionen zu ändern oder hinzuzufügen. Es gibt hauptsächlich zwei Arten von Hooks: Action Hooks und Filter Hooks.

Action Hooks ermöglichen es Ihnen, Ihren eigenen Code zu einem bestimmten Zeitpunkt während der Ausführung von WordPress auszuführen – beispielsweise beim Veröffentlichen eines Artikels oder beim Laden einer Seite. Ein häufiges Beispiel dafür ist das Hinzufügen von benutzerdefinierten Informationen in den Fußbereich einer Webseite. wp_footer Diese Aktion wird mit einem Hook umgesetzt.

Wir müssen eine benutzerdefinierte Funktion schreiben und WordPress mitteilen, dass … wp_footer Wenn es ausgelöst wird, wird es ausgeführt. Dieser Prozess wird als “Anbinden” einer Funktion oder Methode an einen Hook bezeichnet. Hier ist ein Beispiel für die Implementierung:

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 my_first_plugin_display_footer_text() {
    echo ‘<p style="text-align: center; color: #666;">Präsentiert von meinem ersten Plugin für Sie.</p>’;
}
add_action( ‘wp_footer’， ‘my_first_plugin_display_footer_text’ );

add_action() Dies ist die Kernfunktion für die Montageaktion. Nach Abschluss der oben genannten Schritte sollten Sie Ihren Site-Cache löschen und die Frontend-Seite aktualisieren. Danach sollten Sie den von dem Plugin hinzugefügten Fußertext sehen können.

Nun lassen Sie uns uns mit den Filter-Hooks beschäftigen. Filter-Hooks ermöglichen es Ihnen, die an sie übergebenen Daten zu ändern. Zum Beispiel möchten wir den Inhalt des Artikeltitels ändern. Dafür können Sie… the_title Filter. Der folgende Code zeigt, wie man einen Präfix vor alle Artikelüberschriften setzen kann:

function my_first_plugin_prefix_title( $title ) {
    // 检查是否在主循环中且不是管理后台，避免影响后台标题显示
    if ( ! is_admin() && in_the_loop() ) {
        $title = ‘[插件前缀] ’ . $title;
    }
    return $title;
}
add_filter( ‘the_title’， ‘my_first_plugin_prefix_title’ );

Verbessern des Plugins: Hinzufügen eines Verwaltungsmenüs und einer Einstellungsseite

Ein voll funktionsfähiges Plugin benötigt in der Regel die Interaktion mit dem Administrator – dazu müssen eigene Menüeinträge sowie Einstellseiten hinzugefügt werden. Dadurch können Benutzer das Plugin ohne Kenntnisse der Programmierung konfigurieren.

Empfohlene Lektüre Von Grund auf: Ein vollständiger Leitfaden und praktisches Tutorial zur Entwicklung von WordPress-Plugins。

Um einen neuen obersten Menüeintrag im linken Management-Menü im WordPress-Backend hinzuzufügen, muss man folgende Schritte ausführen: add_menu_page() Funktion. Diese Funktion benötigt mehrere Parameter, um den Titel des Menüs, die Berechtigungen, die eindeutige Identifikation sowie die Rückruffunktion usw. zu definieren. Sie müssen dies zu einem geeigneten Zeitpunkt tun – in der Regel… admin_menu Action Hook: Rufen Sie es auf.

Hier ist ein Beispiel für die Erstellung einer einfachen obersten Menüstruktur sowie deren Einstellungsseite:

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 my_first_plugin_add_admin_menu() {
    add_menu_page(
        ‘我的第一个插件设置’， // 页面标题
        ‘我的插件’，           // 菜单标题
        ‘manage_options’，     // 所需权限（管理员）
        ‘my-first-plugin-settings’， // 菜单slug
        ‘my_first_plugin_render_settings_page’， // 渲染页面的回调函数
        ‘dashicons-admin-plugins’， // 图标（Dashicons）
        100                     // 菜单位置
    );
}
add_action( ‘admin_menu’， ‘my_first_plugin_add_admin_menu’ );

Als Nächstes müssen Sie eine Callback-Funktion definieren. my_first_plugin_render_settings_page() Bitte generieren Sie den HTML-Inhalt für diese Einstellungsseite. In dieser Funktion können Sie ein Formular ausgeben und die Einreichung des Formulars verarbeiten (nicht auf Ajax-Basis).

Um die Einstellungen von Plugins sicher zu speichern und abzurufen, sollte die WordPress-Option-API verwendet werden. Sie können dies dazu nutzen… add_option()、get_option()、update_option() und delete_option() Funktionen wie „warten“ werden verwendet, um mit Objekten zu arbeiten, die den Namen „…“ tragen. my_first_plugin_options Die Optionendaten. Im Formular sollten die in WordPress integrierten Funktionen verwendet werden. settings_fields() und do_settings_sections() Es gibt Funktionen, die es ermöglichen, Einstellungsfelder sicher auszugeben – doch diese werden in der Regel in Kombination mit einer formelleren “Einstellungs-API” verwendet. Für einfache Einstellungsseiten ist es ebenfalls üblich, die Formularabgabe manuell zu verarbeiten sowie die Daten zu überprüfen und zu bereinigen.

Zusammenfassungen

Die Entwicklung deines ersten WordPress-Plugins ist ein systematischer Lernprozess. Du begannst mit dem Aufbau einer sicheren lokalen Entwicklungsumgebung und hast die grundlegenden Dateistrukturen sowie Namenskonventionen für Plugins verstanden. Anschließend hast du das Kernkonzept der Erweiterbarkeit von WordPress-Plugins erlernt – das Hook-System. Du konntest erfolgreich Inhalte mithilfe von Aktion-Hooks ausgeben sowie Daten mit Filter-Hooks verändern. Um das Plugin einfacher zu verwalten, hast du gelernt, wie man Menüs für die Backend-Verwaltung erstellt und Einstellseiten konfiguriert, sowie wie man mit der WordPress-Option-API interagiert, um Daten dauerhaft zu speichern.

Indem Sie diesen Schritten folgen, haben Sie nicht nur erfolgreich einen funktionsfähigen Plugin erstellt, sondern noch wichtiger: Sie haben eine erweiterbare Grundlage aufgebaut. Auf dieser Basis können Sie durch die Erforschung weiterer Mechanismen („Hooks“), das tiefergehende Erlernen von JavaScript (insbesondere Ajax), das Erstellen benutzerdefinierter Datenbanktabellen oder die Entwicklung von kurzen, effizienten Codeabschnitten kontinuierlich komplexere und leistungsfähigere Funktionen zu Ihrem Plugin hinzufügen.

FAQ Häufig gestellte Fragen

Kann man ohne Programmiererfahrung einen WordPress-Plugin entwickeln, wenn man die Sequenz „###“ verwendet?
Obwohl es einfacher ist, wenn Sie über grundlegende Kenntnisse in PHP, HTML und etwas CSS verfügen, können Sie auch ganz von vorne anfangen. Der Schlüssel liegt darin, Schritt für Schritt vorzugehen: Beginnen Sie damit, einfache vorhandene Plugin-Code zu ändern und nachzumachen, um allmählich die von WordPress bereitgestellten Kernfunktionen und Hooks zu verstehen. Verwenden Sie dabei ausführliche offizielle Dokumentation sowie praktische Übungen, um Ihr Wissen zu vertiefen.

Warum kann mein Plugin im Hintergrund nicht aktiviert werden?

Es gibt in der Regel mehrere Gründe für das Scheitern der Aktivierung eines Plugins. Am häufigsten liegt es daran, dass die Formatierung der Dateihauptinformationen (Header) der Hauptdatei nicht korrekt ist oder dass erforderliche Felder (z. B. „Plugin Name“) fehlen. Ein weiterer möglicher Grund sind Syntaxfehler im PHP-Code, die Sie durch Überprüfung der Fehlerprotokolle des Webserverns erkennen können. Zudem kann es vorkommen, dass der Name der Plugin-Verzeichnis- oder Hauptdatei mit dem Namen anderer bereits installierter Plugins kollidiert, oder dass die von dem Plugin benötigte PHP-Version höher ist als die der aktuellen Serverumgebung.

Wie kann man die fortgeschrittenen Einstellungen eines Plugins in mehrere Tabellenblätter aufteilen?

Sie können dies erreichen, indem Sie die Funktion mehrmals aufrufen. add_menu_page() Es ist möglich, ein unabhängiges Hauptmenü zu erstellen, aber dies könnte dazu führen, dass die Backend-Struktur unübersichtlich wird. Eine bessere Vorgehensweise wäre es,… add_submenu_page() Funktion: Füge eine zusätzliche Einstellungsseite als Untermenüeintrag unter dein Hauptmenü hinzu. Bei der Erstellung des Untermenüs soll der erste Parameter (der Slug des übergeordneten Menüs) auf den Slug deines Hauptmenüs gesetzt werden; die folgenden Parameter dienen dazu, den Titel und die Funktionen des Untermenüs zu definieren.

Wie kann man ein nach der Entwicklung fertiggestelltes Plugin sicher veröffentlichen?

Vor der Veröffentlichung eines Plugins im WordPress-Plugin-Verzeichnis ist es von entscheidender Bedeutung, die Sicherheit des Codes zu gewährleisten. Sie müssen alle Benutzereingaben streng überprüfen und entschärfen. Es wird empfohlen, die von WordPress bereitgestellten Funktionen zu verwenden. sanitize_text_field()、wp_kses() und esc_html()Gleichzeitig sollten alle direkt ausgeführten Datenbankoperationen die entsprechenden Standards und Konventionen einhalten. $wpdb Die von der Klasse bereitgestellten Methoden dienen dazu, SQL-Injection-Angriffe zu verhindern. Vor der Veröffentlichung sollte das Plugin auch internationalisiert werden, und Übersetzungsdateien für alle von den Nutzern sichtbaren Zeichenketten sollten erstellt werden.