WordPress-Plugin-Entwicklung von Anfang bis Ende: Ein vollständiger Leitfaden zur Erstellung einer personalisierten Website

Warum sollte man WordPress-Plugins entwickeln lernen?

Als weltweit beliebtestes Content-Management-System verdankt WordPress seine starke Erweiterbarkeit in erster Linie dem Plugin-Mechanismus. Durch die Entwicklung eigener Plugins können Entwickler die Grenzen der vorhandenen Themes überschreiten und der Website jede gewünschte Funktion hinzufügen – von einfachen Shortcodes bis hin zu komplexen E-Commerce-Systemen. Die Beherrschung von Plugin-Entwicklungsfähigkeiten bedeutet nicht nur, dass Sie die Anforderungen spezifischer Projekte erfüllen können, sondern auch, dass Sie Ihre Lösungen kommerziell nutzen und im umfangreichen WordPress-Ökosystem Wert schaffen können.

Im Gegensatz zu den Methoden, die direkt das Thema ändern…functions.phpIm Vergleich zu herkömmlichen Dateien ist es eine professionellere und nachhaltigere Vorgehensweise, Funktionen mithilfe von Plugins zu verpacken. Plugins können unabhängig von den verwendeten Themes existieren, was die Wiederverwendung von Funktionen, die separate Wartung sowie das Aktualisieren erleichtert. Ein gut strukturiertes Plugin, das die Codierstandards und Architekturkonzepte von WordPress befolgt, sorgt für eine gute Kompatibilität mit dem Kernsystem sowie mit anderen Plugins.

Aus Sicht der beruflichen Entwicklung bietet diese Fähigkeit – egal ob man als Freiberufler individuelle Lösungen für Kunden entwickelt oder als Produktmanager kommerzielle Plugins für globale Nutzer erstellt – einen sehr hohen Marktbedarf sowie großes Potenzial für die monetäre Umsetzung.

Empfohlene Lektüre WordPress-Plugins von Grund auf erlernen: Benutzerdefinierte Funktionen und Erweiterungen erstellen。

Erstellen Sie Ihre eigene Entwicklungsumgebung für Plugins.

Bevor Sie mit dem Schreiben der ersten Zeile Code beginnen, ist es von entscheidender Bedeutung, eine professionelle lokale Entwicklungsumgebung einzurichten. Dies ermöglicht es Ihnen, Tests und Fehlersuche in einem sicheren, isolierten Umfeld durchzuführen.

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

Konfiguration der lokalen Serverumgebung

Es wird empfohlen, integrierte lokale Server-Softwarepakete wie Local by Flywheel, DevKinsta oder XAMPP zu verwenden. Diese Tools installieren PHP, MySQL/MariaDB sowie einen Webserver (z. B. Apache oder Nginx) mit nur einem Klick. Stellen Sie sicher, dass Ihre Umgebung mit einer PHP-Version läuft, die mit Ihrer Zielproduktionsumgebung übereinstimmt oder aktualisiert ist (z. B. PHP 7.4 oder 8.0+), und dass die notwendigen PHP-Erweiterungen wie MySQLi oder PDO aktiviert sind.

Code-Editor und Debugging-Tools

Wählen Sie einen leistungsstarken Code-Editor oder eine integrierte Entwicklungsumgebung (IDE). Visual Studio Code, PhpStorm oder Sublime Text sind alle hervorragende Optionen. Sie sollten Funktionen wie Syntax-Hervorhebung, Code-Vorschläge sowie die Integration von Versionierungssystemen bieten.

Debugging ist ein zentraler Bestandteil der Entwicklung. Es ist unerlässlich, dies zu berücksichtigen.wp-config.phpAktivieren Sie im File den WordPress-Debugging-Modus.WP_DEBUGDie Konstante ist auftrueDies wird PHP-Fehler, Warnungen und Benachrichtigungen auf dem Bildschirm anzeigen, um Ihnen zu helfen, das Problem schnell zu lokalisieren.

// 在 wp-config.php 中定义调试常量
define( 'WP_DEBUG', true );
define( 'WP_DEBUG_LOG', true ); // 将错误记录到 /wp-content/debug.log
define( 'WP_DEBUG_DISPLAY', false ); // 不在前端显示错误

