Praktischer Leitfaden für die Entwicklung von WooCommerce-Plugins: Erstellen Sie von Grund auf benutzerdefinierte E-Commerce-Funktionen

Aufbau der Entwicklungsumgebung für WooCommerce-Plugins

Um mit der Entwicklung von WooCommerce-Plugins zu beginnen, ist es erst einmal notwendig, eine professionelle lokale Entwicklungsumgebung einzurichten. Es wird empfohlen, die folgenden Tools und Konfigurationen zu verwenden:Local by FlywheeloderXAMPPStellen Sie sicher, dass die Integrationsumgebung bereitsteht, und installieren Sie die neuesten Versionen von WordPress und WooCommerce.wp-config.phpDie Datei wird…WP_DEBUGEinstellen auftrueDamit während des Entwicklungsprozesses Fehler und Warnungen erkannt werden können.

Die Grundstruktur eines Plugins wird in der Regel mit einer Hauptdatei erstellt. Diese Datei dient als Eingangspunkt für das Plugin und muss standardmäßige Plugin-Hauptinformationen enthalten, damit sie von WordPress erkannt werden kann. Die Bezeichnung der Hauptdatei des Plugins sollte eindeutig sein – zum Beispiel…my-custom-woocommerce.phpHier ist ein Beispiel für die grundlegende Struktur einer Plugin-Datei.

<?php
/**
 * Plugin Name: My Custom WooCommerce Features
 * Description: 为WooCommerce添加自定义电商功能。
 * Version: 1.0.0
 * Author: Your Name
 */

if ( ! defined( 'ABSPATH' ) ) {
    exit; // 防止直接访问
}

In der Grundstruktur muss man auch das Mechanismus der Abhängigkeitsladung von WooCommerce verstehen. Der Code deines Plugins sollte daher entsprechend darauf abgestimmt sein.plugins_loadedoderinitDie Anweisung wird nach dem Ausführen des „Hook“-Mechanismus ausgeführt, um sicherzustellen, dass die Kernklassen von WooCommerce bereits geladen wurden. Sie können dies durch…class_exists( 'WooCommerce' )Überprüfen Sie, ob WooCommerce aktiviert ist – das ist der erste Schritt zur Gewährleistung einer guten Kompatibilität.

Empfohlene Lektüre Eindeutige Analyse der WordPress-Plugin-Entwicklung: Von der Grundlage aus eigene Funktionen erstellen und erweitern。

Entwicklung von Kernfunktionen: Die Anwendung von Hooks und Filtern

Die Stärke von WooCommerce liegt in seiner Erweiterbarkeit, die hauptsächlich durch Action Hooks und Filter Hooks erreicht wird. Action Hooks ermöglichen es Ihnen, benutzerdefinierten Code zu bestimmten Zeitpunkten auszuführen, während Filter Hooks es Ihnen ermöglichen, die übergebenen Daten zu modifizieren.

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

Wie fügt man benutzerdefinierte Bezahlungsfelder hinzu?

Eine häufige Anforderung besteht darin, zusätzliche Felder auf der Kasse-Seite hinzuzufügen. Dies kann durch…woocommerce_checkout_fieldsDies wird mithilfe von Filtern umgesetzt. Der folgende Code zeigt, wie man ein einfaches Feld für die “Unternehmenssteuernummer” in den Bereich mit den Rechnungsinformationen hinzufügt.

add_filter( 'woocommerce_checkout_fields', 'my_custom_checkout_fields' );
function my_custom_checkout_fields( $fields ) {
    $fields['billing']['billing_vat_number'] = array(
        'label'     => __('税号 / VAT Number', 'woocommerce'),
        'placeholder'   => _x('请输入您的公司税号', 'placeholder', 'woocommerce'),
        'required'  => false, // 根据需求设置为 true 或 false
        'class'     => array('form-row-wide'),
        'clear'     => true
    );
    return $fields;
}

