Von der Einführung bis zur Praxis: Umfassender Leitfaden und fortgeschrittene Techniken für die Entwicklung von WordPress-Plugins

Grundlagen der WordPress-Plug-in-Entwicklung und Vorbereitung der Umgebung

Die Entwicklung von WordPress-Plugins ist der Hauptweg, um die Funktionalität des CMS zu erweitern. Um mit der Entwicklung zu beginnen, müssen Sie zunächst eine professionelle lokale Entwicklungsumgebung einrichten. Es wird empfohlen, Tools wie XAMPP, MAMP oder das modernere Local by Flywheel zu verwenden, mit denen Sie schnell eine voll funktionsfähige Webserverumgebung mit PHP, MySQL und Apache auf Ihrem Computer einrichten können. Stellen Sie außerdem sicher, dass Sie die neueste Version von WordPress sowie einen effizienten Code-Editor mit Unterstützung für PHP-Syntax-Hervorhebung wie Visual Studio Code oder PHPStorm installiert haben.

Der Kern der Entwicklung eines Plugins besteht darin, seine grundlegende Struktur zu verstehen. Ein Plugin ist im Wesentlichen ein oder mehrere Elemente, die sich in einemwp-content/plugins/PHP-Dateien im Verzeichnis. Die grundlegendste Anforderung ist, eine einzige Hauptdatei für das Plugin zu erstellen. Jedes Plugin muss eine bestimmte Kopfzeilenanmerkung enthalten, die Informationen wie den Plugin-Namen, die Beschreibung, die Version, den Autor usw. enthält. WordPress identifiziert und verwaltet Plugins, indem es diese Metadaten liest. Beispielsweise sieht die Kopfzeilenanmerkung eines einfachen Plugins wie folgt aus:

<?php
/**
 * Plugin Name: 我的第一个插件
 * Description: 这是一个用于演示的简单插件。
 * Version: 1.0
 * Author: 开发者名称
 */

Nachdem Sie die PHP-Datei mit dieser Anmerkung in den Plugin-Ordner gelegt haben, können Sie sie auf der “Plugins”-Seite im WordPress-Dashboard sehen und aktivieren.

Empfohlene Lektüre Von Grund auf: Eine vollständige Anleitung zur Entwicklung von WordPress-Plugins und ein Austausch über Best Practices。

Das Plugin-Verzeichnis und die Namenskonventionen

Ein gut strukturiertes Plugin ist für die Wartung und Zusammenarbeit von entscheidender Bedeutung. Es wird empfohlen, für Plugins mit komplexen Funktionen separate Verzeichnisse anstelle einer einzelnen Datei zu erstellen. Der Name des Verzeichnisses sollte kurz, eindeutig und vollständig in Kleinbuchstaben sein und normalerweise mit dem Hauptdateinamen Ihres Plugins übereinstimmen. Beispielsweise könnte das Verzeichnisstruktur eines Plugins mit dem Namen “my-awesome-plugin” den Hauptdatei enthalten.my-awesome-plugin.php, AufbewahrungcssundjsEin Ordner und ein Skript, um Hooks zu definieren.includes\nOrdner und für die InternationalisierunglanguagesOrdner. Die Einhaltung dieser Struktur verbessert die Lesbarkeit des Codes.

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

Kernkonzept: Aktions-Hooks und Filter

Das Verständnis des Hook-Systems von WordPress ist die Grundlage für die Entwicklung von Plugins. Hooks ermöglichen es Ihnen, Ihren eigenen Code zu “hinzufügen” oder Daten zu “filtern” zu einem bestimmten Zeitpunkt, ohne den Kerncode zu ändern. Es wird in zwei Hauptkategorien unterteilt: Aktions-Hooks (Actions) und Filter (Filters).

Die Anwendung von Aktion-Hooks

Aktions-Hooks ermöglichen es Ihnen, benutzerdefinierten Code an bestimmten Punkten im Lebenszyklus von WordPress auszuführen (z. B. beim Veröffentlichen eines Artikels, beim Laden einer Seite oder bei der Anmeldung eines Benutzers). Sie müssen dazuadd_action()Eine Funktion zum Registrieren eines Rückruf-Funktions. Wenn Sie beispielsweise am Anfang jedes Artikels automatisch einen Text hinzufügen möchten, können Sie dies mit einem Hook realisieren.the_contentBei dieser Aktion:

