Einführung in die Entwicklung von WordPress-Plugins: Erstellen Sie Ihr erstes Plugin von Grund auf

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

Als weltweit beliebtestes Content-Management-System (CMS) verdankt WordPress seine starke Erweiterbarkeit in erster Linie den Plugins. Durch die Entwicklung von Plugins können Sie Ihrer Website beliebige benutzerdefinierte Funktionen hinzufügen, ohne die Kerndateien ändern zu müssen – dies gewährleistet die Kompatibilität bei Updates von WordPress. Egal, ob Sie die Anforderungen eines bestimmten Projekts erfüllen, ein häufiges Problem lösen oder Ihre Lösungen mit der Community teilen und damit Einnahmen erzielen möchten: Die Entwicklung von Plugins ist eine äußerst wertvolle Fähigkeit.

Das Lernen der Plugin-Entwicklung ermöglicht es Ihnen nicht nur, den Betriebsmechanismus von WordPress tiefgreifend zu verstehen – beispielsweise das Hook-System und Shortcodes –, sondern verbessert auch Ihre PHP-Programmierfähigkeiten. Von einfachen Funktionserweiterungen bis hin zu komplexen Anwendungsintegrationen ist alles möglich.

Erstellen Sie Ihre eigene Entwicklungsumgebung für Plugins.

Bevor Sie mit dem Schreiben des Codes beginnen, ist eine geeignete lokale Entwicklungsumgebung von entscheidender Bedeutung. Sie ermöglicht es Ihnen, Tests und Fehlersuche sicher durchzuführen, ohne dass dies die Online-Website beeinträchtigt.

Empfohlene Lektüre Das ultimative Handbuch für die Entwicklung von WordPress-Plugins: Von Null bis Eins professionelle Plugins erstellen。

Konfigurieren Sie die lokale Serverumgebung.

Es wird empfohlen, integrierte lokale Entwicklungstools wie Local by Flywheel, DevKinsta oder XAMPP zu verwenden. Diese Tools lassen sich mit nur einem Klick installieren und enthalten Apache/Nginx, PHP sowie MySQL. Stellen Sie sicher, dass Ihre PHP-Version mit dem Zielserver kompatibel ist; in der Regel wird PHP 7.4 oder eine höhere Version empfohlen, um bessere Leistung und Sicherheit zu erzielen.

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

WordPress installieren und einrichten

Installieren Sie eine brandneue WordPress-Instanz auf Ihrem lokalen Server. Es wird empfohlen, das Standard-Thema (z. B. die Twenty Twenty-Serie) für die Entwicklung und Tests zu verwenden, um Probleme mit der Kompatibilität der Themes auszuschließen.wp-config.phpIm File: Aktivieren.WP_DEBUGKonstanten helfen Ihnen dabei, Fehler während des Entwicklungsprozesses schnell zu erkennen.

define( 'WP_DEBUG', true );

Vorbereiten Sie einen Code-Editor.

Wählen Sie einen leistungsstarken Code-Editor wie Visual Studio Code, PhpStorm oder Sublime Text aus. Installieren Sie dazu passende Erweiterungen – beispielsweise PHP-Intelligenz-Erkennungsfunktionen oder WordPress-Code-Snippets – diese können Ihre Programmiereffizienz erheblich steigern.

Erstellen Sie Ihre erste Plugin-Datei.

Ein WordPress-Plugin ist im Wesentlichen ein oder mehrere Elemente, die sich in/wp-content/plugins/Die PHP-Dateien im Verzeichnis. Beginnen wir jetzt mit der grundlegendsten Struktur.

Verfassen Sie Kommentare zum Kopfbereich des Plugins.

Jeder Plugin muss eine Kopfansage in einem standardisierten Format enthalten, mit der WordPress die Informationen über das Plugin erkennen kann. In Ihrem Plugin-Verzeichnis (z. B.)/wp-content/plugins/my-first-plugin/In diesem Kontext soll ein Objekt mit dem Namen „“ erstellt werden.my-first-plugin.phpDie Hauptdatei.

Empfohlene Lektüre Vom Einstieg zum Meistern: Ein umfassender Leitfaden für die Entwicklung von WordPress-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
 * Domain Path:       /languages
 */

Diese Anmerkung definiert die Informationen, die das Plugin in der WordPress-Backend-Verwaltungsoberfläche anzeigt – insbesondere den Namen und die Beschreibung des Plugins.Text DomainFür die internationale Übersetzung verwendet.

Grundlegende Sicherheitskonzepte für die Entwicklung von Plugins

Um direkten Zugriff auf Ihre Plugin-Dateien zu verhindern, können Sie am Anfang der Datei einen Sicherheitscode hinzufügen. Dies ist eine bewährte Praxis bei der Entwicklung von WordPress-Plugins.