Nachdem Sie das Feld hinzugefügt haben, müssen Sie es auch noch verwenden.woocommerce_checkout_update_order_metaDie Aktion speichert den Feldwert in die Bestellmetadaten und verwendet ihn anschließend.woocommerce_admin_order_data_after_billing_addressundwoocommerce_order_details_after_customer_detailsDie Hook-Funktionen sorgen dafür, dass dieser Wert auf den Bestellseiten sowohl im Frontend als auch im Backend angezeigt wird.

Ändern der Berechnungslogik für die Preisgestaltung von Waren

Ein weiteres zentrales Szenario ist die Anpassung von Produktpreisen an benutzerdefinierte Regeln – beispielsweise die Bereitstellung zusätzlicher Rabatte für bestimmte Benutzerrollen. Dies kann durch die folgenden Methoden erreicht werden:woocommerce_product_get_priceDies wird durch einen Filter realisiert. Der Filter wird bei jeder Preisabfrage aufgerufen, was die dynamische Preisgestaltung ermöglicht.

add_filter( 'woocommerce_product_get_price', 'custom_role_based_discount', 10, 2 );
function custom_role_based_discount( $price, $product ) {
    if ( is_user_logged_in() && current_user_can( 'wholesale_customer' ) ) {
        // 为批发客户提供15%的折扣
        $price = $price * 0.85;
    }
    return $price;
}

Erstellen einer benutzerdefinierten Verwaltungsoberfläche und von Einstellungsoptionen

Um die Funktionen Ihrer Erweiterung konfigurierbar zu machen, ist es in der Regel notwendig, eine übersichtliche Verwaltungsseite zu erstellen. WordPress bietet dazu die entsprechenden Möglichkeiten.Settings APIOrdnungsgemäß fügen Sie die Einstellungsseite, die Bereiche sowie die Felder hinzu.

Empfohlene Lektüre Das ultimative Handbuch für WooCommerce-Plugins mit detaillierter Codeerklärung: Von der Installation bis zur individuellen Entwicklung。

Fügen Sie eine neue Registerkarte zu den WooCommerce-Einstellungen hinzu.

Die beste Praxis besteht darin, die Einstellungen deines Plugins in die bestehende Struktur der WooCommerce-Einstellungen zu integrieren. Dafür kannst du…woocommerce_get_settings_pagesUm eine neue Klassenseite für die Filterfunktion hinzuzufügen, erstellen Sie zunächst eine Klasse, die von einer bestehenden Klasse erbt.WC_Settings_PageDie Klasse „…“.

add_filter( 'woocommerce_get_settings_pages', 'add_my_custom_settings_page' );
function add_my_custom_settings_page( $settings ) {
    $settings[] = include plugin_dir_path( __FILE__ ) . 'includes/class-wc-settings-my-plugin.php';
    return $settings;
}

Und dann,class-wc-settings-my-plugin.phpDie Klasse wird in der Datei definiert; diese Definition wird überschrieben.get_settings()Eine Methode, um dein Array der Einstellungsfelder zurückzugeben.

class WC_Settings_My_Plugin extends WC_Settings_Page {
    public function __construct() {
        $this->id = ‘my-plugin’;
        $this->label = __(‘我的插件’, ‘my-text-domain’);
        parent::__construct();
    }

public function get_settings() {
        return array(
            array(
                ‘title’ => __(‘基本配置’, ‘my-text-domain’),
                ‘type’  => ‘title’,
                ‘id’    => ‘my_plugin_options’
            ),
            array(
                ‘title’   => __(‘启用功能’, ‘my-text-domain’),
                ‘desc’    => __(‘启用自定义折扣功能’),
                ‘id’      => ‘my_plugin_enable_discount’,
                ‘default’ => ‘no’,
                ‘type’    => ‘checkbox’
            ),
            // ... 更多设置字段
        );
    }
}

Speichern und Überprüfen der Einstellungsdaten

DurchSettings APIundWC_Settings_PageDie Einstellungen, die über die Klassen hinzugefügt werden, werden vom Kern von WooCommerce automatisch gespeichert und überprüft. Dennoch können Sie diese Einstellungen auch manuell anpassen.woocommerce_admin_settings_sanitize_option_{option_id}Filter führen eine zusätzliche Reinigung und Überprüfung der Werte bestimmter Felder durch, um die Genauigkeit und Sicherheit der eingegebenen Daten zu gewährleisten.

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