Funktion myplugin_prepend_content($content) {
    $prepend_text = '<p>Dies ist der Inhalt, der von meinem Plugin hinzugefügt wurde.</p>'add_filter('the_content', 'myplugin_prepend_content');

Beachten Sie, dass das obige Beispiel tatsächlich einen Filter verwendet, um den Inhalt zu ändern. Ein Beispiel für einen reinen Aktions-Hook istwp_footerEs gibt einen Code-Output am unteren Rand der Seite:

Funktion myplugin_footer_notice() {
    echo '<p>Diese Website wird von meinem Plugin unterstützt!</p>';
}
add_action('wp_footer', 'myplugin_footer_notice');

Der Mechanismus der Verwendung von Filtern

Filter werden verwendet, um alle Daten zu ändern, bevor sie gerendert oder in eine Datenbank eingefügt werden. Im Gegensatz zu Aktions-Hooks erhalten Filter einen Wert und müssen einen verarbeiteten Wert zurückgeben. Sie verwendenadd_filter()Sie können Filter mithilfe von Funktionen hinzufügen. Ein häufiges Beispiel ist die Änderung der Länge der Artikelüberschriften, die an einen Hook gebunden sind.excerpt_lengthFilter:

Empfohlene Lektüre Die Reise in die Entwicklung von WordPress-Plugins bedeutet, dass Sie gelernt haben, für die ganze Welt zu entwickeln.。

function myplugin_custom_excerpt_length($length) {
    return 20; // 将摘要长度改为20个单词
}
add_filter('excerpt_length', 'myplugin_custom_excerpt_length');

Das Beherrschen des Hook-Systems ermöglicht es Ihrem Plugin, nahtlos mit dem WordPress-Kern und anderen Plugins zusammenzuarbeiten.

Ein voll funktionsfähiges Plugin erstellen

Jetzt werden wir das oben erworbene Wissen zusammenfassen und ein praktisches Plugin mit Interaktion zwischen Front- und Backend erstellen: ein Plugin zur Anzeige der Anzahl der Lesungen eines Artikels. Dieses Plugin zeigt, wie man Datenbanktabellen erstellt, Front- und Backend sicher integriert und verwendet.wp_localize_script()Um PHP-Daten an JavaScript zu übermitteln.

Plugin-Initialisierung und Erstellung von Datentabellen

Die Hauptklasse des Namensraums des Plugins istPost_View_Counter。
Zunächst, wenn das Plugin aktiviert wird (mit Hilfe von <).register_activation_hookErstellen Sie eine Datenbank, um die Anzahl der gelesenen Bücher zu speichern.

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

class Post_View_Counter {
    public function __construct() {
        register_activation_hook(__FILE__, array($this, 'activate'));
        add_action('wp_enqueue_scripts', array($this, 'enqueue_scripts'));
        add_action('wp_ajax_nopriv_record_view', array($this, 'record_view'));
        add_action('wp_ajax_record_view', array($this, 'record_view'));
        add_filter('the_content', array($this, 'display_view_count'));
    }

public function activate() {
        global $wpdb;
        $table_name = $wpdb->prefix . 'post_views';
        $charset_collate = $wpdb->get_charset_collate();
        $sql = "CREATE TABLE $table_name (
            id mediumint(9) NOT NULL AUTO_INCREMENT,
            post_id bigint(20) NOT NULL,
            view_date datetime DEFAULT CURRENT_TIMESTAMP NOT NULL,
            PRIMARY KEY (id)
        ) $charset_collate;";
        require_once(ABSPATH . 'wp-admin/includes/upgrade.php');
        dbDelta($sql);
    }

Die Namen der Datenbanktabellen wurden verwendet.$wpdb->prefixUm die Einzigartigkeit in einer Umgebung mit mehreren Standorten zu gewährleisten.

Interaktion zwischen Front- und Backend sowie AJAX-Verarbeitung

Um die Anzahl der Lesungen asynchron zu aktualisieren, wenn ein Benutzer die Seite besucht, müssen wir JavaScript auf der Frontend-Seite einfügen. Zunächst verwenden wirwp_enqueue_script()Laden Sie die JS-Datei sicher und übermitteln Sie sie anschließend an den Browser.wp_localize_script()Übergeben Sie die erforderlichen Parameter (wie die aktuelle Artikel-ID und die AJAX-URL) an das Skript.

    public function enqueue_scripts() {
        if(is_single()) {
            wp_enqueue_script('pvc-script', plugin_dir_url(__FILE__) . 'js/pvc-script.js', array('jquery'), '1.0', true);
            wp_localize_script('pvc-script', 'pvc_ajax', array(
                'ajax_url' => admin_url('admin-ajax.php'),
                'post_id' => get_the_ID(),
                'nonce' => wp_create_nonce('pvc_nonce')
            ));
        }
    }

Anschließend schreiben Sie eine AJAX-Verarbeitungsfunktion.record_view()Um Frontend-Anfragen zu empfangen und Daten sicher in die Datenbank einzufügen. Hier müssen Berechtigungsprüfungen und Zufallszahlen-Validierungen durchgeführt werden, um CSRF-Angriffe zu verhindern.

Empfohlene Lektüre Erlernen Sie die WordPress-Plug-in-Entwicklung auf umfassende Weise: Erstellen Sie benutzerdefinierte Funktionsmodule von Grund auf.。

    public function record_view() {
        // 安全检查
        check_ajax_referer('pvc_nonce', 'nonce');
        $post_id = intval($_POST['post_id']);
        // 验证文章是否存在
        if(get_post_status($post_id)) {
            global $wpdb;
            $table_name = $wpdb->prefix . 'post_views';
            $wpdb->insert($table_name, array('post_id' => $post_id));
            wp_die('success');
        }
        wp_die('error', 400);
    }

Zum Schluss machen wir das noch einmal durch.the_contentDie Filter zeigen die Anzahl der Lesungen am Ende des Artikels an.

    public function display_view_count($content) {
        if(is_single()) {
            global $wpdb, $post;
            $table_name = $wpdb->prefix . 'post_views';
            $view_count = $wpdb->get_var($wpdb->prepare(
                "SELECT COUNT(*) FROM $table_name WHERE post_id = %d", $post->ID
            ));
            $content .= '<p>Dieser Artikel wurde bereits gelesen. <strong>'.intval($view_count) . '</strong> Das nächste Mal.</p>';
        }
        return $content;
    }
}
new Post_View_Counter();

