Die ultimative Anleitung zur Entwicklung von WordPress-Plugins: Vom Anfänger zum Experten beim Erstellen leistungsstarker benutzerdefinierter Plugins.

WordPress-Plugin-Entwicklungsumgebung und Vorbereitungen

Bevor du mit dem Schreiben von Code beginnst, ist es der erste Schritt zum Erfolg, eine professionelle und effiziente Entwicklungsumgebung einzurichten. Dies verbessert nicht nur deine Entwicklungseffizienz, sondern sorgt auch für die Qualität und Wartbarkeit des Codes.

Aufbau einer lokalen Entwicklungsumgebung

Es wird empfohlen, eine lokale Serverumgebung zu verwenden, wie z. B. Local by Flywheel, XAMPP oder Laragon. Mit diesen Tools kann man auf dem lokalen Computer schnell eine WordPress-Umgebung mit Apache/Nginx, MySQL und PHP einrichten. Der Vorteil dabei ist, dass Sie in einer unabhängigen und sicheren Umgebung frei testen und debuggen können, ohne befürchten zu müssen, dass dies die Online-Website beeinträchtigt.

Unverzichtbare Werkzeuge für die Entwicklung von Plugins

Neben der Serverumgebung benötigen Sie auch eine Reihe von Tools. Ein leistungsstarker Codeeditor oder eine integrierte Entwicklungsumgebung (IDE) ist unerlässlich – beispielsweise Visual Studio Code oder PhpStorm – diese bieten Funktionen wie Syntaxhervorhebung, Code-Vorschläge und Debugging-Möglichkeiten. Darüber hinaus ist es entscheidend, ein Versionskontrollsystem wie Git zu kennen und zu nutzen, um Codeänderungen zu verwalten und im Team zusammenzuarbeiten. Schließlich sollten Sie sicherstellen, dass Ihre lokale PHP-Version mit der Zielproduktionsumgebung übereinstimmt, um Kompatibilitätsprobleme aufgrund von Versionsschwankungen zu vermeiden.

Empfohlene Lektüre Komplettanleitung zum Entwickeln von WordPress-Plugins: Erstellen Sie Ihr erstes funktionales Plugin von Grund auf。

Das Verständnis der grundlegenden Struktur eines Plugins.

Ein standardisiertes WordPress-Plugin verfügt über eine klare Struktur der Dateien und des Codes. Die Befolgung dieser Struktur sorgt nicht nur dafür, dass dein Plugin von der WordPress-Core-Software korrekt erkannt und geladen wird, sondern ist auch eine grundlegende Voraussetzung für die Veröffentlichung im offiziellen Plugin-Verzeichnis.

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

Zusammensetzung der Hauptdatei des Plugins

Jeder Plugin muss eine Hauptdatei haben. Diese Datei wird in der Regel nach dem Namen des Plugins benannt, zum Beispiel… my-awesome-plugin.phpDer Kopf dieser Datei muss einen bestimmten Block mit Anmerkungen zu den Plugin-Informationen enthalten, der WordPress darüber informiert, welches Plugin Sie entwickelt haben.

/**
 * Plugin Name:       我的强大插件
 * Plugin URI:        https://example.com/my-awesome-plugin
 * Description:       这是一个用于演示插件开发指南的强大定制插件。
 * Version:           1.0.0
 * Author:            你的名字
 * License:           GPL v2 or later
 * Text Domain:       my-awesome-plugin
 */

Nach diesem Informationsblock können Sie mit dem Schreiben des Hauptcodes des Plugins beginnen. Alle Kernfunktionen können direkt in dieser Datei implementiert werden. Für komplexe Plugins ist es jedoch empfehlenswerter, den Code modular aufzuteilen.

Codeorganisation und Modularisierung

