Von Anfänger bis Experte: WordPress-Plugins entwickeln – eine Schritt-für-Schritt-Anleitung zum Erstellen benutzerdefinierter Funktionen.

Vorbereitung der Entwicklungsumgebung für WordPress-Plugins

Bevor du mit dem Schreiben der ersten Zeile Code beginnst, ist eine geeignete Entwicklungsumgebung die Grundlage für effizientes Arbeiten. Sie sorgt nicht nur dafür, dass dein Plugin in verschiedenen WordPress-Umgebungen stabil funktioniert, sondern verbessert auch erheblich die Effizienz beim Debuggen und Testen.

Aufbau einer lokalen Entwicklungsumgebung

Es wird dringend empfohlen, die Entwicklung lokal durchzuführen, anstatt direkt auf Online-Servern zu arbeiten. Sie können Tools wie XAMPP, MAMP, Local by Flywheel oder Docker verwenden, um schnell eine lokale Serverumgebung mit PHP, MySQL sowie Apache/Nginx einzurichten. Stellen Sie sicher, dass Ihre PHP-Version mit der Ziel-WordPress-Version kompatibel ist – in der Regel empfiehlt WordPress eine bestimmte PHP-Versionsspanne.

Code-Editor- und -Tool-Auswahl

Es ist von großer Bedeutung, einen leistungsstarken Code-Editor auszuwählen – beispielsweise VS Code, PhpStorm oder Sublime Text. Diese bieten in der Regel Funktionen wie Syntaxhervorhebung, Code-Vorschläge sowie Integrationen für das Versionsmanagement. Darüber hinaus kann die Installation von WordPress-relevanten Code-Snippets oder Plugins die Arbeit erheblich beschleunigen.add_action、add_filterDie Erstellung häufig verwendeter Funktionen.

Empfohlene Lektüre WordPress-Plugin-Entwicklung von Grund auf: Erstellung benutzerdefinierter Funktionen und Best Practices。

Erstellen Sie die Hauptdatei des Plugins.

Jeder WordPress-Plugin muss eine Haupt-PHP-Datei haben, die am Anfang standardisierte Kommentare mit Informationen zum Plugin enthält. Diese Datei dient als Eingangspunkt für das Plugin. Zum Beispiel planen wir, ein Plugin mit dem Namen “My Custom Greeting” zu erstellen; die Hauptdatei könnte dann „my_custom_greeting.php“ genannt werden.my-custom-greeting.php。

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: My Custom Greeting
 * Plugin URI:  https://yourwebsite.com/my-custom-greeting
 * Description: 一个简单的插件，用于在网站前台显示自定义问候语。
 * Version:     1.0.0
 * Author:      Your Name
 * License:     GPL v2 or later
 * Text Domain: my-custom-greeting
 */

Diese Anmerkung ist erforderlich, da WordPress sie verwendet, um Plugins zu erkennen und sie in der Backend-Verwaltungsoberfläche anzuzeigen.

Grundlegende Architektur von Plugins und Sicherheitsrichtlinien

Ein Plugin mit klarer Struktur und Einhaltung von Sicherheitsstandards bildet die Grundlage für eine langfristige Wartung sowie das Erhalten des Vertrauens der Nutzer. Die Befolgung der offiziellen WordPress-Programmierstandards und Sicherheitspraktiken kann häufig vorkommende Sicherheitslücken effektiv vermeiden.

Code mit Klassen organisieren

Obwohl Sie rein funktionalen Programmierstil verwenden können, ist es eine modernere und empfohlene Vorgehensweise, die Funktionen der Plugins mit objektorientierten (OOP) Klassen zu verpacken. Dies hilft dabei, Konflikte bei den Funktionsnamen zu vermeiden und die Codestruktur klarer zu gestalten. Wir erstellen eine Hauptklasse.My_Custom_Greeting。

if ( ! class_exists( 'My_Custom_Greeting' ) ) {
    class My_Custom_Greeting {
        public function __construct() {
            // 构造函数，在这里挂载钩子
        }
    }
    // 初始化插件
    new My_Custom_Greeting();
}