Initialisierung des Versionskontrollsystems

Verwende von Anfang an Git für die Versionierung. Initialisiere ein Repository im Wurzelverzeichnis deines Plugins und erstelle dort eine….gitignoreDateien – ignorieren Sie beispielsweise solche, die bestimmte Merkmale aufweisen…node_modules、vendor(Falls Composer verwendet wird) sowie alle Konfigurationsdateien, die sensible Informationen enthalten. Dies hilft Ihnen dabei, Codeänderungen nachzuverfolgen und mit dem Team zusammenzuarbeiten.

Empfohlene Lektüre Von Grund auf: Erstellen Sie Ihr erstes WordPress-Plugin。

Erstellen Sie Ihr erstes WordPress-Plugin.

Ein sehr einfaches WordPress-Plugin benötigt lediglich eine Haupt-PHP-Datei, in deren Anfang die standardkonformen Kommentare mit den Plugin-Informationen enthalten sind.

Die Struktur der Hauptdatei eines Plugins

In deinemwp-content/pluginsErstellen Sie unter dem Verzeichnis einen neuen Ordner, zum Beispielmy-first-pluginIn diesem Ordner erstellen Sie die Haupt-PHP-Datei. Der Name der Datei entspricht in der Regel dem Namen des Ordners.my-first-plugin.php。

Öffnen Sie diese Datei und fügen Sie am Anfang der Datei Kommentare für die Plugin-Header hinzu. Diese Kommentare sind erforderlich, damit WordPress das Plugin erkennen kann.

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

<?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
 * Domain Path:       /languages
 */

Nachdem du die Datei gespeichert hast, logge dich in das WordPress-Backend ein und gehe zur Seite “Plugins”. Dort solltest du “Mein erstes Plugin” in der Liste der Plugins sehen. Aktiviere es – auch wenn es noch keine Funktionen bietet, hast du erfolgreich ein Plugin erstellt.

Implementieren Sie eine einfache Funktion: Die Verwaltung von Benachrichtigungen.

Lassen Sie uns der Erweiterung die erste praktische Funktion hinzufügen: Die Anzeige einer benutzerdefinierten Benachrichtigung im Administrationsbereich. Dafür werden wir die WordPress-Administrationsbenachrichtigungs-API verwenden.

Fügen Sie den folgenden Code unter die Kopf-Anmerkungen im Hauptdatei des Plugins hinzu. Wir verwenden…admin_noticesWir verwenden sogenannte „Action Hooks“, um unsere Inhalte an bestimmten Stellen auszugeben.

Empfohlene Lektüre Eine vollständige Anleitung zur Entwicklung von WordPress-Plugins: Von den Grundlagen bis hin zu fortgeschrittenen praktischen Tutorials。

// 钩子：在管理后台显示通知
add_action( 'admin_notices', 'mfp_display_admin_notice' );

/**
 * 在管理后台显示欢迎通知的函数。
 * 该函数通过 `admin_notices` 钩子被调用。
 */
function mfp_display_admin_notice() {
    // 检查当前用户是否有管理权限，避免向普通用户显示
    if ( ! current_user_can( 'manage_options' ) ) {
        return;
    }
    ?>
    <div class="notice notice-success is-dismissible">
        <p><?php _e( '欢迎使用“我的第一个插件”！', 'my-first-plugin' ); ?></p>
    </div>
    &lt;?php
}

Code-Erläuterung:add_action()Die Funktion verwendet unsere eigene, selbstdefinierte Funktion.mfp_display_admin_noticeMounten aufadmin_noticesAuf diesem Haken. Wenn WordPress auf die Bereich für Benachrichtigungen im Hintergrund zugreift, wird unsere Funktion aufgerufen. Innerhalb der Funktion werden zunächst die Benutzerrechte überprüft und anschließend eine HTML-Benachrichtigung ausgegeben, die einen erfolgreichen Aussehen sowie einen Schaltknopf zur Schließung der Benachrichtigung enthält.__()oder_e()Es ist eine gute Praxis, Funktionen zur Internationalisierung von Texten zu nutzen.

