Erlernen Sie die Entwicklung von WordPress-Plugins: Erstellen Sie Ihre erste Funktionserweiterung von Grund auf.

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

WordPress ist zu dem weltweit beliebtesten Content Management System (CMS) geworden – und das liegt vor allem an seiner leistungsstarken Plugin-Architektur. Mit Plugins können Entwickler ohne Änderungen am Kerncode nahezu jede Funktion einem Website hinzufügen, sei es einfache Kontaktformulare oder komplexe E-Commerce-Systeme. Das Erlernen der Plugin-Entwicklung bedeutet, dass Sie WordPress individuell anpassen können, um spezifische Geschäftsanforderungen zu erfüllen oder Ihre eigenen Ideen in wiederverwendbare Produkte umzusetzen.

Die Entwicklung eigener Plugins ist besser, als direkt am Thema zu modifizieren. functions.php Dateien verfügen über deutliche Vorteile. Plugins sind funktional unabhängige Module, die unabhängig von der verwendeten WordPress-Thematik arbeiten – beim Wechsel der Thematik gehen ihre Funktionen nicht verloren. Dadurch wird der Code einfacher zu warten, zu aktualisieren und in verschiedenen Projekten zu nutzen. Das Verständnis der grundlegenden Mechanismen der Plugin-Entwicklung ist ein unverzichtbarer Schritt auf dem Weg, ein erfahrener WordPress-Entwickler zu werden.

Aufbauen Sie Ihre Entwicklungsumgebung.

Bevor Sie die erste Zeile Code schreiben, ist eine stabile und effiziente lokale Entwicklungsumgebung unerlässlich. Sie ermöglicht es Ihnen, Tests durchzuführen und Fehler zu beheben, ohne die Online-Website zu beeinträchtigen.

Empfohlene Lektüre Praktischer Leitfaden zur Entwicklung von WordPress-Plugins: Erstellen Sie Ihr erstes funktionales Plugin von Grund auf.。

Konfiguration der lokalen Serverumgebung

Es wird empfohlen, integrierte lokale Serverlösungen wie Local by Flywheel, XAMPP oder MAMP zu verwenden. Mit diesen können Apache/Nginx, PHP und MySQL mit nur einem Klick installiert werden. Stellen Sie sicher, dass Ihre PHP-Version mit der gewünschten WordPress-Version kompatibel ist – in der Regel wird PHP 7.4 oder eine höhere Version empfohlen. Außerdem sollten Sie eine neue Version von WordPress auf Ihrem lokalen Server installieren, um diese als “Sandkasten” für die Testung von Plugins zu verwenden.

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

Code-Editor und Debugging-Tools

Wählen Sie einen leistungsstarken Code-Editor wie Visual Studio Code oder PHPStorm aus. Diese Editor bieten Funktionen wie Syntaxhervorhebung, Code-Vorschläge sowie Integrationen für die Versionsverwaltung. Für das Debuggen muss der Debugging-Modus von WordPress aktiviert werden. Dies erfordert die Änderung der Einstellungen im WordPress-Root-Verzeichnis. wp-config.php Datei, wird… WP_DEBUG Die Konstante ist auf true。

define( 'WP_DEBUG', true );
define( 'WP_DEBUG_LOG', true ); // 将错误日志保存到 /wp-content/debug.log
define( 'WP_DEBUG_DISPLAY', false ); // 不要在页面上显示错误

Nachdem der Debugging-Modus aktiviert wurde, werden alle PHP-Fehler, Warnungen und Benachrichtigungen aufgezeichnet, was Ihnen dabei hilft, Probleme schnell zu lokalisieren.

Erstellen Sie Ihre erste Plugin-Datei.

Ein WordPress-Plugin kann so einfach sein, dass es nur aus einer einzigen Datei besteht – doch es ist von entscheidender Bedeutung, eine gute Struktur einzuhalten. Wir beginnen mit dem grundlegendsten “Hello World”-Plugin.

Die Struktur der Hauptdatei eines Plugins