Dieses Beispiel deckt die wichtigsten Prozesse der Plugin-Entwicklung ab, einschließlich Lebenszyklus-Management, Datenbank-Operationen, sichere Kommunikation und Funktionsintegration.

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

Erweiterte Techniken und Best Practices

Wenn Plugins komplexer werden, ist es äußerst wichtig, Best Practices zu befolgen. Dies betrifft nicht nur die Codequalität, sondern auch Sicherheit, Leistung und Wartbarkeit.

Die Internationalisierung des Plugins umsetzen.

Um Ihr Plugin für Benutzer auf der ganzen Welt nutzbar zu machen, muss es internationalisiert sein. WordPress verwendet das GNU-Gettext-Framework. Zunächst müssen Sie alle benutzerorientierten Textzeichenketten verwenden.__()、_e()Warten Sie, bis die Funktionen verpackt sind.

$greeting = __('你好，世界！', 'my-plugin-textdomain');
_e('这是一个可翻译的句子。', 'my-plugin-textdomain');

Anschließend erzeugen Sie mit Tools wie Poedit.potErzeugen Sie Vorlagendateien und lassen Sie Übersetzer die entsprechenden Sprachversionen erstellen..pound.moDokumente. Schließlich werden sie beim Laden des Plugins verwendet.load_plugin_textdomain()Der Funktion zum Laden von Übersetzungen. Dies kann die Akzeptanz des Plugins in nicht-englischsprachigen Märkten erheblich verbessern.

Einstellungsseite und Optionen-API

Professionelle Plugins bieten normalerweise eine Konfigurationsseite. WordPress bietet leistungsstarkeSettings APIUm Optionen sicher zu erstellen, zu überprüfen und zu speichern.
Sie müssenadd_options_page()oderadd_menu_page()Um eine Verwaltungsseite hinzuzufügen. Anschließend verwenden Sieregister_setting()、add_settings_section()undadd_settings_field()Um ein Formular zu erstellen und es mit den Optionen in der Datenbank zu verknüpfen.
Überprüfen und bereinigen Sie die Benutzereingaben immer, indem Sie Folgendes verwenden:sanitize_text_field()、intval()Warten Sie auf die Funktionen und verwenden Sie sie bei der Ausgabe.esc_html()oderesc_attr()Um XSS-Angriffe zu verhindern, muss eine Entitätseingabe durchgeführt werden.

Leistungsoptimierung und Sicherheitsverbesserung

Bei der Leistung sollte eine angemessene Nutzung erfolgen.wp_cache_get()undwp_cache_set()Warten Sie auf die WordPress-Objekt-Caching-Funktion, um die Abfrageergebnisse zu cachen. Bei häufigen Datenbankoperationen stellen Sie sicher, dass die SQL-Anweisungen optimiert sind und verwendet werden.$wpdb->prepare()Führen Sie eine Vorbereitungsabfrage durch, um SQL-Injection zu verhindern.
Im Hinblick auf die Sicherheit sollten Sie niemals auf Benutzereingaben vertrauen. Zusätzlich zu der oben genannten Reinigung und Entschärfung müssen Sie für die Verarbeitung sensibler Vorgänge (wie AJAX-Anfragen oder Formularübermittlungen) unbedingt Folgendes verwenden:wp_verify_nonce()undcheck_ajax_referer()Um die Zufallszahlen zu überprüfen, und verwenden Siecurrent_user_can()Überprüfen Sie die Benutzerberechtigungen. Dies wird eine solide Sicherheitsbarriere für das Plugin schaffen.

