Komplettes Handbuch für die Entwicklung von WordPress-Plugins: Von der Grundlage bis zur Erstellung benutzerdefinierter Funktionen

Vorbereitungsarbeiten und Umgebungseinstellungen

Bevor Sie mit dem Schreiben des Codes beginnen, ist eine stabile und professionelle Entwicklungsumgebung die Grundlage für Erfolg. Sie verbessert nicht nur Ihre Kodiereffizienz, sondern sorgt auch dafür, dass die Plugins in verschiedenen Umgebungen kompatibel sind.

Konfiguration der lokalen Entwicklungsumgebung

Es wird empfohlen, ein lokales Serverumgebungs-Kit zu verwenden, wie z. B. Local by Flywheel, XAMPP oder MAMP. Diese Tools ermöglichen die einfache Einrichtung von Apache, MySQL und PHP und simulieren somit perfekt die Umgebung eines Online-Servers. Stellen Sie sicher, dass Ihre PHP-Version den Anforderungen der gewünschten WordPress-Version entspricht; in der Regel wird PHP 7.4 oder eine höhere Version empfohlen, um bessere Leistung und Sicherheit zu erzielen.

Code-Editor- und -Tool-Auswahl

Ein leistungsstarker Code-Editor ist von entscheidender Bedeutung. Tools wie Visual Studio Code, PhpStorm oder Sublime Text sind hervorragende Wahlmöglichkeiten – sie bieten Funktionen wie Syntax-Hervorhebung, Code-Vorschläge sowie die Möglichkeit zum Debuggen. Darüber hinaus ist die Installation des Versionskontrolltools Git ein Branchenstandard, um Code-Änderungen zu verwalten, im Team zusammenzuarbeiten und Backups zu erstellen.

Empfohlene Lektüre Die ultimative Anleitung zur Entwicklung von WordPress-Plugins: Der Weg vom Anfänger zum Experten in der Praxis。

Erstellen Sie Ihre erste Plugin-Datei.

Der Kernbestandteil eines WordPress-Plugins ist seine Hauptdatei. Diese Datei enthält nicht nur den ausführbaren Code des Plugins, sondern gibt auch über spezielle Kommentare im Dateianfang Metadaten des Plugins an das WordPress-System bekannt.

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

Die Struktur der Hauptdatei eines Plugins

Jeder Plugin muss eine Haupt-PHP-Datei haben. Wir nennen diese Datei in der Regel nach der Funktion des Plugins, zum Beispiel… my-first-plugin.phpAm Anfang des Files müssen die standardmäßigen Plugin-Hauptkommentare enthalten sein – dies ist entscheidend dafür, dass WordPress das Plugin erkennt.

<?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
 */

Diese Anmerkung weist WordPress an, auf der “Plugins”-Seite im Backend die Namen, Beschreibungen und weitere Informationen der Plugins anzuzeigen. Text Domain Zur Internationalisierung verwendet – um die anschließenden Übersetzungsarbeiten vorzubereiten.

Aktivieren und Deaktivieren von Plugins

Nachdem Sie die Hauptdatei erstellt haben, müssen Sie sie in den Installationsordner von WordPress legen. /wp-content/plugins/ Im Ordner. Sie können die Dateien auch einzeln ablegen oder für sie einen eigenen Verzeichnis erstellen (z. B. „Dateien_1“ oder „Spezielle_Dateien“). /wp-content/plugins/my-first-plugin/Danach fügen Sie die Hauptdatei hinzu. Nach Abschluss des Prozesses loggen Sie sich in das WordPress-Backend ein, gehen auf die “Plugins”-Seite und sehen dort das neue Plugin. Klicken Sie darauf, um es zu aktivieren.

Verständnis der Kernmechanismen von WordPress: Hooks und Filter

Die Stärke und Flexibilität von WordPress beruht in hohem Maße auf seinem “Hook”-System. Plugins können durch das Anhängen an diese Hooks das Verhalten von WordPress ändern oder erweitern, ohne den Kerncode zu modifizieren.

Empfohlene Lektüre Eindeutige Analyse der WordPress-Plugin-Entwicklung: Von der Grundlage aus eigene Funktionen erstellen und erweitern。

Die Verwendung von Aktionshaken (Action Hooks)

