WordPress-Plugin-Entwicklung meistern: Von Null an eigene Funktionen erstellen

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 dem Plugin-Mechanismus. Durch die Entwicklung eigener Plugins können Entwickler jeder gewünschten Funktion zur Kernplattform hinzufügen, ohne die WordPress-Kerndateien ändern zu müssen. Dies gewährleistet die Unabhängigkeit und Wartbarkeit des Codes – auch bei Updates der Themes oder Upgrades von WordPress-Versionen bleiben die Funktionen der Plugins stabil. Egal ob es darum geht, spezifische Geschäftsanforderungen zu erfüllen, die Website-Leistung zu optimieren oder Lösungen in der Community zu teilen: Die Fähigkeit, Plugins zu entwickeln, ist eine äußerst wertvolle Fertigkeit.

Ein standardmäßiges WordPress-Plugin besteht im Wesentlichen aus einem oder mehreren PHP-Dateien, die in einem bestimmten Verzeichnis im WordPress-Installationspfad abgelegt werden./wp-content/plugins/Die Dateien befinden sich im Verzeichnis und werden von WordPress durch spezielle Kommentare in der Datei-Header-Region erkannt. Während die Entwicklung von Themes auf das Erscheinungsbild und die Layout-Struktur ausgerichtet ist, konzentriert sich die Entwicklung von Plugins auf die Funktionalität und die Logik ihrer Abläufe, sodass sie mit jedem Theme zusammenarbeiten können. Diese Trennung der Schwerpunkte ist die Grundlage für das Erstellen robuster, wiederverwendbarer WordPress-Anwendungen.

Erstellen Sie die Struktur für Ihr erstes Plugin.

Der erste Schritt bei der Entwicklung eines Plugins ist die Erstellung der richtigen Dateistruktur. Dies dient nicht nur der Organisation des Codes, sondern auch der Erkennung und Aktivierung des Plugins durch WordPress.

Empfohlene Lektüre Die ultimative Anleitung zur Entwicklung von WordPress-Plugins: Benutzerdefinierte Funktionen von Grund auf erstellen。

Erstellen Sie die Haupt-Plugin-Datei.

Jeder Plugin muss eine Hauptdatei haben, die die standardisierten Plugin-Informationen enthält. Diese Datei wird in der Regel nach dem Namen des Plugins benannt, zum Beispiel:my-first-plugin.phpDie Kommentare im Dateiheader sind entscheidend dafür, dass WordPress Informationen wie den Namen, die Beschreibung und die Version eines Plugins lesen kann.

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

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

Legen Sie die Datei mit dem obigen Code in/wp-content/plugins/my-first-plugin/Nach dem Erstellen des Verzeichnisses können Sie das Plugin auf der “Plugins”-Seite im WordPress-Backend sehen und es entweder aktivieren oder deaktivieren.Text DomainZur Internationalisierung verwendet.Domain PathDer Verzeichnis, in dem die Sprachdateien abgelegt werden, wurde angegeben.

Organisieren Sie den Verzeichnisinhalt sowie die Dateien der Plugins.

Für einfache Plugins reicht oft bereits eine einzige Datei aus. Bei komplexeren Plugins ist jedoch eine gute Verzeichnisstruktur von entscheidender Bedeutung. Ein typisches Plugin-Verzeichnis könnte wie folgt aussehen:

my-advanced-plugin/
├── my-advanced-plugin.php      // 主插件文件
├── includes/                   // 核心PHP类与函数
│   ├── class-core.php
│   └── functions.php
├── admin/                      // 后台相关文件
│   ├── css/
│   ├── js/
│   └── class-admin.php
├── public/                     // 前端相关文件
├── assets/                     // 静态资源（图片、图标等）
└── languages/                  // 国际化语言文件

Diese Struktur ordnet die Backend-Logik, die Frontend-Logik sowie die Ressourcendateien nach Kategorien, wodurch der Code leichter zu verwalten und die Teamzusammenarbeit effizienter ist. Im Haupt-Plugin-File musst du in der Regel…require_onceoderinclude_onceUm die Funktionen aus diesen Unterverzeichnissen einzubinden.

Verstehen und Anwenden der Kern-APIs: Aktionen und Filter

Der Kern der WordPress-Plugin-Entwicklung liegt in ihrer ereignisgetriebenen Architektur, die hauptsächlich…Hook(System-Implementierung: „Hooks“) Es gibt zwei Arten von Hooks: Aktionshooks (Action Hooks).Action„Filter Hooks“FilterSie sind die Brücken, über die Plugins mit dem Kern von WordPress, den Themes sowie anderen Plugins interagieren können.

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