Zunächst einmal, in WordPress… /wp-content/plugins/ Erstellen Sie unter dem Verzeichnis einen neuen Ordner, zum Beispiel my-first-pluginIn diesem Ordner erstellen Sie eine Haupt-PHP-Datei, deren Name in der Regel dem Namen des Ordners entspricht:my-first-plugin.php。

Empfohlene Lektüre WooCommerce-Plugin-Entwicklungshandbuch: Erstellen Sie Ihren eigenen Online-Shop。

Jeder Plugin muss am Anfang seiner Datei einen standardisierten Kommentarblock mit Informationen zum Plugin enthalten. WordPress nutzt diesen Block, um das Plugin zu erkennen und es in der Backend-Verwaltungsoberfläche anzuzeigen.

<?php
/**
 * Plugin Name:       我的第一个插件
 * Plugin URI:        https://www.yourwebsite.com/my-first-plugin/
 * Description:       这是一个学习 WordPress 插件开发的示例插件。
 * Version:           1.0.0
 * Author:            你的名字
 * Author URI:        https://www.yourwebsite.com/
 * License:           GPL v2 or later
 * Text Domain:       my-first-plugin
 * Domain Path:       /languages
 */

Nachdem du die Datei gespeichert hast, logge dich in dein WordPress-Backend ein und gehe auf die Seite “Plugins”. Dort solltest du das neue Plugin in der Liste der Plugins sehen. Jetzt kannst du es aktivieren – auch wenn es noch keine Funktionen besitzt.

Hinzufügen der ersten Funktion: Menüverwaltung

Als Nächstes fügen wir der Erweiterung eine einfache Funktion hinzu: Ein neues Menüelement wird in die Seitenleiste der WordPress-Backend-Verwaltung hinzugefügt.

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

Wir werden es verwenden. add_action() Eine Funktion, die eine Callback-Funktion mountet… admin_menu Dieser „Action-Haken“ ist aktiviert.

// 在插件主文件中，插件头部注释块之后，添加以下代码

if ( ! defined( 'ABSPATH' ) ) {
    exit; // 禁止直接访问
}

// 钩子到 admin_menu 动作
add_action( 'admin_menu', 'mfp_add_admin_menu' );

/**
 * 注册一个自定义管理菜单
 */
function mfp_add_admin_menu() {
    add_menu_page(
        '我的第一个插件设置', // 页面标题
        '我的插件',          // 菜单标题
        'manage_options',    // 所需权限
        'my-first-plugin',   // 菜单别名 (slug)
        'mfp_display_admin_page', // 显示页面内容的回调函数
        'dashicons-smiley', // 菜单图标 (使用 Dashicon)
        6                    // 菜单位置
    );
}

/**
 * 管理页面的显示内容
 */
function mfp_display_admin_page() {
    ?>
    <div class="wrap">
        <h1>\n</h1>
        <p>Hallo Welt! Das ist meine erste Seite zur Verwaltung von WordPress-Plugins.</p>
    </div>
    &lt;?php
}

Speichern Sie die Datei und aktualisieren Sie anschließend das WordPress-Backend. In der linken Menüleiste werden Sie einen neuen Menüeintrag mit dem Namen “Meine Plugins” sehen. Wenn Sie darauf klicken, gelangen Sie zu einer einfachen Seite, die eine Begrüßung anzeigt.

Hinter die Kulissen: Hooks und Filter

Die Kernphilosophie der WordPress-Plugin-Entwicklung sind die sogenannten “Hooks”. Hooks ermöglichen es, dass dein Code zu bestimmten Zeitpunkten in den Kernprozess von WordPress eingefügt werden kann, um Funktionen zu ändern oder hinzuzufügen. Es gibt hauptsächlich zwei Arten von Hooks: Actions und Filters.

Empfohlene Lektüre Leitfaden für die Entwicklung und Anpassung von WordPress-Themen: Von der Grundlage bis zur Meisterschaft – Erstellen Sie Ihre eigene Website。

Verstehen von Aktionshookern (Action Hooks)

Action Hooks werden in WordPress zu bestimmten Zeitpunkten ausgelöst – beispielsweise beim Speichern eines Artikels, beim Laden des Seitenkopfes oder beim Ausgeben des Seitenfußes. Ihr Plugin kann diese Zeitpunkte “abhören” und dabei eigene Funktionen ausführen. Das haben wir oben bereits verwendet. admin_menu Es handelt sich dabei um einen Action-Hook.