Action Hooks ermöglichen es Ihnen, benutzerdefinierten Code zu bestimmten Zeitpunkten auszuführen – beispielsweise wenn ein Artikel veröffentlicht wird, wenn ein Benutzer sich anmeldet oder wenn eine Backend-Verwaltungsseite geladen wird. add_action() Eine Funktion kann Ihre eigene Funktion an einen bestimmten „Hook“ binden (also an einen bestimmten Punkt im Ablauf eines Programms).

Das folgende Beispiel zeigt, wie man einen benutzerdefinierten Text am unteren Rand der Frontend-Seite einer Website hinzufügt. Wir verwenden… wp_footer Dieser Aktions-Hook.

function myplugin_add_footer_text() {
    echo '<p style="text-align:center;">Vielen Dank, dass Sie diese Website nutzen!</p>';
}
add_action( 'wp_footer', 'myplugin_add_footer_text' );

Die Anwendung von Filtern

Filter dienen dazu, während des Prozesses erzeugte Daten zu verändern. Im Gegensatz zu Aktionen müssen Filter einen Eingabewert erhalten und einen veränderten Wert zurückgeben. add_filter() Eine Funktion, die den Filter anwendet.

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

Zum Beispiel ändert der folgende Code die Anzeige am Ende der Artikelüberschriften und fügt allen Überschriften einen Suffix hinzu. Wir verwenden… the_title Dieser Filter.

function myplugin_modify_title( $title ) {
    // 确保只在主循环中修改
    if ( is_single() ) {
        return $title . ' [推荐阅读]';
    }
    return $title;
}
add_filter( 'the_title', 'myplugin_modify_title' );

Eine Einstellungsseite für das Plugin hinzufügen

Ein ausgereiftes Plugin sollte den Nutzern in der Regel Konfigurationsmöglichkeiten bieten. In WordPress gibt es standardisierte Methoden, um Einstellungsseiten für Plugins zu erstellen, die an verschiedenen Stellen im Backend-Menü platziert werden können.

Erstellen Sie eine Menüeinträge für die Verwaltung.

Zuerst musst du verwenden… add_action( ‘admin_menu’, … ) Ein Hook wird verwendet, um eine neue Menüseite zu registrieren. WordPress bietet mehrere Funktionen zur Hinzufügung von Menüs auf verschiedenen Ebenen. add_menu_page()(Top-Level Menu) oder add_options_page()(Zu dem Untermenü “Einstellungen” hinzufügen.)

Empfohlene Lektüre Komplettes Handbuch für die Entwicklung von WordPress-Plugins: Von den Grundlagen bis zur Erstellung funktionaler, ausgereifter Plugins。

Der folgende Code zeigt, wie man eine einfache Menüseite mit einem obersten Menü erstellt. Funktion myplugin_settings_page_html Verantwortlich für die Darstellung des HTML-Inhalts dieser Seite.

function myplugin_add_menu() {
    add_menu_page(
        ‘我的插件设置’,          // 页面标题
        ‘我的插件’,             // 菜单标题
        ‘manage_options’,      // 所需权限
        ‘myplugin’,            // 菜单 Slug
        ‘myplugin_settings_page_html’, // 回调函数
        ‘dashicons-admin-generic’, // 图标（可选）
        20                     // 位置（可选）
    );
}
add_action( ‘admin_menu’, ‘myplugin_add_menu’ );

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

Registrierungseinstellungen, Felder und Abschnitte

Um die oben genannte Form in der Lage zu sein, Daten zu speichern, müssen Sie die WordPress-Settings-API verwenden. Dazu gehört unter anderem die Konfiguration der entsprechenden Funktionen in den WordPress-Settings. register_setting() Registrieren Sie eine Einstellungsgruppe und verwenden Sie sie… add_settings_section() Fügen Sie einen Abschnitt hinzu und verwenden Sie dazu… add_settings_field() Fügen Sie die konkreten Felder hinzu.

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

Dieser Prozess findet in der Regel… admin_init Die Verarbeitung erfolgt im Hook-Modus. Durch die Einrichtung der API werden die Datenverifikation sowie die Speicherung automatisch durchgeführt. wp_options Die Integration von Authentifizierungsmethoden (z. B. OAuth, JWT) sowie Sicherheitsmechanismen (z. B. Nonce-Prüfungen) hat die Entwicklungsarbeit erheblich vereinfacht.

Zusammenfassungen