! class_exists()Die Überprüfung dient dazu, zu verhindern, dass Klassen doppelt definiert werden.

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

Implementierung von Sicherheits- und Berechtigungsüberprüfungen

Alle Funktionen, die Benanfragen auf der Frontend- oder Backend-Seite verarbeiten können, müssen Sicherheits- sowie Berechtigungsüberprüfungen durchführen. WordPress bietet dazu entsprechende Unterstützung.wp_verify_nonce()undcurrent_user_can()Funktionen wie diese werden benötigt, um die Umsetzung zu unterstützen. Dies ist eine zwingende Anforderung auf jeder Seite zur Einstellung von Plugins oder in der Logik zur Verarbeitung von Formularen.

Plugin-Verzeichnis und Dateiorganisation

Eine vernünftige Verzeichnisstruktur erleichtert die Verwaltung. Ein typisches Plugin-Verzeichnis kann folgende Elemente enthalten:
Hauptdokument my-custom-greeting.php (Befindet sich im Root-Verzeichnis des Plugins)
- includes/ Verzeichnis: Hier werden die Dateien der Kernfunktionsklassen abgelegt.
- admin/ Verzeichnis: Hier werden die mit dem Backend verbundenen Codes gespeichert.
- public/ Verzeichnis: Hier werden die Codes für die Benutzeroberfläche (Frontend) abgelegt.
- assets/ Verzeichnis: Hier werden CSS-Dateien, JavaScript-Dateien sowie Bilder gespeichert.
- languages/ Verzeichnis: Hier werden die internationalisierten Übersetzungsdateien (.po/.mo) abgelegt.

Core Features: Practical Use of Hooks and Filters

Das Kernprinzip des Plugins-Systems von WordPress sind die sogenannten “Hooks”, welche Action- und Filter-Funktionen umfassen. Das Verständnis sowie die geschickte Anwendung dieser Hooks ist entscheidend für die Entwicklung von Plugins.

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

Mit Action-Hooks Funktionen hinzufügen

Action Hooks ermöglichen es Ihnen, benutzerdefinierten Code zu bestimmten Zeitpunkten auszuführen – beispielsweise bei der Initialisierung, beim Laden einer Seite oder beim Veröffentlichen eines Artikels. Wir verwenden sie…add_action()Eine Funktion wird verwendet, um etwas zu mounten. Zum Beispiel…wp_footerFügen Sie unseren Gruß an die Stelle des Hakens hinzu.

„In“My_Custom_GreetingMounting in the constructor of a class:

public function __construct() {
    add_action( 'wp_footer', array( $this, 'display_greeting' ) );
}

Anschließend definiert man die entsprechenden Callback-Methoden.display_greeting：

Empfohlene Lektüre Komplettanleitung zur Entwicklung von WordPress-Plugins: Von Grund auf professionelle Erweiterungen erstellen。

public function display_greeting() {
    $name = get_option( 'my_greeting_name', '访客' );
    echo '<p id="custom-greeting">Hallo, '. esc_html($name)'. ‘! Willkommen auf unserer Website.</p>';
}

Inhalte mithilfe von Filter-Hooks ändern

Filter-Hooks ermöglichen es Ihnen, die von WordPress oder anderen Plugins erzeugten Daten zu ändern. Wir verwenden sie…add_filter()Funktionen – zum Beispiel die Änderung des Standard-Suffixes für die Artikelüberschriften.

add_filter( 'the_title', array( $this, 'modify_post_title' ), 10, 2 );

public function modify_post_title( $title, $id ) {
    if ( ! is_admin() && in_the_loop() ) {
        $title .= ' [推荐阅读]';
    }
    return $title;
}

Die Parameter hier10Es handelt sich um eine Priorität.2Es bedeutet, dass die Callback-Funktion zwei Parameter entgegennimmt.$titleund$id）。

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

Erstellung eines benutzerdefinierten Hooks

Ein ausgereiftes Plugin sollte auch eigene „Hooks“ (Verbindungsmechanismen) bereitstellen, die es anderen Entwicklern ermöglichen, das Plugin zu erweitern.do_action()Erstellen Sie einen Aktionshook, um ihn zu verwenden.apply_filters()Erstellen Sie einen Filter-Hook.