Erweiterte Funktionen und benutzerdefinierte Datentabellen

Wenn ein Plugin komplexe oder umfangreiche relationale Daten speichern muss, kann es sinnvoller sein, auf die benutzerdefinierten Datenbanktabellen von WordPress zurückzugreifen, anstatt auf externe Lösungen zu vertrauen.wp_postmetaDie Tabellen sind effizienter in ihrer Funktionsweise. Dies tritt in der Regel auf, wenn ein Plugin aktiviert wird.

Die Datentabelle wird erst beim Aktivieren des Plugins erstellt.

Sie müssen Folgendes verwenden:register_activation_hookHooken Sie Funktionen, die beim Aktivieren des Plugins ausgeführt werden sollen. Innerhalb dieser Funktionen können Sie dann die gewünschten Aktionen durchführen.$wpdbObjekte unddbDelta()Eine Funktion, die es ermöglicht, die Struktur Ihrer Tabellen sicher zu erstellen oder zu aktualisieren.dbDelta()Die Funktion erfordert eine sehr strenge Formatierung der SQL-Anweisungen.

register_activation_hook( __FILE__, ‘my_plugin_create_tables’ );
function my_plugin_create_tables() {
    global $wpdb;
    $charset_collate = $wpdb->get_charset_collate();
    $table_name = $wpdb->prefix . ‘my_plugin_subscriptions’;

$sql = “CREATE TABLE $table_name (
        id bigint(20) NOT NULL AUTO_INCREMENT,
        user_id bigint(20) NOT NULL,
        product_id bigint(20) NOT NULL,
        status varchar(20) DEFAULT ‘active’ NOT NULL,
        created_at datetime DEFAULT CURRENT_TIMESTAMP NOT NULL,
        PRIMARY KEY (id),
        KEY user_id (user_id),
        KEY product_id (product_id)
    ) $charset_collate;”;

require_once( ABSPATH . ‘wp-admin/includes/upgrade.php’ );
    dbDelta( $sql );
}

Integration von benutzerdefinierten Daten in WooCommerce-Abfragen

Nachdem Sie eine benutzerdefinierte Tabelle erstellt haben, müssen Sie diese Daten möglicherweise mit dem Bestell- oder Produktsuchsystem von WooCommerce integrieren. Zum Beispiel können Sie in der Produktenliste für Administratoren eine Spalte hinzufügen, die die Anzahl der abonnierten Nutzer anzeigt. Dafür können Sie folgende Methoden verwenden:manage_edit-product_columnsundmanage_product_posts_custom_columnFilter und Aktionen – in Kombination mit eigenen Datenbankabfragen – werden verwendet, um diese Funktion zu realisieren. Dies zeigt, wie externe Daten nahtlos in den Standard-Ablauf von WooCommerce integriert werden können.

Empfohlene Lektüre WooCommerce-Grundlegende Anleitung zur Website-Erstellung: Von Null eine hochkonvertierende E-Commerce-Website erstellen。

Zusammenfassungen

Die Entwicklung eines benutzerdefinierten Plugins für WooCommerce ist ein systematisches Projekt, das die Schritte von der Einrichtung der Umgebung, der Nutzung von Hooks, der Erstellung einer Verwaltungsoberfläche bis hin zum gegebenenfalls notwendigen Umgang mit benutzerdefinierten Daten umfasst. Der Schlüssel dazu liegt in einem tiefen Verständnis des Hook-Systems von WooCommerce – dieses ermöglicht es Ihnen, nahezu an jeder Stelle benutzerdefinierte Logiken einzufügen. Die Einhaltung der Kodierstandards von WordPress und WooCommerce sowie die Erstellung von klar strukturiertem, sicherem und effizientem Code sind entscheidend, um sicherzustellen, dass das Plugin langfristig stabil bleibt, leicht zu warten ist und mit zukünftigen Versionen kompatibel ist. Durch die Anwendung der oben genannten Richtlinien werden Sie in der Lage sein, leistungsstarke und professionelle Erweiterungen für Ihr E-Commerce-System zu entwickeln, die den spezifischen Geschäftsanforderungen entsprechen.

