WordPress ist als weltweit beliebtestes Content-Management-System vor allem aufgrund seiner hohen Erweiterbarkeit bekannt – diese Erweiterbarkeit wird in erster Linie durch Plugins ermöglicht. Mit der Entwicklung von Plugins können Sie Ihrer Website beliebige benutzerdefinierte Funktionen hinzufügen, ohne den Kerncode des Systems anpassen zu müssen. Diese Anleitung führt Sie Schritt für Schritt durch den gesamten Prozess der Erstellung Ihres ersten Funktions-Plugins und behandelt alle wichtigen Aspekte, von der Vorbereitung der Umgebung über die Programmierung bis hin zur Veröffentlichung und dem Testen des Plugins.
Vorbereitungsarbeiten und Umgebungseinstellungen
Bevor Sie die erste Zeile Code schreiben, benötigen Sie eine geeignete Entwicklungsumgebung. Dies verbessert nicht nur die Effizienz, sondern vermeidet auch die Risiken, die mit dem Debuggen auf einer echten Website verbunden sein können.
Ein lokales Entwicklungsumfeld einrichten
Es wird empfohlen, lokale Server-Softwarepakete wie XAMPP, MAMP oder Laragon zu verwenden. Diese ermöglichen die einfache Einrichtung von Apache, MySQL und PHP auf einen Knopfdruck und simulieren somit perfekt die Umgebung im Online-Betrieb. Stellen Sie sicher, dass Ihre PHP-Version mit der gewünschten WordPress-Version kompatibel ist – die offizielle WordPress-Website bietet in der Regel aktuelle Versionenanforderungen an.
Empfohlene Lektüre Komplettanleitung zum Entwickeln von WordPress-Plugins: Erstellen Sie Ihr erstes funktionales Plugin von Grund auf。
WordPress installieren und einen Code-Editor nutzen
Installieren Sie eine brandneue WordPress-Website auf Ihrem lokalen Server, um damit Plugins zu entwickeln und zu testen. Wählen Sie außerdem einen leistungsstarken Code-Editor wie Visual Studio Code oder PhpStorm aus. Diese Editor unterstützen die PHP-Syntax hervorragend – mit Funktionen wie Syntaxhervorhebung, Code-Vorschlägen und Debugging-Möglichkeiten – und verbessern so deutlich das Programmiererlebnis.
Erstellen Sie Ihre erste Plugin-Datei.
Ein sehr einfaches WordPress-Plugin kann aus nur einer einzigen Datei bestehen. Wir beginnen mit einem einfachen “Hello World”-Plugin, um die Struktur von Plugins zu verstehen.
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 die Haupt-Plugin-Datei, die in der Regel nach dem Namen des Plugins benannt wird, zum Beispiel: my-first-plugin.php。
Jeder Plugin muss in der Kopfzeile der Datei spezifische Kommentare mit Plugin-Informationen enthalten – dies ist entscheidend für die Erkennung des Plugins durch WordPress. Hier ist ein sehr einfaches Beispiel:
<?php
/**
* Plugin Name: 我的第一个插件
* Plugin URI: https://example.com/my-first-plugin
* Description: 这是一个用于学习的简单功能插件。
* Version: 1.0.0
* Author: 你的名字
* License: GPL v2 or later
* Text Domain: my-first-plugin
*/Nachdem Sie die Datei gespeichert haben, gehen Sie zur “Plugins”-Seite im WordPress-Backend. Dort können Sie das Plugin sehen und es aktivieren. Obwohl es derzeit keine Funktionen besitzt, haben Sie erfolgreich einen kompatiblen Plugin-rahmen erstellt.
Empfohlene Lektüre Ich zeige Ihnen Schritt für Schritt, wie Sie WordPress-Plugins von Grund auf beherrschen.。
Basische Funktionen für das Plugin hinzufügen
Nach der Aktivierung des Plugins fügen wir ihm eine einfache Funktion hinzu: Die Anzeige eines benutzerdefinierten Textes am Fuß der Website-Seite. Dafür werden wir WordPress verwenden. wp_footer Haken.
Unter den Anmerkungen zu den Plugin-Informationen fügen Sie den folgenden Code hinzu:
// 在网站页脚输出自定义文本
function myfp_add_footer_text() {
echo '<p style="text-align: center;">Vielen Dank, dass Sie mein erstes Plugin verwendet haben!</p>';
}
add_action( 'wp_footer', 'myfp_add_footer_text' );Speichern Sie die Datei und aktualisieren Sie die Website-Frontend-Seite. Dann werden Sie diesen zentrierten Text am unteren Rand der Seite sehen. Dieses Beispiel zeigt Ihnen, wie Sie dies umsetzen können. add_action() Die Funktion “montiert” Ihre eigene, benutzerdefinierte Funktion an einen zentralen Ausführungspunkt von WordPress.
Implementieren Sie eine praktische Verwaltungsfunktion.
Ein vollständiges Plugin sollte in der Regel eine Konfigurationsoberfläche im WordPress-Administrationsbereich bieten. Im Folgenden werden wir eine einfache Einstellungsseite für das Plugin hinzufügen, die es Administratoren ermöglicht, den Text, der im Fußbereich angezeigt wird, selbst zu definieren.
Erstellen einer Menüseite für die Verwaltung
Wir müssen unter dem Menü “Einstellungen” im Backend eine Untermenüseite hinzufügen. Dafür werden folgende Schritte erforderlich sein: add_options_page() Funktion.
Zuerst erstellen Sie eine Funktion, die den HTML-Inhalt der Einstellungsseite generiert und diesen anschließend an die entsprechende Stelle im Browser anbindet. admin_menu Auf dem Haken.
Empfohlene Lektüre Vom Nullpunkt aus: Warum sich für die Entwicklung von WordPress-Plugins entscheiden?。
// 添加插件设置页面到后台菜单
function myfp_add_admin_menu() {
add_options_page(
'我的插件设置', // 页面标题
'我的插件', // 菜单标题
'manage_options', // 权限（管理员）
'my-first-plugin', // 菜单slug
'myfp_settings_page' // 用于输出页面内容的回调函数
);
}
add_action( 'admin_menu', 'myfp_add_admin_menu' );
// 设置页面的HTML内容
function myfp_settings_page() {
?>
<div class="wrap">
<h1>Die Einstellungen meines ersten Plugins</h1>
<form method="post" action="/de/options.php/" data-trp-original-action="options.php">
<?php
settings_fields( 'myfp_settings_group' ); // 设置字段组
do_settings_sections( 'my-first-plugin' ); // 设置区域
submit_button(); // 提交按钮
?>
<input type="hidden" name="trp-form-language" value="de"/></form>
</div>
<?php
}Registrierungseinstellungen, Felder und Datenspeicherung
Einfach nur eine Webseite reicht nicht aus – wir müssen die WordPress-API nutzen, um Optionen sicher zu registrieren, zu verifizieren und zu speichern. Dafür sind drei Kernfunktionen erforderlich:register_setting(), add_settings_section() und add_settings_field()。
// 初始化插件设置
function myfp_settings_init() {
// 注册一个新的设置项到数据库的 `wp_options` 表
register_setting( 'myfp_settings_group', 'myfp_footer_text' );
// 在设置页面添加一个区域
add_settings_section(
'myfp_section',
'页脚文字设置',
null, // 区域描述回调函数，这里不需要
'my-first-plugin'
);
// 在刚添加的区域里创建一个字段
add_settings_field(
'myfp_field_footer',
'显示的文本',
'myfp_field_footer_cb', // 用于输出字段HTML的回调函数
'my-first-plugin',
'myfp_section'
);
}
add_action( 'admin_init', 'myfp_settings_init' );
// 渲染文本输入字段的回调函数
function myfp_field_footer_cb() {
$text = get_option( 'myfp_footer_text', '感谢使用我的第一个插件！' ); // 获取已保存的值
echo '<input type="text" name="myfp_footer_text" value="' . esc_attr( $text ) . '" class="regular-text">'echo '<p class="description">Der hier eingegebene Text wird am Fuß der Website-Seite angezeigt.</p>';
}Die Update-Funktion wurde so verbessert, dass sie die gespeicherten Einstellungen verwendet.
Zum Schluss ändern wir das, was wir zuvor geschrieben haben. myfp_add_footer_text Eine Funktion, die die vom Administrator festgelegten Werte aus der Datenbank lädt.
function myfp_add_footer_text() {
$footer_text = get_option( 'myfp_footer_text', '感谢使用我的第一个插件！' );
if ( ! empty( $footer_text ) ) {
echo '<p style="text-align: center;">'`. esc_html($footer_text)`.'</p>';
}
}
add_action( 'wp_footer', 'myfp_add_footer_text' );Jetzt gehst du in das WordPress-Backend, klickst auf “Einstellungen” → “Meine Plugins” und kannst dort den Text des Fußes der Seite ändern sowie die Änderungen speichern. Nachdem du die Website neu geladen hast, sollte der angepasste Inhalt sichtbar sein.
Plugin-Sicherheit, Optimierung und Vorbereitung auf die Veröffentlichung
Ein qualitativ hochwertiger Plugin muss die besten Praktiken in Bezug auf Sicherheit, Leistung und Internationalisierung berücksichtigen.
Implementierung von Datenvalidierung und -entschlüsselung
Vertrauen Sie niemals den von Benutzern eingegebenen Daten oder den direkt aus der Datenbank ausgegebenen Daten. Im obigen Beispiel haben wir dies berücksichtigt. esc_attr() Um Attribute in Eingabefeldern zu escapen, verwenden Sie… esc_html() Bei der Ausgabe im Frontend müssen Zeichen entsprechend entschlossen werden („entschlüsselt“/„geëncodet“). Für komplexere Szenarien sollte man spezielle Methoden oder Frameworks verwenden. sanitize_text_field() Um die Eingaben zu bereinigen, verwenden Sie… wp_kses_post() Damit wird eine sichere Ausgabe von HTML ermöglicht.
Internationalisierungsunterstützung hinzufügen
Damit das Plugin von Nutzern auf der ganzen Welt verwendet werden kann, müssen alle für die Benutzer bestimmten Zeichenketten vorbereitet und übersetzt werden. Dafür ist es notwendig, __() und _e() Funktionen wie „Wait“ werden verwendet, und ein Textfeld wird deklariert.
Aktualisieren Sie die Kommentare am Anfang des Plugins, um sicherzustellen, dass sie aktuell und korrekt sind. Text Domain Konsistent mit den nachfolgenden Aufrufen. Anschließend ändern Sie die Zeichenketten im Code, zum Beispiel:
// 在设置字段描述中使用国际化函数
echo '<p class="description">' . esc_html__( '这里输入的文字将显示在网站页脚。', 'my-first-plugin' ) . '</p>';
// 在输出函数中使用
$default_text = __( '感谢使用我的第一个插件！', 'my-first-plugin' );
$footer_text = get_option( 'myfp_footer_text', $default_text );Danach können Sie Tools wie Poedit verwenden, um die Übersetzung zu erstellen. .pot Vorlagen-Dateien, die Übersetzer zum Erstellen verwenden können. .po und .mo Translate the file.
Durchführung der letzten Tests und Verpackung
Vor der Veröffentlichung muss die Funktionalität des Plugins in verschiedenen Umgebungen getestet werden – beispielsweise unter verschiedenen PHP-Versionen und verschiedenen WordPress-Versionen. Stellen Sie sicher, dass Aktionen wie die Aktivierung, Deaktivierung, Speicherung von Einstellungen sowie das Löschen von Daten keine Fehler verursachen und keine redundanten Daten hinterlassen. Sie können eine Deinstallations- und Reinigungsfunktion schreiben, um diese Prozesse automatisiert durchzuführen. register_uninstall_hook() Option zur Bereinigung der Datenbank, wenn der Benutzer einen Plugin deinstalliert.
Zum Schluss komprimieren Sie Ihre Plugin-Ordner in eine ZIP-Datei. .zip Die Datei – dieses Komprimierpaket – kann direkt über die “Upload-Plugin”-Funktion im WordPress-Backend installiert werden und entspricht auch den Formatanforderungen für die Einreichung in den offiziellen WordPress-Plugin-Verzeichnis.
Zusammenfassungen
Mit dieser Anleitung hast du den gesamten Prozess der Erstellung eines voll funktionsfähigen WordPress-Plugins von Grund auf abgeschlossen. Du hast gelernt, wie man die grundlegenden Dateien eines Plugins erstellt, Funktionen mithilfe von Action-Hooks hinzufügt, eine Backend-Verwaltungsoberfläche mit der WordPress-Settings-API erstellt, sowie wichtige Aspekte wie Sicherheit, Internationalisierung und das Packen von Plugins kennengelernt. Dieses einfache Fußertext-Plugin mag zwar grundlegend sein, aber die darin enthaltenen Strukturen, Hook-Mechanismen und die Settings-API bilden die Grundlage für die Entwicklung jeglicher komplexeren Plugins. Als Nächstes kannst du versuchen, fortgeschrittene Funktionen wie Shortcodes, benutzerdefinierte Artikeltypen oder REST-API-Endpunkte zu erkunden und deine Fähigkeiten im Plugin-Entwicklung weiter verbessern.
FAQ Häufig gestellte Fragen
Muss man PHP beherrschen, um WordPress-Plugins zu entwickeln?
Ja, PHP ist die Kernprogrammiersprache für die Entwicklung von WordPress und dessen Plugins. Du musst die Grundlagen der PHP-Syntax, Funktionen, Arrays sowie Konzepte der objektorientierten Programmierung beherrschen. Außerdem sind Kenntnisse in HTML, CSS und grundlegendem JavaScript von Vorteil bei der Entwicklung von Plugins, die eine Benutzeroberfläche enthalten.
Kann der Name der Hauptdatei des Plugins beliebig gewählt werden?
Ja, das ist möglich – allerdings muss der Name des Haupt-PHP-Files mit dem Namen des Plugins übereinstimmen. Aus Gründen der Übersichtlichkeit trägt der Haupt-PHP-File in der Regel denselben Namen wie das Plugin-Verzeichnis oder einen ähnlichen Namen. index.phpAm wichtigsten ist, dass der Dateianfang den korrekten Kommentarblock mit den Informationen zum Plugin enthält. WordPress erkennt das Plugin genau durch die Analyse dieses Kommentarblocks.
Warum wirken die Einstellungen meines Plugins nicht, nachdem sie gespeichert wurden?
Folgen Sie den folgenden Schritten zur Fehlerbehebung: Zuerst stellen Sie sicher, dass Ihre Einstellungsfelder korrekt und validiert sind. register_setting() Die Registrierung war korrekt – und außerdem… settings_fields() Der Name der Einstellungsgruppe in der Funktionsrufung stimmt überein. Zweitens wird die Formularprüfung durchgeführt. action Weist die Eigenschaft auf etwas hin (d.h. auf einen bestimmten Wert, eine bestimmte Ressource usw.)? options.phpSchließlich sollten Sie beim Ausgeben auf der Frontend-Seite sicherstellen, dass Sie die richtige Technologie oder Bibliothek verwenden. get_option() Die Funktion wird aufgerufen, und die übergebenen Optionen haben genau die gleichen Namen wie bei der Registrierung.
Wie kann ich sicherstellen, dass mein Plugin Daten löscht, wenn es deaktiviert wird?
Sie können es verwenden. register_uninstall_hook() Es gibt eine Funktion zur Registrierung eines Deinstallations-Hooks. In der Rückruffunktion dieses Hooks kannst du bestimmte Aktionen ausführen. delete_option() Eine Funktion, die alle von dem Plugin erstellten Datenbankoptionen entfernt. Bitte beachten Sie, dass diese Aktion nicht rückgängig gemacht werden kann und nur dann ausgeführt werden sollte, wenn der Benutzer ausdrücklich die Option “Deinstallieren” des Plugins auswählt – und nicht die Option “Deaktivieren”.
Kann man kostenlose Plugins in das offizielle WordPress-Verzeichnis einreichen?
Ja, WordPress ermutigt Entwickler offiziell, kostenlose Plugins, die den Standards entsprechen, in dessen Plugin-Verzeichnis einzusenden. Dafür benötigen Sie ein Konto bei WordPress.org und sollten die dortigen Anleitungen zur Plugin-Einreichung sorgfältig lesen. Ihr Code muss bestimmten Kodierstandards entsprechen und darf weder bösartige Code enthalten noch gegen Lizenzbedingungen verstoßen. Nach einer erfolgreichen Einreichung können Nutzer Ihr Plugin direkt über das WordPress-Backend suchen und installieren.
Was kommt als Nächstes, was kommt als Nächstes?
Erweiterte Lektüre und praktische Kenntnisse
Die folgenden Artikel stehen im Zusammenhang mit dem Thema dieses Artikels und eignen sich für eine vertiefte Lektüre. Oft ist es besser, mit dem Artikel zu beginnen, der Ihrem aktuellen Problem am nächsten kommt, und dann nach und nach die umliegenden Themen zu behandeln.
- Wie wählt und passt man ein perfektes WordPress-Theme für sich selbst aus?
- WordPress-Plugin-Entwicklungshandbuch: Von Null zu Eins – Erstellen Sie Ihr erstes benutzerdefinierte Plugin
- Wie man ein WordPress-Plugin-Entwickler wird: Ein umfassender Leitfaden von Grund auf
- Vom Nullpunkt zum Erfolg: Ein umfassender Leitfaden und praktische Tipps für das Erstellen professioneller Websites mit WordPress
- Komplettanleitung zur Entwicklung von WordPress-Plugins: Von der Grundlagenkenntnis bis zur Meisterschaft – Erstellen Sie professionelle Erweiterungen
Deutsch