Ein weiteres häufiges Beispiel ist die automatische Hinzufügung eines Absatzes am Ende des Artikelinhalts.

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

add_action( 'the_content', 'mfp_append_text_to_content' );

function mfp_append_text_to_content( $content ) {
    if ( is_single() && in_the_loop() && is_main_query() ) {
        $append_text = '<p><em>Dieser Artikel wurde von meinem ersten Plugin erstellt.</em></p>';
        $content .= $append_text;
    }
    return $content;
}

Verwenden Sie Filter, um Daten zu ändern.

Filter-Hooks dienen dazu, Daten vor dem Speichern in einer Datenbank oder der Übertragung an einen Browser zu ändern. Sie erhalten die Daten, bearbeiten diese und müssen die bearbeiteten Daten anschließend zurückgeben. Ein typisches Beispiel hierfür ist die Änderung des Titels eines Artikels.

add_filter( 'the_title', 'mfp_modify_post_title' );

function mfp_modify_post_title( $title ) {
    // 只在非后台的主查询中修改
    if ( ! is_admin() && in_the_loop() ) {
        $title = '[重要] ' . $title;
    }
    return $title;
}

Das Verständnis und die geschickte Anwendung von „Hooks“ ist der Schlüssel zur Erstellung flexibler und leistungsfähiger Plugins. Das WordPress-Kernsystem bietet Tausende von Hooks, die sich über den gesamten Lebenszyklus eines Plugins erstrecken.

Plugin-Sicherheit und bewährte Praktiken

Sich an sichere Programmiermethoden zu halten und die besten Praktiken zu befolgen, garantiert, dass dein Plugin stabil, effizient ist und von anderen Entwicklern leicht akzeptiert wird.

Datensüberprüfung und -entschlüsselung

Vertrauen Sie niemals auf die von Benutzern eingegebenen Daten oder auf Daten aus der Datenbank. Bevor Sie jegliche Daten an den Browser ausgeben (in Form von HTML, JavaScript oder Attributen), müssen diese unbedingt entschlüsselt („geëncodet“) werden. WordPress bietet eine Reihe von Hilfsfunktionen dafür.

// 输出到 HTML 内容中
echo esc_html( $untrusted_data );
// 输出到 HTML 属性中
echo esc_attr( $untrusted_data );
// 输出到 URL 中
echo esc_url( $untrusted_data );
// 在 JavaScript 变量中输出
$js_data = wp_json_encode( $untrusted_data );

Bevor Daten in eine Datenbank gespeichert oder logische Entscheidungen getroffen werden, ist eine Validierung erforderlich, um sicherzustellen, dass die Daten dem erwarteten Format entsprechen (z. B. ob es sich um eine E-Mail-Adresse oder eine Zahl handelt).

Verwendung von Namensräumen und Klassen

Für komplexe Plugins wird empfohlen, PHP-Namenräume sowie objektorientierte Programmierung (OOP) zur Organisation des Codes zu verwenden. Dies verhindert effektiv Konflikte bei Funktionsnamen und verbessert die Modularität sowie Lesbarkeit des Codes.

<?php
namespace MyFirstPluginAdmin;

class Admin_Menu {
    public function __construct() {
        add_action( 'admin_menu', [ $this, 'add_menu_page' ] );
    }

public function add_menu_page() {
        add_menu_page( ... );
    }
}

// 初始化
new Admin_Menu();

Darüber hinaus soll die Integration internationaler Funktionen für das Plugin erfolgen (d.h. die Unterstützung verschiedener Sprachen). __() und _e() Funktionen, angemessene Optionen zur Deinstallation und Reinigung sowie die Einhaltung der WordPress-Codestandards sind alle wichtige Bestandteile eines ausgezeichneten Plugins.

Zusammenfassungen