Die Entwicklung von WordPress-Plugins ist ein systematisches Projekt, das von der Einrichtung der Umgebung und der Erstellung grundlegender Dateien über das tiefe Verständnis sowie die Anwendung des Hook-Systems bis hin zur Erstellung einer Benutzeroberfläche für die Interaktion mit dem Plugin reicht. Die Befolgung der WordPress-Programmierstandards und -Best Practices (wie der Verwendung von Kommentaren im Plugin-Hauptteil, sicherer Funktionsepfälze, Internationalisierung und der Einrichtung von APIs) sorgt nicht nur für einen stabilen Betrieb des Plugins, sondern macht es auch leichter zu warten und zu erweitern. Der Schlüssel liegt darin, das umfangreiche Hook-Ökosystem von WordPress zu nutzen, um die Funktionalitäten einer Website auf modulare und nicht-invasive Weise zu erweitern. Durch die praktischen Übungen in diesem Leitfaden haben Sie nun den grundlegenden Ablauf kennengelernt, um ein vollständig funktionsfähiges und strukturiertes benutzerdefiniertes Plugin von Grund auf zu erstellen.

FAQ Häufig gestellte Fragen

Welche Programmierkenntnisse sind für die Entwicklung von Plugins erforderlich?

Sie benötigen fundierte Kenntnisse in PHP, da der Kern von WordPress sowie seine Plugins hauptsächlich in PHP programmiert sind. Ebenso ist ein grundlegendes Verständnis von HTML, CSS und JavaScript (insbesondere jQuery, da jQuery in vielen älteren WordPress-Codebausteinen weit verbreitet ist) erforderlich, um die Frontend-Anzeige und -Interaktionen zu verwalten. Es kann auch hilfreich sein, sich mit den grundlegenden Konzepten der MySQL-Datenbankarbeit vertraut zu machen.

Wie kann man vermeiden, dass die Namen von Plugin-Funktionen mit denen anderer Plugins in Konflikt geraten?

Die beste Praxis, um Konflikte zu vermeiden, besteht darin, allen Ihren Funktionen, Klassen, Konstanten und Variablen ein eindeutiges Präfix zu geben. Dieses Präfix sollte ausreichend einzigartig sein und in der Regel mit dem Namen oder der Abkürzung Ihres Plugins in Verbindung stehen. Zum Beispiel, wenn Ihr Plugin “Awesome Widget” heißt, könnten Sie ein Präfix wie „aww“ verwenden. aw_、awesome_widget_ oder AW_ 作为前缀。将代码封装在类（Class）中也是现代 WordPress 插件开发中广泛采用的、更优雅的避免冲突和组织代码的方式。

In welchem Verzeichnis sollten die Plugins gespeichert werden?

Die Plugin-Dateien sollten im Installationsverzeichnis von WordPress gespeichert werden. /wp-content/plugins/ Im Verzeichnis. Für einfache, einzelne Plugins kann die Haupt-PHP-Datei direkt in dieses Verzeichnis gelegt werden. Für komplexere Plugins wird dringend empfohlen, ein separates Unterverzeichnis zu erstellen, das nach dem Namen des Plugins benannt ist (z. B. /wp-content/plugins/my-awesome-plugin/Dann organisieren Sie alle Plugin-Dateien (PHP, CSS, JS, Bilder usw.) in diesem Unterordner. Dadurch wird die Verwaltung der Dateien klarer und ordentlicher.

Wie fügt man einer Erweiterung (Plugin) Unterstützung für die Übersetzung hinzu?

Um eine Internationalisierungs- (I18N-)Unterstützung für ein Plugin hinzuzufügen, sind hauptsächlich die folgenden Schritte erforderlich: Zunächst muss die Internationalisierung in den Kommentaren am Anfang des Plugins korrekt konfiguriert werden. Text DomainUnd verwenden Sie in Ihrem Code die Übersetzungsfunktionen von WordPress, wie zum Beispiel… ()、_e()、esc_html() Warten Sie, bis alle zu übersetzenden Zeichenketten eingefasst sind. Anschließend verwenden Sie Tools wie Poedit, um diese Zeichenketten zu extrahieren und eine Übersetzung zu erstellen. .pot Template-Dateien, und basierend darauf werden die entsprechenden Sprachversionen erstellt. .po und .mo Schließlich wird dies beim Initialisieren des Plugins verwendet. load_plugin_textdomain() Eine Funktion zum Laden der Übersetzung.