Hinein ins Kern: Hooks, Shortcodes und Optionen

Um Plugins mit umfangreichen Funktionen zu entwickeln, ist es erforderlich, einige der Kernerweiterungsmechanismen von WordPress zu beherrschen: Hooks, Shortcodes und die Options-API.

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

Verstehen und Anwenden von Action- sowie Filter-Hooks

Hooks sind die Grundlage der WordPress-Plugin-Architektur und ermöglichen es Ihnen, Ihren eigenen Code an bestimmten Stellen während der Ausführung des Kerncodes einzufügen. Es gibt zwei Arten von Hooks: Actions und Filters.

Action Hooks führen Ihren Code aus, wenn ein bestimmtes Ereignis stattfindet, und es ist nicht erforderlich, einen Rückgabewert zu liefern. Zum Beispiel…init(Initialisierung)wp_enqueue_scripts(Laden der Frontend-Scripte und -Styles)save_post(Beim Speichern des Artikels): Was wir zuvor verwendet haben…admin_noticesEs handelt sich dabei um einen Action-Hook.

Filter-Hooks werden verwendet, um Daten zu modifizieren. Sie erhalten einen Wert und erfordern, dass Sie den modifizierten Wert zurückgeben. Zum Beispiel:the_titleDie Filter ermöglichen es Ihnen, die Ausgabe der Artikelüberschriften zu ändern.widget_textDie Filter ermöglichen es Ihnen, den Textinhalt der Widgets zu ändern.

// 使用过滤器修改文章标题
add_filter( 'the_title', 'mfp_modify_post_title' );
function mfp_modify_post_title( $title ) {
    if ( ! is_admin() && in_the_loop() ) {
        return '📢 ' . $title;
    }
    return $title;
}

Erstellen und verwenden von Shortcodes

Shortcodes ermöglichen es den Nutzern, durch die Verwendung einer einfachen Kennzeichnung (z. B. einen „Tag“) bestimmte Funktionen oder Aktionen auszuführen.[my_shortcode]In Artikeln oder Seiten dynamische Inhalte einfügen. Dazu wird…add_shortcode()Eine Funktion zum Registrieren von Kurzcodes.

// 注册一个短代码
add_shortcode( 'mfp_current_time', 'mfp_render_current_time_shortcode' );
/**
 * 渲染显示当前时间的短代码。
 * @param array $atts 短代码属性。
 * @param string $content 短代码包裹的内容（如果有）。
 * @return string 渲染后的HTML。
 */
function mfp_render_current_time_shortcode( $atts = [], $content = null ) {
    // 使用 shortcode_atts 设置默认属性并合并用户输入
    $atts = shortcode_atts( [
        'format' => 'Y-m-d H:i:s',
    ], $atts, 'mfp_current_time' );

// 根据格式获取当前时间
    $current_time = date( $atts['format'] );

// 返回输出
    return '<p class="mfp-time">Aktuelle Zeit: '. esc_html($current_time).'</p>';
}

Benutzer können im Editor Eingaben tätigen.[mfp_current_time format="F j, Y"]Zeit wird in einem bestimmten Format angezeigt.

Die Einstellungen mithilfe der Option-API speichern.

Plugins benötigen in der Regel die Speicherung bestimmter Konfigurationsdaten. WordPress stellt die Options-API bereit, um diese Konfigurationsdaten zu verwalten.wp_optionsDaten werden sicher in der Tabelle gespeichert, abgerufen und aktualisiert.

ausnutzenadd_option()、get_option()、update_option()unddelete_option()Es gibt Funktionen, die zur Verarbeitung von Daten verwendet werden. Zur besseren Übersichtlichkeit empfiehlt es sich, allen Schlüsseln für Ihre Optionen einen einheitlichen Präfix hinzuzufügen.

// 定义默认选项
define( 'MFP_DEFAULT_MESSAGE', '你好，世界！' );

// 插件激活时设置默认选项（需要注册激活钩子）
register_activation_hook( __FILE__, 'mfp_set_default_options' );
function mfp_set_default_options() {
    if ( false === get_option( 'mfp_custom_message' ) ) {
        add_option( 'mfp_custom_message', MFP_DEFAULT_MESSAGE );
    }
}