// 防止直接访问
if ( ! defined( 'ABSPATH' ) ) {
	exit; // 如果未定义ABSPATH（WordPress根目录的绝对路径），则退出
}

ABSPATHEs handelt sich um eine Konstante, die von WordPress definiert wird und den absoluten Pfad zu seiner Installation darstellt. Durch die Überprüfung, ob diese Konstante vorhanden ist, kann effektiv verhindert werden, dass externe Benutzer direkt über die URL auf Ihre Plugin-Dateien zugreifen.

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

Implementierung der Kernfunktionen: Hinzufügen eines Verwaltungsmenüs und von Einstellungen

Ein vollständiges Plugin benötigt in der Regel eine Konfigurationsoberfläche im WordPress-Backend. Wir werden mithilfe der von WordPress bereitgestellten API eine einfache Verwaltungsmenüseite hinzufügen.

Mit einer Funktion das oberste Verwaltungsmenü hinzufügen

Wir werden es verwenden.add_action()Die Funktion wird montiert.admin_menuAuf der Schlaufe wird dadurch ein Menüeintrag im Hintergrund hinzugefügt. Führen Sie im Haupt-Plugin-File den folgenden Code fort.

// 添加管理菜单
function mfp_add_admin_menu() {
    add_menu_page(
        '我的第一个插件设置', // 页面标题
        '我的插件',           // 菜单标题
        'manage_options',    // 所需权限（管理员）
        'my-first-plugin',   // 菜单slug
        'mfp_settings_page', // 显示页面内容的回调函数
        'dashicons-admin-generic', // 图标（使用Dashicons）
        80                    // 菜单位置
    );
}
add_action( 'admin_menu', 'mfp_add_admin_menu' );

Hier,add_menu_page()Die Funktion dient zum Erstellen eines obersten Menüs. Die Parameter definieren die Seiteüberschrift, die Menüüberschrift, die Zugriffsrechte, die eindeutige Identifikationsnummer („Slug“), die Callback-Funktion zur Ausgabe der Seiteninhalte, das Symbol sowie die Position des Menüs im Seitenbereich („Sidebar“).

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

Erstellen Sie eine Callback-Funktion für die Seite zur Konfiguration der Einstellungen.

Jetzt müssen wir die oben erwähnten Aspekte definieren.mfp_settings_page()Die Funktion gibt den HTML-Inhalt der Verwaltungsseite aus.

// 设置页面回调函数
function mfp_settings_page() {
    // 检查用户权限
    if ( ! current_user_can( 'manage_options' ) ) {
        return;
    }
    ?>
    <div class="wrap">
        <h1>\n</h1>
        <p>Willkommen auf der Einstellungsseite meines ersten Plugins! Hier werden in Zukunft Formulare und Optionen hinzugefügt.</p>
        <form action="/de/options.php/" method="post" data-trp-original-action="options.php">
            <?php
            // 输出设置字段、非ce等（后续扩展）
            settings_fields( 'mfp_options_group' );
            do_settings_sections( 'my-first-plugin' );
            submit_button( '保存设置' );
            ?>
        <input type="hidden" name="trp-form-language" value="de"/></form>
    </div>
    &lt;?php
}

Diese Funktion prüft zunächst, ob der aktuelle Benutzer über die erforderlichen Berechtigungen verfügt.manage_optionsRechte (in der Regel für Administratoren), anschließend wird ein einfaches Rahmenkonzept für eine Einstellungsseite ausgegeben.settings_fields()unddo_settings_sections()Dies dient der Reservierung von Optionen für die API-Registrierung zur späteren Nutzung mit WordPress.

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

Für das Plugin wird eine einfache Frontend-Funktion hinzugefügt.

Neben der Backend-Verwaltungsoberfläche dienen Plugins häufig dazu, Funktionen für die Frontend-Seiten einer Website bereitzustellen. Wir werden einen einfachen Shortcode erstellen, mit dem Benutzer Funktionen in Artikeln oder Seiten aufrufen können.

Verwenden Sie Funktionen, um Kurzcodes zu registrieren.

Shortcodes ermöglichen es den Nutzern,[shortcode]Solche einfachen Tags ermöglichen es, dynamische Funktionen in den Inhalt einzubauen.add_shortcode()Der Funktion wird registriert.