Um die Wartbarkeit des Codes zu gewährleisten, sollten die Prinzipien der Modularisierung befolgt werden. Neben der Hauptdatei kann Ihr Plugin-Verzeichnis auch die folgenden Elemente enthalten:
* includes/ Verzeichnis: Dient zum Speichern von Dateien mit Kernfunktionen oder -methoden.
* admin/ Inhaltsverzeichnis: Dieser Ordner dient ausschließlich zum Speichern von Code, der mit der Backend-Verwaltungsoberfläche zusammenhängt.
* public/ Verzeichnis: Hier werden die Codes gespeichert, die die Frontend-Logik der Website verarbeiten.
* assets/ Verzeichnis: Dient zum Speichern von statischen Ressourcen wie JavaScript-Dateien, CSS-Dateien und Bildern.
* languages/ Verzeichnis: Hier werden die internationalisierten Übersetzungsdateien (.po/.mo) abgelegt.
Diese Struktur sorgt dafür, dass der Code übersichtlich ist und sich leicht über einen längeren Zeitraum hinweg warten sowie Funktionen erweitern lassen.

Core Development: Hooks und APIs

Die Kernphilosophie der WordPress-Plugin-Entwicklung basiert auf sogenannten “Hooks”. Diese ermöglichen es Ihrem Code, zu bestimmten Zeitpunkten in den Kernprozess von WordPress eingreifen zu können – um Funktionen zu ändern oder hinzuzufügen. Dies ist der Grundstein für die Flexibilität und Erweiterbarkeit von WordPress.

Empfohlene Lektüre Komplettanleitung zum Entwickeln von WordPress-Plugins: Von Null an hochwertige Erweiterungen für WordPress erstellen。

Die Anwendung von Action-Hooks

Action Hooks ermöglichen es Ihnen, Ihren eigenen Code zu bestimmten Zeitpunkten während der Ausführung von WordPress auszuführen. Zum Beispiel, wenn ein Artikel veröffentlicht wird oder wenn das Menü im Administrationsbereich initialisiert wird. Sie können diese Hooks dazu nutzen, um automatische Aktionen durchzuführen oder zusätzliche Funktionen zu implementieren. add_action() Eine Funktion, die es ermöglicht, eine benutzerdefinierte Funktion an ein bestimmtes Aktionshookup zu binden.

function myplugin_send_notification_on_publish( $post_id ) {
    // 获取文章信息
    $post = get_post( $post_id );
    // 模拟发送邮件通知
    wp_mail( '[email protected]', '新文章已发布！', '文章标题：' . $post->post_title );
}
// 将函数挂载到 `publish_post` 这个动作钩子
add_action( 'publish_post', 'myplugin_send_notification_on_publish' );

Die Anwendung von Filter-Hooks

Filter Hooks dienen dazu, Daten zu modifizieren. Bevor die Daten verwendet werden – beispielsweise in einer Datenbank gespeichert oder einem Benutzer angezeigt werden – können Sie deren Werte mithilfe von Filtern ändern. Dies erfolgt auf folgende Weise: add_filter() Die Funktion wird implementiert.

function myplugin_modify_excerpt_length( $length ) {
    // 将文章摘要的默认字数从55改为30
    return 30;
}
add_filter( 'excerpt_length', 'myplugin_modify_excerpt_length' );

Wichtige globale API-Funktionen

Neben den sogenannten „Hook-Funktionen“ bietet WordPress eine Vielzahl praktischer API-Funktionen, beispielsweise für die Arbeit mit der Datenbank. wpdb Klassen, Optionen zur Verarbeitung get_option() und update_option()„Create a custom data table“ dbDelta() Funktionen usw. Die geschickte Nutzung dieser APIs ist der Schlüssel zu einer effizienten Entwicklung.

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

Implementieren Sie eine vollständige Plugin-Funktion.

Lassen Sie uns die oben genannten Kenntnisse anhand eines praktischen Beispiels verbinden und ein einfaches Plugin für die Schätzung der Lesezeit von Artikeln entwickeln. Dieses Plugin wird die geschätzte Lesezeit vor dem Artikelinhalt anzeigen.