// 在代码中获取选项值
$message = get_option( 'mfp_custom_message', MFP_DEFAULT_MESSAGE );
echo esc_html( $message );

Erstellen Sie professionelle Plugins: Sicherheit, Verwaltung und Veröffentlichung

Wenn die Funktionen eines Plugins allmählich komplexer werden, müssen Aspekte wie die Codeorganisation, die Sicherheit, die Benutzeroberfläche sowie der Veröffentlichungsprozess berücksichtigt werden.

Befolgen Sie die besten Sicherheitspraktiken.

Sicherheit ist die Lebensader bei der Entwicklung von Plugins. Das wichtigste Prinzip lautet: Vertrauen Sie niemals den von Benutzern eingegebenen Daten. Alle Daten, die von Benutzern, der Datenbank oder externen APIs stammen, müssen überprüft, gereinigt und entschärft werden.
* 验证（Validation）：检查数据是否符合预期格式（如是否是邮箱、数字），使用filter_var()、preg_match()oder WordPress-Funktionen wieis_email()。
* 清理（Sanitization）：清理数据，移除不安全字符。对于文本输入，使用sanitize_text_field()Für HTML-Inhalt wird… verwendet.wp_kses_post()Bei URLs wird…esc_url_raw()。
* 转义（Escaping）：在将数据输出到HTML、JavaScript或URL时，根据上下文进行转义。使用esc_html()、esc_attr()、esc_js()、esc_url()Zum Beispiel können Sie die folgenden Funktionen verwenden:
* 非ce验证：所有可能修改数据库的操作（如表单提交）都必须包含非ce验证，使用wp_nonce_field()、wp_verify_nonce()。

Erstellen einer Seite mit administrativen Einstellungen

Für Plugins, die eine Konfiguration durch den Benutzer erfordern, ist es unerlässlich, eine klare Verwaltungsseite zur Verfügung zu stellen. WordPress bietet eine Setup-API, die diesen Prozess vereinfacht. Diese API kümmert sich automatisch um die Überprüfung der Zertifizierung (CE-Zertifizierung), die Überprüfung der Berechtigungen sowie das Speichern der Daten.

Sie müssen Folgendes verwenden:add_options_page()oderadd_menu_page()Fügen Sie die entsprechenden Funktionen auf die Seite hinzu und verwenden Sie sie anschließend.register_setting()、add_settings_section()undadd_settings_field()Um die Einstellungsfelder zu definieren…

Organisieren von Code und Vorbereitung auf die Veröffentlichung

Verstauen Sie nicht den gesamten Code in der Hauptdatei. Mit wachsenden Anzahl von Plugins sollte der Code nach funktionalen Modulen in verschiedene Dateien aufgeteilt werden. Eine typische Verzeichnisstruktur könnte folgende Elemente enthalten:
* /adminHier werden die Code-Dateien für die Backend-Bereiche gespeichert (z. B. Seiten zur Konfiguration usw.).
* /publicHier werden die mit der Frontend-Entwicklung verbundenen Codes gespeichert.
* /includesHier werden die Klassen und Funktionen für die Kernfunktionen gespeichert.
* /assetsHier werden CSS-Dateien, JavaScript-Code sowie Bilder gespeichert.
* /languagesHier werden die Dateien für die internationale Lokalisierung (Formaten .po und .mo) abgelegt.

ausnutzenrequire_onceoderinclude_onceFühren Sie diese Dateien an den entsprechenden Stellen ein. Betrachten Sie die Verwendung von Composer zur Verwaltung von PHP-Abhängigkeiten sowie die Nutzung von NPM/Yarn zur Verwaltung von Frontend-Ressourcen.

Vor der Veröffentlichung stellen Sie sicher, dass Ihr Plugin den offiziellen „Plugin-Entwicklungshandbuch“ sowie die „Codierstandards“ von WordPress entspricht. Verwenden Sie Tools wie PHP_CodeSniffer zur Überprüfung. Schreiben Sie außerdem eine klare und verständliche Dokumentation zu Ihrem Plugin.readme.txtDatei: Detaillierte Beschreibung der Funktionen, Installationsanweisungen, Screenshote und Aktualisierungsprotokolle.