// 注册一个短代码
function mfp_hello_world_shortcode( $atts ) {
    // 短码属性，设置默认值
    $atts = shortcode_atts(
        array(
            'name' => '访客',
        ),
        $atts,
        'mfp_hello'
    );

// 安全地输出内容
    return '<p>Hallo, '. esc_html($atts['name'])'. ‘! Dies ist der Gruß, der von meinem Plugin generiert wurde.</p>'php
add_shortcode('mfp_hello', 'mfp_hello_world_shortcode');

add_shortcode()Die Funktion nimmt zwei Parameter entgegen: den Namen des Kurzcode-Labels (den Namen, den der Benutzer verwendet) und die zugehörige Verarbeitungsfunktion.shortcode_atts()Die Funktion dient dazu, die von den Benutzern eingegebenen Attribute mit den Standardwerten zu kombinieren, um die Robustheit des Codes zu gewährleisten.

Frontend-Test für kurzen Code

Nachdem Sie die Plugin-Datei gespeichert haben, gehen Sie zur “Plugins”-Seite im WordPress-Backend und aktivieren Sie “Mein erstes Plugin”. Anschließend erstellen Sie oder bearbeiten Sie einen Artikel und geben Sie den Text direkt im Inhaltseeditor ein.[mfp_hello name="小明"]Nach der Veröffentlichung des Artikels wird auf der Frontend-Seite die Meldung angezeigt: “Hallo, Xiaoming! Dies ist die Begrüßung, die von meinem Plugin generiert wurde.” Wenn das Attribut `name` nicht angegeben wird, wird…[mfp_hello]Dann wird der Standardtext “Hallo, Besucher!” angezeigt.

Zusammenfassungen

Mit dieser Anleitung haben Sie den gesamten Prozess der Erstellung eines grundlegenden WordPress-Plugins von Grund auf abgeschlossen. Sie haben die grundlegende Struktur eines Plugins kennengelernt, die Wichtigkeit von Kopfzeilen-Anmerkungen verstanden, gelernt, wie man ein Backend-Verwaltungsmenü hinzufügt, sowie wie man einen einfachen, aber praktischen Frontend-Shortcode erstellt. All dies sind die Grundpfeiler der Entwicklung von WordPress-Plugins.

Die echte Reise der Plugin-Entwicklung hat gerade erst begonnen. Im nächsten Schritt kannst du die leistungsstarke Setup-API von WordPress nutzen, um speicherbare Einstellungen zu erstellen, sowie Action-Hooks einsetzen.add_action()„Filter Hooks“add_filter()Sie werden die Kernfunktionen des Plugins anpassen, lernen, wie man Internationalisierungsunterstützung hinzufügt, und erfahren, wie man Benutzerdaten sicher verarbeitet. Denken Sie daran: Die Einhaltung der WordPress-Programmierstandards sowie ein besonderer Fokus auf Sicherheit sind entscheidend für die Entwicklung hochwertiger Plugins.

FAQ Häufig gestellte Fragen

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

Sie sollten über grundlegende PHP-Programmierkenntnisse verfügen, HTML und CSS verstehen sowie die grundlegenden Funktionen von WordPress beherrschen – beispielsweise das Veröffentlichen von Artikeln und das Installieren von Themes/Plugins. Eine Vertrautheit mit objektorientiertem Programmieren (OOP) ist nicht zwingend erforderlich, aber sie kann die Entwicklung komplexerer Plugins erheblich erleichtern.

Muss der Name der Hauptdatei des Plugins mit dem Namen des Verzeichnisses übereinstimmen?

Es ist nicht zwingend erforderlich, aber dies ist eine stark empfohlene beste Praxis, die die Struktur klarer macht. Die PHP-Datei des Hauptplugins kann jeden Namen haben, doch die Kommentare am Anfang der Datei müssen korrekt sein, und die Datei muss sich im Ordner des Plugins selbst befinden. Der Name des Ordners entspricht in der Regel dem „Slug“ des Plugins.

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

Außerdem…WP_DEBUGSie können auch folgendes verwenden:error_log()Die Funktion schreibt die Debugging-Informationen in das Fehlerprotokoll des Servers oder verwendet dazu eine andere Methode.var_dump()undwp_die()Eine Ausgabeüberprüfung durchführen (nur für die Entwicklungsumgebung). Die Verwendung von Debugging-Plugins wie Query Monitor ist ebenfalls eine effiziente Option.

Wie kann ich den von mir entwickelten Plugin in das offizielle WordPress-Plugin-Verzeichnis veröffentlichen?

Zunächst musst du sicherstellen, dass der Code deines Plugins den Veröffentlichungsanforderungen von WordPress entspricht – dies umfasst unter anderem eine GPL-kompatible Lizenz, eine hohe Codequalität, Sicherheitsaspekte sowie die Unterstützung mehrerer Sprachen (Internationalisierung). Anschließend solltest du auf WordPress.org einen SVN-Repository anlegen, deinen Code dort hochladen und den Überprüfungsprozess durchlaufen. Die offiziellen WordPress-Website bieten eine detaillierte Anleitung für das Einreichen von Plugins.