// 在插件某处执行一个自定义动作
do_action( 'my_custom_greeting_before_display', $name );

// 提供一个可过滤的问候语文本
$greeting_text = apply_filters( 'my_custom_greeting_text', '你好，' . $name . '！', $name );

Erstellen Sie eine Verwaltungsoberfläche für das Plugin.

Die meisten Plugins benötigen eine Backend-Einstellungsseite, damit die Benutzer das Verhalten des Plugins konfigurieren können. WordPress bietet eine umfassende API zur Erstellung von Menüseiten und Einstellungsseiten.

\nHinzufügen eines Verwaltungsmenüs

ausnutzenadd_action( ‘admin_menu’, … )Ein Hook wird verwendet, um Menüelemente hinzuzufügen. Wir haben für das Plugin eine Untermenüseite unter “Einstellungen” erstellt.

add_action( 'admin_menu', array( $this, 'add_admin_menu' ) );

public function add_admin_menu() {
    add_options_page(
        '自定义问候语设置', // 页面标题
        '问候语设置',       // 菜单标题
        'manage_options',   // 所需权限
        'my-custom-greeting', // 菜单slug
        array( $this, 'render_settings_page' ) // 回调函数，用于输出页面内容
    );
}

Erstellen einer Einstellungsseite und eines Formulars

In der Callback-Funktionrender_settings_pageIn diesem Fall müssen wir eine Form erstellen und die WordPress-Settings-API verwenden, um die Daten sicher zu speichern. Beginnen Sie damit, eine neue Einstellung zu registrieren.

add_action( 'admin_init', array( $this, 'register_settings' ) );

public function register_settings() {
    register_setting(
        'my_custom_greeting_options_group', // 选项组名
        'my_greeting_name',                 // 选项名
        array( 'sanitize_callback' => 'sanitize_text_field' ) // 清理回调
    );
}

Anschließend wird das Formular in der Funktion zur Seitendarstellung ausgegeben:

public function render_settings_page() {
    ?>
    <div class="wrap">
        <h2>Einstellung persönlicher Begrüßungsnachrichten</h2>
        <form method="post" action="/de/options.php/" data-trp-original-action="options.php">
            <?php settings_fields( 'my_custom_greeting_options_group' ); ?>
            <table class="form-table">
                <tr>
                    <th scope="row"><label for="greeting_name">Name des Gegrüßten</label></th>
                    <td>
                        <input type="text" id="greeting_name" name="my_greeting_name" value="<?php echo esc_attr( get_option( 'my_greeting_name', '访客' ) ); ?>" class="regular-text" />
                        <p class="description">Der hier eingegebene Name wird in der Begrüßung auf der Benutzeroberfläche angezeigt.</p>
                    </td>
                </tr>
            </table>
            <?php submit_button(); ?>
        <input type="hidden" name="trp-form-language" value="de"/></form>
    </div>
    &lt;?php
}

Hinzufügen von Skripten und Stylesheets

Um die Benutzeroberfläche attraktiver oder interaktiver zu gestalten, ist es notwendig, CSS- und JavaScript-Dateien auf den Einstellseiten hinzuzufügen.admin_enqueue_scripts„Hook“-Mechanismen werden genutzt, um bestimmte Aktionen auszulösen, und der Page-Slug wird überprüft, um sicherzustellen, dass die Seite nur dann geladen wird, wenn es sich um eine Seite unseres Plugins handelt.

add_action( 'admin_enqueue_scripts', array( $this, 'enqueue_admin_assets' ) );

public function enqueue_admin_assets( $hook ) {
    if ( 'settings_page_my-custom-greeting' !== $hook ) {
        return;
    }
    wp_enqueue_style( 'my-custom-greeting-admin', plugin_dir_url( __FILE__ ) . 'assets/css/admin-style.css' );
    wp_enqueue_script( 'my-custom-greeting-admin', plugin_dir_url( __FILE__ ) . 'assets/js/admin-script.js', array( 'jquery' ), '1.0.0', true );
}

Zusammenfassungen

