WordPress-Plugin-Entwicklung von Grund auf: Erstellung benutzerdefinierter Funktionen und Best Practices

Warum ist es notwendig, eigene WordPress-Plugins zu entwickeln?

Die Kernfunktionen von WordPress sind sehr leistungsfähig, doch angesichts der ständig wechselnden Geschäftsanforderungen reichen die vorinstallierten Funktionen oft nicht aus. Durch die Entwicklung eigener Plugins können Sie beliebige, individuelle Ideen nahtlos in Ihre Website integrieren, ohne die WordPress-Kerndateien ändern zu müssen. Dies gewährleistet die Wartbarkeit der Website sowie die Sicherheit bei Upgrades. Custom Plugins ermöglichen es Ihnen, spezifische Funktionen zu kapseln, sodass sie zwischen verschiedenen Themes übertragen oder auf mehreren Webseiten wiederverwendet werden können – was die Entwicklungseffizienz erheblich steigert.

Erstellen Sie Ihr erstes WordPress-Plugin.

Die Erstellung eines grundlegenden WordPress-Plugins ist der beste Ausgangspunkt, um die Architektur von WordPress zu verstehen. Der gesamte Prozess beginnt mit der Erstellung eines einfachen Verzeichnisses und einer Hauptdatei.

Erstellen Sie die Hauptdatei des Plugins.

Jeder WordPress-Plugin muss eine Haupt-PHP-Datei haben, deren Kopfabschnitt spezifische Metainformationen enthält. Diese Datei ist der Einstiegspunkt des Plugins. Wir erstellen eine Datei mit dem Namen… my-first-plugin.php Die Datei…

Empfohlene Lektüre Komplettes Handbuch für die Entwicklung von WordPress-Themen: Ein praktischer Leitfaden von der Grundlage bis zur Meisterschaft。

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

Legen Sie die Datei mit dem obigen Code in /wp-content/plugins/my-first-plugin/ Nachdem Sie das Verzeichnis angelegt haben, können Sie das Plugin auf der “Plugins”-Seite im WordPress-Backend sehen und aktivieren. Obwohl es derzeit noch keine Funktionen besitzt, ist die Struktur bereits vollständig.

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

Für das Plugin eine einfache Funktion hinzufügen

Nach der Aktivierung hat ein funktionsloser Plugin kaum einen Nutzen. Lassen Sie uns ihm eine grundlegende Funktion hinzufügen: Die Möglichkeit, einen benutzerdefinierten Text in den Fußbereich der Websiteseite einzufügen. Dafür werden wir WordPress verwenden. wp_footer Ein Hook wird verwendet, um diese Funktion zu implementieren.

„In“ my-first-plugin.php Unter den Kommentaren zur Hauptdatei fügen Sie den folgenden Code hinzu:

// 在网站页脚输出自定义文本
function myfp_add_footer_text() {
    echo '<p style="text-align: center;">Vielen Dank, dass Sie mein erstes WordPress-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 den hinzugefügten Text am unteren Rand der Seite sehen. Dieses Beispiel zeigt die Verwendung von… add_action() Die Funktion “montiert” eine benutzerdefinierte Funktion in den grundlegenden Ablauf des WordPress-Kerns.

Einschauen in die Kernmechanismen von WordPress-Plugins

Um leistungsstarke und stabile Plugins zu entwickeln, ist es erforderlich, die verschiedenen Kernprogrammierschnittstellen von WordPress zu verstehen: Action-Hooks, Filter-Hooks und Shortcodes.

Empfohlene Lektüre Einführung in die Entwicklung von WordPress-Plugins: Erstellen Sie Ihre erste Funktionserweiterung von Grund auf.。

Das Verständnis und die Verwendung von Aktions-Hooks

Action Hooks ermöglichen es Ihnen, Ihren eigenen Code zu bestimmten Zeitpunkten während der Ausführung von WordPress einzufügen. Zum Beispiel…init Die Hook-Funktion wird bei der Initialisierung von WordPress ausgelöst und wird häufig verwendet, um benutzerdefinierte Artikeltypen oder Kategorien zu registrieren.

Der folgende Code zeigt, wie eine benutzerdefinierte Funktion bei der Initialisierung eines Plugins ausgeführt werden kann:

function myfp_custom_initialization() {
    // 在这里执行初始化任务，例如设置默认选项
    error_log('我的插件已初始化！');
}
add_action( 'init', 'myfp_custom_initialization' );

Ein weiterer häufig verwendetes Hook ist… admin_menuDieses Tool dient dazu, Menüseiten im Backend-Verwaltungspanel hinzuzufügen. Mithilfe davon können Sie für Plugins separate Einstellungsseiten erstellen.

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

Die Anwendung von Filter-Hooks beherrschen

Filter Hooks unterscheiden sich von Action Hooks dadurch, dass sie dazu dienen, Daten zu verändern. WordPress übermittelt die Daten an eine Funktion über einen Filter, und die Funktion gibt die veränderten Daten anschließend zurück.the_content Filter werden verwendet, um den Inhalt von Artikeln zu ändern.

Das folgende Beispiel zeigt, wie man am Ende des Inhalts aller Artikel automatisch einen Hinweistext hinzufügen kann:

function myfp_add_content_note( $content ) {
    if ( is_single() ) {
        $note = '<div class="myfp-note">Dieser Artikel wurde von meinem Plugin verarbeitet.</div>';
        $content .= $note;
    }
    return $content;
}
add_filter( 'the_content', 'myfp_add_content_note' );

Durch die flexible Nutzung von Filtern kannst du nahezu alle Ausgabeinhalte von WordPress auf nicht-invasive Weise verändern.

Empfohlene Lektüre Das ultimative Handbuch für die Entwicklung von WordPress-Themen: Von den Grundprinzipien bis zur praktischen Umsetzung。

Erstellen Sie benutzerfreundliche Kurzcodes.

Shortcodes ermöglichen es Benutzern oder Entwicklern, dynamische Inhalte mithilfe eines einfachen Tags in Artikeln oder Seiten einzufügen. add_shortcode() Funktionen ermöglichen es, kurzen Code einfach zu erstellen.

Zum Beispiel kann man einen kurzen Code erstellen, der die aktuelle Datum- und Zeitangabe anzeigt:

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 myfp_current_datetime_shortcode( $atts ) {
    // 处理短代码属性
    $attributes = shortcode_atts( array(
        'format' => 'Y-m-d H:i:s',
    ), $atts );

// 返回格式化后的当前时间
    return date( $attributes['format'] );
}
add_shortcode( 'show_current_time', 'myfp_current_datetime_shortcode' );

Nach der Erstellung muss der Benutzer lediglich im Editor die gewünschten Inhalte eingeben. [show_current_time format="F j, Y"] Damit kann ein formatierter Datum ausgegeben werden.

Befolgen Sie die besten Praktiken für die Entwicklung von Plugins.

Die Befolgung von Best Practices sorgt dafür, dass Ihre Plugins sicher, effizient und leicht zu warten sind – was für die öffentliche Veröffentlichung oder die Zusammenarbeit im Team von entscheidender Bedeutung ist.

Sicherheit und Datenvalidierung

Alle Daten, die von Benutzern oder aus externen Quellen eingegeben werden, müssen als unzuverlässig angesehen werden. Es ist eine grundlegende Anforderung, die von WordPress bereitgestellten Hilfsfunktionen zur Überprüfung, Reinigung und Entschlüsselung der Daten zu verwenden.

• Validierung: Überprüfen, ob die Daten dem erwarteten Format entsprechen (z. B. ob es sich um eine E-Mail-Adresse handelt). Verwenden Sie hierfür is_email()、absint() Zum Beispiel können Sie die folgenden Funktionen verwenden:
• Sanitization: Die Bereinigung von Daten durch die Entfernung unsicherer Zeichen. sanitize_text_field()、sanitize_email() Zum Beispiel können Sie die folgenden Funktionen verwenden:
• Entkommen (Escaping): Vor dem Ausgeben von Daten in HTML, JavaScript oder URLs werden diese entkommen. Dazu wird Folgendes verwendet: esc_html()、esc_js()、esc_url() Zum Beispiel können Sie die folgenden Funktionen verwenden:

Der folgende Code zeigt, wie die Daten eines Formulars vor der Speicherung in der Datenbank gereinigt werden:

$user_input = $_POST['custom_text'];
$clean_input = sanitize_text_field( $user_input );
update_option( 'myfp_saved_text', $clean_input );

Implementierbare Plugin-Optionen

Die Bereitstellung einer Einstellungsseite für ein Plugin ist entscheidend, um die Benutzererfahrung zu verbessern. Dies beinhaltet in der Regel die Erstellung einer Seite, auf der Benutzer verschiedene Einstellungen für das Plugin vornehmen können. admin_menu Menüelemente werden in die „Hook-Funktionen“ hinzugefügt, und die WordPress-Settings-API wird verwendet, um Optionen sicher zu registrieren, zu speichern und zu verifizieren.

Zuerst fügen Sie ein Verwaltungsmenü hinzu:

function myfp_add_admin_menu() {
    add_options_page(
        '我的插件设置',          // 页面标题
        '我的插件',              // 菜单标题
        'manage_options',       // 权限
        'myfp-settings',        // 菜单slug
        'myfp_settings_page'    // 回调函数，用于输出页面内容
    );
}
add_action( 'admin_menu', 'myfp_add_admin_menu' );

Dann musst du definieren… myfp_settings_page Eine Funktion wird verwendet, um die Einstellungsseite mit dem Formular zu rendern und diese anschließend zu verwenden. register_setting()、add_settings_section() und add_settings_field() Funktionen wie „Wait“ werden verwendet, um Optionen zu verwalten.

Sicherstellung der Wartbarkeit des Codes

Mit dem Wachstum der Funktionen von Plugins wird die Modularisierung des Codes von großer Bedeutung. Verschiedene Funktionen – wie Shortcodes, Widgets oder Backend-Einstellungen – sollten in separate Klassen oder Dateien aufgeteilt werden. Die Verwendung objektorientierter Programmierung (OOP) ermöglicht eine bessere Organisation des Codes, da durch Klassen relevante Funktionen und Daten zusammengefasst werden können.

Ziehen Sie in Betracht die Verwendung eines Autoloaders, um Klassendateien nach Bedarf zu laden. Dies kann die Leistung verbessern und die Codestruktur vereinfachen. Fügen Sie außerdem klare Kommentare zu Ihrem Code hinzu und halten Sie sich an die offiziellen WordPress-Codestandards – dies erleichtert es anderen, den Code zu lesen und daran mitzuarbeiten.

Zusammenfassungen

Die Entwicklung von WordPress-Plugins ist ein Prozess, bei dem Kreativität in funktionale Lösungen umgewandelt wird. Der Kern dieser Arbeit besteht darin, das Hook-System sowie Shortcodes zu verstehen und geschickt einzusetzen. Beginnen Sie mit der Erstellung einer Hauptdatei, die standardmäßige Kopfzeilen-Anmerkungen enthält, und integrieren Sie schrittweise Aktion-Hooks, um in den Ausführungsprozess einzugreifen. Nutzen Sie Filter-Hooks, um Daten zu verändern, und bieten Sie mithilfe von Shortcodes eine benutzerfreundliche Möglichkeit zum Einbetten von Inhalten. Während der gesamten Entwicklungsphase muss die Sicherheit an erster Stelle stehen – führen Sie daher strenge Datenüberprüfungen, -reinigungen und -Entschlüsselungen durch. Außerdem sollten Sie die Setup-API nutzen, um solide Backend-Optionenseiten zu erstellen. Eine modulare, objektorientierte Architektur sowie die Einhaltung von Kodierstandards sind die Grundlagen für die langfristige Wartbarkeit und Kompatibilität Ihrer Plugins. Wenn Sie diese Prinzipien und Methoden beherrschen, können Sie leistungsstarke, sichere und professionelle WordPress-Plugins entwickeln.

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 aus PHP-Code bestehen. Außerdem ist ein grundlegendes Verständnis von HTML, CSS und JavaScript notwendig, um die Frontend-Anzeige und -Interaktionen zu gestalten. Am wichtigsten ist es, die grundlegende Architektur von WordPress zu verstehen – insbesondere sein Hook-System (Aktionen und Filter) sowie die Art und Weise der Datenbankoperationen.

Wie kann man einen neu entwickelten Plugin testen, ohne die Funktionalität der Website zu beeinträchtigen?

Es wird empfohlen, die Plugins in einer lokalen Entwicklungsumgebung oder auf einer Staging-Website zu testen. Sie können Tools wie XAMPP, MAMP oder Local by Flywheel verwenden, um eine lokale WordPress-Umgebung einzurichten. Während des Tests sollten Sie sicherstellen, dass WordPress … WP_DEBUG Die Konstante ist auf trueDamit alle Fehler- und Warnmeldungen angezeigt werden, wenn Probleme auftreten, und es leichter fällt, das Problem schnell zu lokalisieren.

Wie kann meine Erweiterung mit verschiedenen WordPress-Themen kompatibel sein?

Um sicherzustellen, dass die Plugins mit verschiedenen Themes kompatibel sind, sollte man davon absehen, die Theme-Template-Dateien direkt zu ändern. Stattdessen sollte man dies mithilfe der WordPress-Hooks erreichen. wp_head, wp_footer, the_contentFunktionen oder Inhalte werden mithilfe von Plugins hinzugefügt. Bei der Erstellung der HTML-Datei sollten die CSS-Klassenamen der Plugins verwendet werden, die jeweils mit einem eindeutigen Präfix versehen sind. Zudem sollte die Stylesheet-Struktur so weit wie möglich abgeschirmt werden, um Konflikte mit den Stylesheets des Themes zu vermeiden.

Nach Abschluss der Entwicklung: Wie kann ich mein Plugin in das offizielle Verzeichnis einreichen?

Um ein Plugin in das offizielle Verzeichnis von WordPress.org zu einreichen, musst du zunächst ein Konto auf WordPress.org erstellen und das Plugin dort hochladen. Dein Code muss den Anforderungen der GPLv2-Lizenz oder einer späteren Version entsprechen. Der Einreichungsprozess umfasst eine Codeüberprüfung, um sicherzustellen, dass kein bösartiger Code enthalten ist und dass grundlegende Sicherheitsrichtlinien sowie Codestandards eingehalten werden. Außerdem musst du für das Plugin klare Dokumentationen, Screenshots sowie Übersetzungsdateien bereitstellen.