FAQ Häufig gestellte Fragen

Welche Vorkenntnisse sind erforderlich, um ein WooCommerce-Plugin für ### zu entwickeln?
Sie müssen sich mit den Grundlagen der PHP-Programmiersprache sowie den Konzepten des Objektorientierens vertraut machen. Zudem ist es unerlässlich, die Kernmechanismen von WordPress wie Hooks, Filters und Actions gut zu verstehen. Kenntnisse der grundlegenden Technologien HTML, CSS und JavaScript werden Ihnen bei der Entwicklung von interaktiven Frontend-Funktionen helfen. Ein gutes Verständnis der grundlegenden Datenstrukturen von WooCommerce – wie Bestellungen, Produkte, Gutscheine und Benutzer – erleichtert den Entwicklungsprozess erheblich.

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

Wie kann ich sicherstellen, dass meine benutzerdefinierten Plugins mit zukünftigen Versionen von WooCommerce kompatibel sind?

Die Einhaltung der offiziellen Entwicklungsstandards und bewährter Praktiken ist eine vorrangige Bedingung. Vermeiden Sie direkte Änderungen an den Kerndateien von WooCommerce und erweitern Sie das System stets über die von der Entwicklungsabteilung bereitgestellten Hooks. Verwenden Sie in Ihrem Code keine mehr veralteten (deprecated) Funktionen oder Methoden und halten Sie sich stets über die Aktualisierungsberichte von WooCommerce auf dem Laufenden. Deklarieren Sie in Ihrem Plugin die aktuellste, getestete Version von WooCommerce. Testen Sie Ihr Plugin gründlich – insbesondere vor und nach wichtigen Updates von WooCommerce.

Kann ich auf alle APIs zugreifen, ohne die WooCommerce-Erweiterung gekauft zu haben?

Ja, die Kern-REST-API von WooCommerce ist nach der Installation standardmäßig aktiviert und bietet vollständige CRUD-Endpunkte für wichtige Datemodelle wie Bestellungen, Produkte und Kunden. Mit diesen APIs können Sie Lese- und Schreibvorgänge durchführen. Einige spezifische Funktionen oder benutzerdefinierte Endpunkte, die durch kostenpflichtige Erweiterungen (z. B. Abonnementsdienste oder Mitgliedschaftssysteme) bereitgestellt werden, sind jedoch möglicherweise nur nach Aktivierung der entsprechenden Erweiterungen über die API zugänglich. Die Berechtigungen für die Nutzung der Kern-API werden durch das Benutzerrollen- und Berechtigungssystem von WordPress gesteuert.

Welche nützlichen Tools gibt es beim Debuggen von WooCommerce-Plugins?

Zuerst stellen Sie sicher, dass die Debugging-Modi von WordPress aktiviert sind. Das bedeutet, Sie müssen die entsprechenden Einstellungen in der WordPress-Konfiguration aktivieren.wp-config.phpEinstellungen in der Mittedefine(‘WP_DEBUG’, true);Die Fehler und Warnungen werden entweder auf dem Bildschirm angezeigt oder in die Protokolle aufgezeichnet. Verwenden Sie die Entwicklertools Ihres Browsers (Taste F12), um das Frontend-JavaScript sowie die AJAX-Anfragen zu überprüfen und zu debuggen. Für die Nachverfolgung der Codelogik können Sie Plugins wie “Query Monitor” installieren – diese helfen Ihnen dabei, Datenbankabfragen, die Ausführung von “Hooks” sowie Leistungsschwachstellen zu analysieren. Bei komplexen Transaktionsprozessen ist es ebenfalls sehr wichtig, die Protokolldateien von WooCommerce zu überprüfen (sie befinden sich im WordPress-Administrationsbereich unter “Status” > „Protokolle“).