Zusammenfassungen

Die Entwicklung von WordPress-Plugins ist eine Reise, die mit dem Verständnis der Grundlagen (Plugin-Dateien, Hooks) beginnt, sich allmählich zu den Kernkonzepten (Shortcodes, Options-API) vertieft und schließlich zu einer professionellen Entwicklung (Sicherheit, Architektur, Veröffentlichung) führt. Indem Sie mit der Erstellung eines einfachen “Hello World”-Plugins starten und nach und nach Funktionen wie Benachrichtigungen im Hintergrund, Shortcodes sowie Einstellmöglichkeiten hinzufügen, können Sie den gesamten Entwicklungsprozess systematisch erlernen. Denken Sie daran: Der Schlüssel zu erfolgreichen Plugins liegt darin, sicheren, effizienten und wartbaren Code zu schreiben sowie die Normen und Best Practices der WordPress-Community einzuhalten. Durch kontinuierliches Lernen, das Lesen der offiziellen Dokumentationen sowie der Quellcodes ausgezeichneter Plugins werden Sie Ihre Fähigkeiten stetig verbessern und von einem Anfänger zu einem Experten werden.

FAQ Häufig gestellte Fragen

Muss man für die Entwicklung des Plugins #### PHP beherrschen?
Ja, eine solide Grundlage in PHP ist unerlässlich, da sowohl der Kern von WordPress als auch seine Plugins in PHP programmiert sind. Du musst die PHP-Syntax, Funktionen, Arrays sowie Konzepte der objektorientierten Programmierung verstehen. Außerdem ist ein grundlegendes Wissen über HTML, CSS und JavaScript von großer Bedeutung, um die Frontend-Oberflächen und Interaktionen der Plugins zu erstellen.

Was ist der Unterschied zwischen den functions.php-Dateien von Plugins und Themes?

Platzieren Sie den Funktionscode im Thema.functions.phpIn der Datei wird diese Funktion mit einem bestimmten Thema verknüpft. Wenn Sie das Thema wechseln, werden diese Funktionen deaktiviert. Plugins hingegen sind unabhängig von den Themen und funktionieren in jedem aktivierten Thema – was die Wiederverwendung, Wartung und Verbreitung der Funktionen erleichtert. Für Funktionen, die für eine langfristige Nutzung oder die Weitergabe an andere Personen vorgesehen sind, sollte die Entwicklung von Plugins bevorzugt werden.

Wie debugge ich den Code meines Plugins?

Das Aktivieren des WordPress-Debugging-Modus ist der wichtigste erste Schritt – dies erfolgt durch die entsprechenden Einstellungen.WP_DEBUGVerwenden Sie entsprechende Konstanten, um Fehler anzuzeigen.error_log()Die Funktion speichert die Variableninformationen im Server-Fehlerprotokoll.debug.logIm File befinden sich weitere Informationen. Darüber hinaus kann man professionelle Debugging-Plugins installieren, wie zum Beispiel Query Monitor, die detaillierte Informationen zu Datenbankabfragen, Hooks und Skripten bereitstellen und somit ein sehr nützliches Werkzeug für Entwickler sind.

Wie kann meine Erweiterung die Internationalisierung in mehreren Sprachen umsetzen?

WordPress nutzt das GNU gettext-Framework für die Internationalisierung. In deinem Plugin solltest du für alle für die Benutzer bestimmten Zeichenketten die entsprechenden Übersetzungsfunktionen verwenden.()、_e()、esc_html()Warten Sie ab, und geben Sie den Textbereich (Text Domain) an. Anschließend verwenden Sie Tools wie Poedit, um den Code der Erweiterung zu analysieren und die entsprechenden Ergebnisse zu erzeugen..potTemplate-Dateien – Die Übersetzer verwenden diese als Grundlage, um Übersetzungen in verschiedene Sprachen zu erstellen..pound.moDatei – legen Sie sie in das Plugin./languagesSie können es einfach im Verzeichnis ablegen.