Zusammenfassungen

Die Entwicklung von WordPress-Plugins erfordert umfassende Fähigkeiten in PHP-Programmierung, dem Verständnis der WordPress-Core-API sowie Best Practices in der Webentwicklung. Beginnend mit der Erstellung einer einzelnen Datei mit Standard-Header-Kommentaren müssen Entwickler das zentrale Interaktionsmechanismus von Aktionen-Hooks und Filtern gründlich verstehen. Mit zunehmender Komplexität des Plugins wird die ordnungsgemäße Verwaltung von Datenbanken, die sichere Verarbeitung von AJAX-Anfragen und die Erstellung benutzerfreundlicher Einstellungs-Schnittstellen immer wichtiger. Darüber hinaus können fortgeschrittene Praktiken wie Internationalisierung, Leistungsoptimierung und sicheres Codieren einen einfachen Funktions-Script zu einem professionellen, zuverlässigen und beliebten kommerziellen Plugin machen. Kontinuierliches Lernen über den WordPress Codex und Entwicklerressourcen ist der beste Weg, um das Entwicklungsniveau ständig zu verbessern.

FAQ Häufig gestellte Fragen

### 开发WordPress插件需要哪些基础知识？
Um WordPress-Plugins zu entwickeln, benötigt man mindestens solide PHP-Grundkenntnisse, einschließlich objektorientierter Programmierkonzepte. Außerdem sind grundlegende Kenntnisse in HTML, CSS, JavaScript (insbesondere jQuery) und MySQL erforderlich. Am wichtigsten ist jedoch, dass man mit der Kernarchitektur von WordPress vertraut ist, insbesondere mit seinem Hook-System (Aktionen und Filter), globalen Variablen und Klassen für Datenbankoperationen.$wpdbUnd den Ablauf der Arbeit mit den Themenvorlagen.

Wie debuggt man ein selbst entwickeltes WordPress-Plugin?

Die effektivste Methode besteht darin, den Debug-Modus von WordPress zu aktivieren.wp-config.phpDatei, setzen Sie diedefine(‘WP_DEBUG’, true);Dies wird PHP-Fehler, Warnungen und Benachrichtigungen direkt auf der Seite anzeigen. Für die Fehlersuche in komplexeren Logiken können Sie < verwenden.error_log()Der Funktion wird die Variableninformation in das Fehlerprotokoll des Servers geschrieben, oder sie verwendet professionelle PHP-Debugging-Tools wie Xdebug. Für AJAX und Front-End-Interaktionen sind die Entwicklerwerkzeuge des Browsers (Konsolen- und Netzwerk-Panel) unerlässlich.

Wie ist mein Plugin mit anderen Plugins oder Themes kompatibel?

Der erste Grundsatz für eine gute Kompatibilität besteht darin, die von WordPress offiziell bereitgestellte API zu verwenden, anstatt die Kern-Dateien oder Datenbanktabellen direkt zu ändern. Die Verwendung eindeutiger Präfixe für Funktionen, Klassen und Variablen kann Namenskonflikte effektiv vermeiden. Verwenden Sie globale Variablen mit Vorsicht. Wenn Sie Hooks hinzufügen oder entfernen, stellen Sie sicher, dass sie zum richtigen Zeitpunkt ausgeführt werden (z. B. in <).initNach der Einbindung. Wenn die Funktionalität des Plugins möglicherweise überschrieben wird, sollten Sie in Betracht ziehen, Filter bereitzustellen, damit andere Entwickler es anpassen können. Testen Sie es vor der Veröffentlichung so weit wie möglich in verschiedenen Umgebungen und mit beliebten Themes.

Wie kann man sein Plugin in das offizielle Plugin-Verzeichnis von WordPress einreichen?

Zunächst müssen Sie ein Konto auf WordPress.org erstellen und das Plugin einreichen. Der Code Ihres Plugins muss den offiziellen Codierungsstandards entsprechen und darf keinen verschlüsselten oder verschleierten Code enthalten. Das Plugin muss eine standardkonforme Kopfzeilenanmerkung haben und sollte nach Möglichkeit ein ausführliches README-Dokument enthalten. Alle Textzeichenfolgen müssen internationalisierungsfähig sein. Nach der Einreichung wird das Plugin vom Prüfteam überprüft, das hauptsächlich auf Sicherheit, Codequalität und die Einhaltung der GPL-Lizenz achtet. Nach der Genehmigung kann Ihr Plugin von Nutzern weltweit gesucht und heruntergeladen werden.