Erstellen Sie ein Plugin-Framework sowie eine Hauptdatei.

Zunächst einmal… /wp-content/plugins/ Erstellen Sie im Verzeichnis ein neues Verzeichnis und nennen Sie es „…“ (füllen Sie das Leerzeichen mit dem gewünschten Namen aus). post-reading-timeIn diesem Ordner erstellen Sie die Hauptdatei. post-reading-time.phpUnd füllen Sie die Standard-Plugin-Header-Informationen aus.

Die Kernfunktion zur Berechnung und Anzeige der Lesezeit

Als Nächstes fügen Sie die Kernfunktionen in die Hauptdatei des Plugins hinzu. Wir benötigen eine Funktion, um die Lesezeit zu berechnen, und diese muss anschließend in das Plugin integriert werden. the_content Auf dem Filter, damit unsere Informationen vor der Anzeige des Artikelinhalts eingefügt werden können.

Empfohlene Lektüre Eine vollständige Anleitung zur Entwicklung von WordPress-Plugins: vom Einstieg bis zum Erstellen professioneller Erweiterungen.。

function prt_calculate_reading_time( $content ) {
    // 1. 只有在单篇文章页面才生效
    if ( ! is_single() ) {
        return $content;
    }

// 2. 获取文章内容，去除短代码和HTML标签，计算字数
    $text_content = strip_shortcodes( wp_strip_all_tags( $content ) );
    $word_count   = str_word_count( $text_content );

// 3. 假设平均阅读速度为每分钟200字
    $reading_time = ceil( $word_count / 200 );

// 4. 生成显示HTML
    $reading_time_html = sprintf(
        '<div class="post-reading-time"><p><strong>Erwartete Lesezeit:</strong>Etwa 1 TP3T Minuten</p></div>',
        $reading_time
    );

// 5. 将阅读时间信息放在文章内容之前
    return $reading_time_html . $content;
}
add_filter( 'the_content', 'prt_calculate_reading_time' );

Einfache Styles für das Plugin hinzufügen

Um eine schönere Darstellung zu erzielen, können wir etwas CSS hinzufügen. Eine gute Praxis besteht darin, die Styles in einer bestimmten Reihenfolge zu laden (d.h., sie „zu enqueue“). wp_enqueue_style() Diese Funktion sorgt dafür, dass die Stylesheets korrekt geladen werden und keine Konflikte mit anderen Plugins auftreten.

function prt_enqueue_styles() {
    wp_enqueue_style(
        'prt-style',
        plugin_dir_url( __FILE__ ) . 'assets/css/prt-style.css', // 假设CSS文件路径
        array(), // 依赖
        '1.0.0' // 版本号
    );
}
add_action( 'wp_enqueue_scripts', 'prt_enqueue_styles' );

Und dann in assets/css/prt-style.css Einfache Styles in eine Datei hinzufügen:

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

.post-reading-time {
    background-color: #f0f8ff;
    border-left: 4px solid #3498db;
    padding: 10px 15px;
    margin-bottom: 20px;
    font-size: 0.95em;
}

Bis hierhin wurde ein vollständiges Plugin mit grundlegenden Funktionen erstellt. Sie können es aktivieren und überprüfen, ob oben auf der Seite eines einzelnen Artikels eine ansprechende Anzeige der Lesezeit erscheint.

Zusammenfassungen