Mit Action-Hooks Code ausführen

Action Hooks ermöglichen es Ihnen, Ihren eigenen Code zu bestimmten Zeitpunkten während der Ausführung von WordPress einzufügen. Zum Beispiel, wenn ein Artikel veröffentlicht wird, wenn ein Benutzer sich anmeldet oder wenn das Menü im Administrationsbereich initialisiert wird. Sie können diese Hooks dazu nutzen, um automatische Aktionen auszuführen oder zusätzliche Funktionen zu implementieren.add_action()Die Funktion montiert Ihre benutzerdefinierte Funktion an ein bestimmtes Aktionshook.

Zum Beispiel: Wenn Sie einige benutzerdefinierte Inhalte an der Kopfzeile Ihrer Website anzeigen möchten, können Sie diese dort einbinden.wp_headDiese Aktion:

function myplugin_add_custom_head_content() {
    echo '<meta name="my-custom-tag" content="value">';
}
add_action( 'wp_head', 'myplugin_add_custom_head_content' );

Ein weiteres häufiges Beispiel ist die Ausführung von Initialisierungsoperationen beim Aktivieren eines Plugins, wie zum Beispiel die Erstellung von Datenbanktabellen. Dafür ist es notwendig, das Plugin entsprechend zu konfigurieren bzw. zu integrieren.register_activation_hookDiese besondere Schlaufe.

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

function myplugin_activate() {
    // 执行创建数据表等初始化代码
}
register_activation_hook( __FILE__, 'myplugin_activate' );

Daten mithilfe von Filter-Hooks ändern

Filter-Hooks dienen dazu, die während des Prozesses übergebenen Daten zu ändern. Im Gegensatz zu Action-Hooks müssen Filter-Funktionen einen Eingabewert erhalten und einen geänderten Wert zurückgeben.add_filter()Eine Funktion, die Filter hinzufügt.

Zum Beispiel: Ändern des angezeigten Inhalts des Artikeltitels.

function myplugin_modify_post_title( $title ) {
    return '【推荐】' . $title;
}
add_filter( 'the_title', 'myplugin_modify_post_title' );

Filter können auch verwendet werden, um Abfrageparameter, Menüelemente – sowie sogar die eigenen Einstellungen von Plugins – zu ändern. Das Verständnis und die geschickte Anwendung von Aktionen und Filtern ist der Schlüssel dazu, flexible und kompatiblere Plugins zu entwickeln.

Empfohlene Lektüre Von Null auf Eins: Ein vollständiger Leitfaden für die Entwicklung von WordPress-Plugins und bewährte Praktiken。

Eine Backend-Verwaltungsoberfläche für Plugins erstellen

Die meisten Plugins benötigen eine Konfigurationsseite, über die Webadministratoren Optionen einstellen können. WordPress bietet eine umfassende API, die Entwicklern dabei hilft, standardisierte Backend-Oberflächen schnell zu erstellen.

Hinzufügen eines Verwaltungs-Menüs und Unter-Menüs

ausnutzenadd_menu_page()Die Funktion kann einem Ihrer Plugins ein oberes Menü in der Seitenleiste im Hintergrund hinzufügen. Sie müssen Parameter wie die Seitebezeichnung, die Menübezeichnung, die Berechtigungen, den Menü-Alias sowie die Rückruffunktion bereitstellen.

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

function myplugin_add_admin_menu() {
    add_menu_page(
        '我的插件设置',           // 页面标题
        '我的插件',              // 菜单标题
        'manage_options',       // 所需权限（管理员）
        'myplugin-settings',    // 菜单别名（slug）
        'myplugin_settings_page', // 用于输出页面内容的回调函数
        'dashicons-admin-generic', // 图标（使用Dashicons）
        80                      // 菜单位置
    );
}
add_action( 'admin_menu', 'myplugin_add_admin_menu' );

Die entsprechende Callback-Funktionmyplugin_settings_page()Verantwortlich für die Darstellung der HTML-Inhalte auf der Einstellungsseite. Bei komplexeren Plugins kann es auch erforderlich sein, weitere Werkzeuge oder Methoden zu verwenden.add_submenu_page()Um ein Untermenü hinzuzufügen…

Die Konfiguration wird mithilfe der Setup-API gespeichert.

Die manuelle Verarbeitung von Formulareingaben sowie der Speicherung von Optionen ist sowohl aufwendig als auch unsicher. Die WordPress-Settings-API bietet eine sichere und standardisierte Methode zum Registrieren von Einstellungen, Feldern und Abschnitten.