Durch die Schritte in diesem Artikel haben wir den gesamten Entwicklungsprozess eines WordPress-Plugins abgeschlossen: Von der Einrichtung der Umgebung und der Erstellung einer grundlegenden Sicherheitsstruktur über die Nutzung von Aktionen und Filter-Hooks zur Implementierung der Kernfunktionen bis hin zur Erstellung einer benutzerfreundlichen Verwaltungsoberfläche. Der Schlüssel zur Plugin-Entwicklung liegt darin, das Hook-System von WordPress gründlich zu verstehen und dessen Sicherheits- sowie Kodierstandards einzuhalten. Ausgehend von diesem kleinen Plugin können Sie seine Funktionen durch die Hinzufügung weiterer Klassen, die Verwendung komplexerer Datenbankoperationen, die Integration von REST-APIs oder die Erstellung benutzerdefinierter Blöcke (z. B. Gutenberg-Blöcke) kontinuierlich erweitern und letztendlich ein leistungsstarkes, leicht zu wartendes, professionelles Plugin erstellen.

FAQ Häufig gestellte Fragen

Wie kann ich mein WordPress-Plugin debuggen?
Die Aktivierung des Debugging-Modus in WordPress ist die effektivste Methode.wp-config.phpIn der Datei wird Folgendes festgelegt:WP_DEBUGDie Konstante ist auftruePHP-Fehler, Warnungen und Benachrichtigungen werden direkt auf der Seite angezeigt. Für eine umfassendere Fehlersuche kann man weitere Werkzeuge verwenden.error_log()Die Funktion protokolliert die Informationen im Fehlerprotokoll des Servers oder verwendet professionelle PHP-Debugging-Tools wie Xdebug.

Wie kann meine Erweiterung mit verschiedenen PHP-Versionen kompatibel sein?

Während der Entwicklung sollte der Einsatz von zu neuen oder zu veralteten, bereits nicht mehr unterstützten PHP-Funktionen vermieden werden. Schauen Sie sich die offizielle PHP-Dokumentation an, um die minimale unterstützte Version der jeweiligen Funktionen zu erfahren. In der Hauptdatei oder im Dokumentationsteil des Plugins kann dies entsprechend angegeben werden.Requires PHP:Die Head-Tags dienen dazu, die minimale PHP-Version anzugeben, die für das Plugin erforderlich ist. Dadurch gibt WordPress eine Warnung aus, wenn die vorgeschriebenen Bedingungen nicht erfüllt sind.

Wie kann ich dafür sorgen, dass mein Plugin mehrsprachige Internationalisierung unterstützt?

WordPress nutzt das GNU gettext-Framework zur Implementierung der Internationalisierung (i18n). Zunächst werden an allen Stellen, an denen Übersetzungen erforderlich sind, entsprechende Tags verwendet…__()、_e()oder_x()Diese Funktionen werden erst verpackt, und anschließend werden Tools wie Poedit verwendet, um den Code zu scannen und die entsprechenden Ergebnisse zu generieren..potVorlagen-Dateien und erstellen Sie dann für jede Sprache die entsprechenden.pound.moDokumente. Schließlich werden sie beim Laden des Plugins verwendet.load_plugin_textdomain()Funktionen laden…

Was muss man beachten, wenn man ein Plugin in den offiziellen WordPress-Katalog einreicht?

Bevor Sie den Code einreichen, stellen Sie sicher, dass er streng den WordPress-Codestandards und -Dokumentationsrichtlinien entspricht. Der Plugin-Code muss unter einer Lizenz wie GPLv2 oder einer kompatiblen Lizenz veröffentlicht werden. Es ist außerdem erforderlich, detaillierte Informationen bereitzustellen.readme.txtDie Datei enthält eine Beschreibung, Anleitung zur Installation, Screenshots sowie häufig gestellte Fragen. Dein Code muss sicher sein und keine bösartigen Funktionen enthalten; außerdem darf die Nutzung von Shortcodes zur Ausführung der Kernfunktionen nicht erforderlich sein – das Produkt sollte somit sofort nach der Installation nutzbar sein. Nach der Einreichung wird das Review-Team die Datei gründlich überprüfen.