Die Entwicklung von WordPress-Plugins ist ein Prozess, bei dem Kreativität in leistungsstarke Funktionen umgewandelt wird. Durch die Einrichtung einer professionellen Umgebung, das Verständnis der standardisierten Struktur von Plugins sowie das gründliche Beherrschen der Hook-Mechanismen und der Kern-APIs erwerbst du die grundlegenden Fähigkeiten, um verschiedene benutzerdefinierte Plugins zu erstellen. Dieser Artikel skizziert einen klaren Lernweg – von der Vorbereitung der Umgebung über die Struktur des Codes bis hin zu theoretischen Grundlagen und praktischen Beispielen. Der Schlüssel liegt in der praktischen Umsetzung: Beginne mit einer einfachen Funktion wie “Lesezeit” und steigere schrittweise die Komplexität deiner Plugins. Schließlich wirst du in der Lage sein, zuverlässig WordPress-Plugins zu entwickeln, die den spezifischen Anforderungen deiner Kunden entsprechen.

FAQ Häufig gestellte Fragen

Muss man PHP beherrschen, um Plugins zu entwickeln?

Ja, eine solide Grundlage in PHP ist eine Voraussetzung für die Entwicklung von WordPress-Plugins. Der Kern von WordPress sowie die meisten seiner Plugins und Themes werden schließlich in PHP programmiert. Um sicheren und effizienten Plugin-Code zu schreiben, musst du die grundlegenden PHP-Syntaxelemente wie Variablen, Funktionen, Klassen, Arrays, Schleifen und Bedingungsausdrücke verstehen sowie die grundlegenden Konzepte der objektorientierten Programmierung (OOP).

Wie kann ich sicherstellen, dass die von mir entwickelte Erweiterung sicher ist?

Um die Sicherheit von Plugins zu gewährleisten, sind umfassende Maßnahmen erforderlich. Zunächst einmal muss alle von den Nutzern eingegebene Daten streng überprüft, gereinigt und entsprechend entschärft werden. Hierfür können Funktionen verwendet werden, die von WordPress bereitgestellt werden. sanitize_text_field(), esc_html(), wp_kses_post() Zweitens ist es beim Ausführen von Datenbankoperationen unerlässlich, sicherzustellen, dass… $wpdb Methoden einer Klasse prepare() Verwenden Sie entsprechende Statements, um SQL-Injection-Angriffe zu verhindern. Folgen Sie außerdem dem Prinzip der minimalen Berechtigungen und gewähren Sie den Plugins nur die Berechtigungen, die für die Ausführung ihrer Funktionen erforderlich sind.

Kann das von mir entwickelte Plugin in das offizielle WordPress-Verzeichnis hochgeladen werden?

Ja, das ist möglich – allerdings müssen eine Reihe strenger Standards erfüllt werden. Der Code deines Plugins muss den WordPress-Programmierstandards entsprechen, eine kompatible Lizenz wie die GNU GPL v2 oder eine höhere Version verwenden, und darf keinen bösartigen Code, Paylinks oder Inhalte enthalten, die gegen die Richtlinien zur Strukturierung von WordPress-Plugins verstoßen. Vor der Einreichung empfiehlt es sich, die offizielle Plugin-Entwicklungsdokumentation sowie die Einreichungsanleitungen sorgfältig zu lesen und dein Plugin gründlich selbst zu überprüfen sowie zu testen.

Wie füge ich einer meiner Plugins eine Seite mit Verwaltungs-Einstellungen hinzu?

Das Hinzufügen einer Einstellungsseite für ein Plugin beinhaltet in der Regel die Nutzung der “Menüseiten-API” von WordPress. Du kannst dies dazu verwenden, um die entsprechenden Funktionen für die Einstellungenseiten des Plugins zu implementieren. add_menu_page() Eine Funktion, um ein oberstes Menüelement zu erstellen, oder die Verwendung einer solchen Funktion… add_submenu_page() Erstellen Sie unterhalb des bestehenden Menüs (z. B. “Einstellungen”) eine Unterseite. In der Callback-Funktion der Einstellungsseite müssen Sie eine HTML-Form ausgeben und diese nutzen. settings APIeinschließlich register_setting, add_settings_section, add_settings_field Funktionen wie diese werden verwendet, um die Registrierung, Speicherung und Darstellung von Optionen sicher und bequem zu verwalten.