Zunächst verwenden Sieregister_setting()Registrieren Sie eine Gruppe von Einstellungen und definieren Sie die zugehörigen Validierungs-Rückrufe (Validation Callbacks).

function myplugin_register_settings() {
    register_setting(
        'myplugin_settings_group', // 设置组名，需与 settings_fields() 调用一致
        'myplugin_option_name',    // 存储在 wp_options 表中的选项名
        array( 'sanitize_callback' => 'myplugin_sanitize_input' ) // 清理回调
    );

// 添加一个设置区块
    add_settings_section(
        'myplugin_main_section',   // 区块ID
        '主要设置',                // 区块标题
        'myplugin_section_callback', // 区块介绍文本的回调函数
        'myplugin-settings'        // 所属页面的别名
    );

// 在区块中添加一个字段
    add_settings_field(
        'myplugin_text_field',     // 字段ID
        '示例文本输入',            // 字段标签
        'myplugin_text_field_callback', // 渲染字段HTML的回调
        'myplugin-settings',       // 页面别名
        'myplugin_main_section'    // 所属区块ID
    );
}
add_action( 'admin_init', 'myplugin_register_settings' );

Danach verwenden Sie die Funktion in der Callback-Funktion auf der Einstellungsseite.settings_fields()、do_settings_sections()undsubmit_button()Funktionen wie „print“ werden verwendet, um die Inhalte des Formulars auszugeben.

Stellen Sie sicher, dass die Plugins sicher und wartungsfreundlich sind.

Die Entwicklung eines Plugins bedeutet nicht nur die Implementierung von Funktionen, sondern vor allem, sicherzustellen, dass es sicher, effizient und leicht für die Langzeitwartung ist.

Datenvalidierung, -bereinigung und -vermeidung