Die Entwicklung von WordPress-Plugins ist eine Reise, die von Grundlagen bis zu fortgeschrittenen Konzepten führt. Es beginnt mit der Erstellung einer grundlegenden Datei, die von WordPress erkannt werden kann, und geht weiter mit dem Einsatz mächtiger Systeme wie Aktionen (Actions) und Filter-Hooks, um Funktionen zu erweitern. Jeder Schritt basiert auf einem Verständnis der WordPress-Architektur. Die lokale Entwicklungsumgebung dient als Ihr „Labor“, die Debugging-Tools als Ihr „Mikroskop“, und Sicherheit sowie bewährte Entwicklungspraktiken bilden die Grundlagen dafür, dass Ihr Plugin stabil und zuverlässig funktioniert.

Durch die Entwicklung eines einfachen Menü-Plugins hast du bereits den Kernprozess der Plugin-Entwicklung erprobt. Als Nächstes kannst du versuchen, Einstellungsmöglichkeiten zu integrieren, benutzerdefinierte Datenbanktabellen zu erstellen, Funktionen für Shortcodes hinzuzufügen oder ein kleines Hilfstool zu entwickeln. Indem du weiter übst und dich an der Implementierung von Kerncode sowie anderen hochwertigen Plugins orientierst, wirst du in der Lage sein, immer komplexere Anforderungen zu bewältigen und letztendlich professionelle WordPress-Plugins zu erstellen.

FAQ Häufig gestellte Fragen

Wie viele Dateien benötigt mindestens ein WordPress-Plugin?

Ein WordPress-Plugin benötigt in der Regel mindestens eine PHP-Datei. Solange diese Datei die richtigen Kommentare zur Beschreibung des Plugins enthält, kann WordPress es in der Liste der verfügbaren Plugins im Hintergrund erkennen und aktivieren. Für Plugins mit umfangreichen Funktionen wird der Code jedoch häufig in mehreren Dateien und Verzeichnissen organisiert, um die Wartbarkeit zu verbessern.

Wie kann man Konflikte bei Funktionsnamen bei der Entwicklung von Plugins vermeiden?

Es gibt zwei Hauptmethoden, um Konflikte bei Funktionsnamen zu vermeiden. Die erste besteht darin, allen Ihren Funktionen einen eindeutigen Präfix hinzuzufügen – beispielsweise indem Sie Abkürzungen oder Bezeichnungen aus Plugins verwenden. mfp_ oder myplugin_Zweitens: Verwenden Sie Klassen und Namensräume in PHP, um Ihre Funktionen in Klassenmethoden zu verpacken. Dies ist eine modernere und empfohlene Vorgehensweise, die das Problem von Namenskonflikten von Grund auf löst.

Wie füge ich einer meiner Plugins eine Seite mit Einstellungsoptionen hinzu?

Das Hinzufügen einer Einstellungsseite für ein Plugin beinhaltet in der Regel die Verwendung von add_options_page() oder add_submenu_page() Es gibt Funktionen, um Seiten zu registrieren, und anschließend wird die WordPress-Settings-API verwendet, um Optionen sicher zu erstellen, zu überprüfen und zu speichern. Die Settings-API umfasst… register_setting()、add_settings_section() und add_settings_field() Funktionen wie diese vereinfachen den Prozess der Erstellung standardisierter Einstellungsformulare und kümmern sich automatisch um Sicherheitsaspekte sowie die Speicherung von Daten.

Nach der Fertigstellung der Entwicklung: Wie kann man das Plugin in den offiziellen WordPress-Verzeichnissen veröffentlichen?

Um ein Plugin im offiziellen WordPress.org-Katalog zu veröffentlichen, müssen Sie zunächst einen SVN-Repository für Ihr Plugin bei WordPress.org beantragen. Anschließend müssen Sie sicherstellen, dass Ihr Plugincode den offiziellen Anforderungen und Richtlinien entspricht – dies beinhaltet Aspekte wie Codequalität, Sicherheit, die Lizenz (die mit der GPL kompatibel sein muss) sowie das Vorhandensein einer standardmäßigen readme.txt-Datei. Danach übertragen Sie Ihren Code mithilfe von SVN-Tools in den angegebenen Repository. Das WordPress-Team überprüft Ihr Plugin, und nach Genehmigung wird es im offiziellen Katalog veröffentlicht, wo es von Nutzern heruntergeladen und installiert werden kann.