Dies ist die erste Verteidigungslinie bei der Sicherheit von Plugins. Alle Daten, die von Benutzern oder externen Quellen stammen (z. B.$_POST、$_GET、$_COOKIEAlle Daten müssen vor dem Eintritt in die Datenbank oder der Ausgabe auf der Seite verarbeitet werden.

• Validierung (Validation): Überprüfung, ob die Daten dem erwarteten Format, Typ oder Bereich entsprechen. Verwendung von Funktionen wiefilter_var()、is_email()Oder verwenden Sie eine benutzerdefinierte reguläre Ausdruckssprache.
• Sanitisierung: Entfernen Sie illegale oder gefährliche Zeichen aus den Daten, um sie sicherer zu machen. Für verschiedene Datentypen bietet WordPress eine Vielzahl von Sanitisierungsfunktionen, wie z. B.sanitize_text_field()(Die Angabe „(Für den Text)“ wird in der Übersetzung beibehalten, da sie klar darauf hinweist, dass die Informationen für die Textverarbeitung bestimmt sind.)sanitize_email()、sanitize_key()usw.
• Entkommen (Escaping): Beim Ausgeben von Daten in HTML, JavaScript, URLs oder Attributen muss eine Entkodierung erfolgen, um Cross-Site-Scripting-Angriffe zu verhindern. Dazu werden Funktionen wieesc_html()、esc_js()、esc_url()、esc_attr()。

Eine goldene Regel lautet: Reinigen Sie so früh wie möglich und entschärfen Sie alle Inhalte stets.

Internationalisierung und Lokalisierung umsetzen

Damit Ihre Erweiterung von Nutzern auf der ganzen Welt genutzt werden kann, ist die Unterstützung mehrerer Sprachen unerlässlich. Dies wird mithilfe des Internationalisierungsframeworks von WordPress realisiert.

Zunächst sollten alle zu übersetzenden Zeichenketten mit Anführungszeichen umgeben werden.__()(Verwendet für Rückgabewerte) oder_e()(Die Funktion wird direkt ausgegeben und es wird angegeben, dass sie im Kopfbereich des Plugins definiert wurde.)Text Domain。

$greeting = __( ‘Hello, world!’, ‘my-first-plugin’ );
_e( ‘Settings saved successfully!’, ‘my-first-plugin’ );

Anschließend wird mit einem Tool wie Poedit der Plugin-Code gescannt, um eine entsprechende Ausgabe zu erzeugen..pot(Template-)Datei. Die Übersetzer können darauf basierend die entsprechenden Dateien für die jeweilige Sprache erstellen..poUnd das kompilierte….moDatei, legen Sie sie in das Verzeichnis der Plugins./languages/Im Ordner. Zum Schluss verwenden Sie…load_plugin_textdomain()Die Funktion lädt die Sprachpakete beim Initialisieren des Plugins.

Zusammenfassungen

Die Entwicklung von WordPress-Plugins ist ein Prozess, bei dem Kreativität in funktionale Lösungen umgewandelt wird – und dies basiert auf einem tiefen Verständnis der Kernarchitektur von WordPress. Angefangen bei der Erstellung einer Hauptdatei mit standardmäßigen Dateihäuptern, über die Nutzung des leistungsstarken Systems aus Aktionen und Filtern zur tieferen Integration mit der Plattform, bis hin zum Bau einer sicheren Backend-Verwaltungsoberfläche mithilfe der Settings-API – jedes Schritt folgt den besten Praktiken von WordPress. Gleichzeitig sind Sicherheit (Validierung, Reinigung, Entschlüsselung von Daten) sowie Internationalisierung grundlegende Anforderungen bei der Entwicklung, um professionelle, zuverlässige und universell einsetzbare Plugins zu erstellen. Durch die Befolgung dieser Prinzipien und Schritte können Entwickler mit Sicherheit hochwertige WordPress-Plugins entwickeln, die den verschiedensten Anforderungen entsprechen.

FAQ Häufig gestellte Fragen

Welche Grundkenntnisse sind erforderlich, um WordPress-Plugins zu entwickeln?

Um WordPress-Plugins zu entwickeln, sind grundlegende Kenntnisse der PHP-Programmiersprache erforderlich, da Plugins hauptsächlich in PHP geschrieben werden. Außerdem ist ein grundlegendes Verständnis von HTML, CSS und JavaScript erforderlich, um die Frontend-Anzeige und -Interaktionen zu gestalten. Am wichtigsten ist es, die grundlegende Architektur von WordPress zu verstehen – insbesondere die Funktionsweise von Themes, Plugins, Hooks und Schleifen. Ebenfalls hilfreich ist eine Vertrautheit mit den grundlegenden Operationen der MySQL-Datenbank beim Umgang mit Plugin-Daten.

Wie man ein in Entwicklung befindliches WordPress-Plugin debuggt?

AktivierenWP_DEBUGDies ist der erste Schritt bei der Entwicklung eines Debugging-Plugins.wp-config.phpIn der Datei wird Folgendes festgelegt:define( ‘WP_DEBUG’, true );Einstellen auftrueDies wird PHP-Fehler, Warnungen und Benachrichtigungen auf der Seite anzeigen. Gleichzeitig kann dies auch genutzt werden…error_log()Die Funktion schreibt benutzerdefinierte Debugging-Informationen in das Fehlerprotokoll des Servers. Für anspruchsvollere Debugging-Vorgänge kann es sinnvoll sein, spezielle Debugging-Plugins zu verwenden oder die Debugging-Funktionen eines integrierten Entwicklungsumgebungs-Tools (IDE) zu nutzen.

Wie vermeidet man Konflikte mit anderen Plugins bei der Entwicklung eines eigenen Plugins?

Um Konflikte zu vermeiden, sollte der Code Ihrer Plugins gut abgeschirmt („gepackt“) sein. Fügen Sie allen Funktionen, Klassen, Variablen und Optionen ein eindeutiges Präfix hinzu – beispielsweise durch die Verwendung von Abkürzungen oder Bezeichnungen des Plugins. Nutzen Sie objektorientierte Programmierung (OOP), um den Code in Klassen zu strukturieren; dies hilft dabei, den globalen Namensraum sauber zu halten. Verwenden Sie globale Variablen nur mit Bedacht und stellen Sie sicher, dass Ihre Hook-Funktionen eine klare Priorität haben. Vor der Veröffentlichung sollten Ihre Plugins in Umgebungen mit einer Vielzahl von beliebten Plugins gründlich getestet werden.

Wie kann man eine entwickelte Erweiterung (Plugin) in das offizielle Plugin-Verzeichnis einreichen?

Zunächst musst du sicherstellen, dass dein Plugin vollständig den offiziellen Entwicklungsstandards und -richtlinien von WordPress entspricht. Anschließend erstellst du ein Konto auf WordPress.org und übermittelst dort deine komprimierte Plugin-Datei über die “Entwickler”-Seite. Nach der Übermittlung wird dein Plugin von einem Prüfteam überprüft, wobei auf die Codequalität, die Sicherheit sowie die Lizenzvereinbarungen (die mit der GPL kompatibel sein müssen) geachtet wird. Wenn dein Plugin die Prüfung besteht, wird es in den offiziellen WordPress-Plugin-Katalog aufgenommen, und du erhältst einen SVN-Repository, um deinen Code zu verwalten und Updates zu veröffentlichen.