WooCommerce-Plugin-Entwicklungshandbuch: Erstellen Sie Ihren eigenen Online-Shop

In der heutigen, stark wettbewerbsintensiven E-Commerce-Umgebung reicht ein standardmäßiger WooCommerce-Shop oft nicht aus, um alle Geschäftsanforderungen zu erfüllen. Egal ob es um individuelle Zahlungsprozesse, spezielle Frachtkalkulationsregeln oder eine tiefe Integration mit Drittsystemen geht – es ist immer notwendig, die Kernfunktionen des Shops zu erweitern. Genau darin liegt der Wert der Entwicklung von benutzerdefinierten Plugins. Durch das Schreiben eigener Plugins können Sie die Funktionalitäten Ihres Shops genau an Ihre Bedürfnisse anpassen. WooCommerce Mit den Plugins erhalten Sie die volle Kontrolle, um ein einzigartiges Einkaufserlebnis zu schaffen und unüberwindbare wirtschaftliche Barrieren aufzubauen.

Konfiguration der Entwicklungsumgebung für WooCommerce-Plugins

Bevor Sie mit der Entwicklung beginnen, ist eine stabile, isolierte lokale Entwicklungsumgebung unerlässlich. Sie schützt nicht nur Ihre Online-Daten, sondern erleichtert auch das Debuggen und Testen.

Einrichtung einer lokalen WordPress-Umgebung

Es wird empfohlen, Tools wie Local by Flywheel, XAMPP oder MAMP zu verwenden, um schnell eine lokale Entwicklungsumgebung aufzubauen. Stellen Sie sicher, dass Ihre Umgebung die erforderlichen Anforderungen erfüllt. WooCommerce Die Mindestanforderungen sind: PHP 7.2 oder eine höhere Version, MySQL 5.6 oder eine höhere Version sowie die neueste Version von WordPress. Nach der Installation von WordPress sollten Sie die entsprechenden Plugins aus dem offiziellen Plugin-Verzeichnis herunterladen und aktivieren. WooCommerce Es wird sehr hilfreich für die Entwicklung sein, wenn Sie die Plugins installieren und ihren initialen Setup-Assistenten durchführen sowie Beispieldaten importieren.

Empfohlene Lektüre WooCommerce-Handbuch zur Entwicklung und Leistungsoptimierung von E-Commerce-Websites。

Erstellen der grundlegenden Struktur eines Plugins

eine WooCommerce Zunächst einmal handelt es sich um ein standardmäßiges WordPress-Plugin. wp-content/plugins/ Erstellen Sie in dem Verzeichnis ein neues Verzeichnis, zum Beispiel… my-custom-woocommerceIn diesem Ordner erstellen Sie die Haupt-Plugin-Datei, die in der Regel nach dem Namen des Plugins benannt wird, zum Beispiel: my-custom-woocommerce.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

Dieses Hauptdatei muss die standardmäßigen WordPress-Plugin-Header-Informationen enthalten. Hier ist ein grundlegendes Beispiel:

<?php
/**
 * Plugin Name: My Custom WooCommerce
 * Plugin URI:  https://yourwebsite.com/
 * Description: 为 WooCommerce 商店添加自定义功能。
 * Version:     1.0.0
 * Author:      您的名字
 * Author URI:  https://yourwebsite.com/
 * License:     GPL v2 or later
 * Text Domain: my-custom-woocommerce
 * Domain Path: /languages
 * WC requires at least: 5.0.0
 * WC tested up to: 8.0.0
 */

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

// 检查 WooCommerce 是否已激活
if ( ! in_array( 'woocommerce/woocommerce.php', apply_filters( 'active_plugins', get_option( 'active_plugins' ) ) ) ) {
    add_action( 'admin_notices', function() {
        ?>
        <div class="notice notice-error">
            <p>“Das ”My Custom WooCommerce“-Plugin erfordert, dass WooCommerce bereits installiert und aktiviert ist.</p>
        </div>
        &lt;?php
    } );
    return;
}

Der Schlüsselpunkt liegt darin, dass verwendet wurde. WC requires at least und WC tested up to Header information is used to declare and... WooCommerce Die Kompatibilität und die Überprüfung im Code… WooCommerce Ob es aktiviert wurde.

Core Extension Methods: Action and Filter Hooks

WooCommerce Die Stärke dieses Systems liegt in seinem hoch skalierbaren Hook-System. Das Verständnis sowie die geschickte Anwendung von Action-Hooks und Filter-Hooks sind die Grundlagen für eine individuelle, maßgeschneiderte Entwicklung.

Mithilfe von Aktionshaken (Action Hooks) in den Prozess eingreifen

Action Hooks ermöglichen es Ihnen, WooCommerce Sie können zu einem bestimmten Zeitpunkt während der Ausführung Ihren eigenen Code einfügen. Zum Beispiel möchten Sie eine benutzerdefinierte Aktion ausführen (z. B. eine Aufruf einer externen API), nachdem ein Benutzer einen Auftrag abgegeben hat.

Empfohlene Lektüre Praktischer Leitfaden zur Entwicklung von WordPress-Plugins: Erstellen Sie Ihr erstes funktionales Plugin von Grund auf.。

Sie können die woocommerce_thankyou Der „Hook“ wird auf der Bestell-Danksagungsseite ausgelöst. Oder man kann auch einen allgemeineren Ansatz verwenden. woocommerce_checkout_order_processedEs wird ausgelöst, sobald die Bearbeitung der Bestellung abgeschlossen ist.

add_action( 'woocommerce_checkout_order_processed', 'my_custom_order_action', 10, 3 );

function my_custom_order_action( $order_id, $posted_data, $order ) {
    // 获取订单对象（如果未提供）
    if ( ! $order instanceof WC_Order ) {
        $order = wc_get_order( $order_id );
    }

// 执行您的自定义逻辑，例如记录日志或发送请求
    $logger = wc_get_logger();
    $logger->info( '订单 #' . $order_id . ' 已创建，开始执行自定义任务。', array( 'source' => 'my-custom-plugin' ) );

// 调用外部 API 示例（伪代码）
    // $response = wp_remote_post( 'https://api.example.com/notify', $args );
}

Daten mithilfe von Filter-Hooks ändern

Die Filter-Hooks ermöglichen es Ihnen, Änderungen vorzunehmen. WooCommerce Die übertragenen Daten. Zum Beispiel möchten Sie allen Warenpreisen eine feste Gebühr hinzufügen.

Sie können die woocommerce_product_get_price Filter. Dieser Hook ist sehr mächtig, sollte aber mit Vorsicht verwendet werden, da er die Anzeige aller Preise beeinflusst.

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

add_filter( 'woocommerce_product_get_price', 'my_custom_price_adjustment', 10, 2 );

function my_custom_price_adjustment( $price, $product ) {
    // 只在前端购物车和商品页面应用，避免影响后台
    if ( is_admin() && ! defined( 'DOING_AJAX' ) ) {
        return $price;
    }

// 假设增加 5 元手续费
    $fee = 5;
    $new_price = $price + $fee;

return $new_price;
}

Benutzerdefinierte Warenarten und Datenverarbeitung

WooCommerce Standardmäßig werden einfache Produkte sowie variablen Produkte unterstützt. Manchmal ist es jedoch notwendig, neue Produkttypen zu erstellen – beispielsweise “Reservierbare Produkte” oder “Dienstleistungsprodukte”.

Neue Warenarten registrieren

Die Erstellung eines neuen Produkttyps umfasst mehrere Schritte. Zunächst müssen Sie diesen Typ registrieren. Dies erfolgt in der Regel… init Die Aktion oder das Plugin wird beim Laden abgeschlossen.

add_action( 'init', 'register_my_custom_product_type' );

function register_my_custom_product_type() {
    class WC_Product_Custom extends WC_Product {
        public function __construct( $product ) {
            parent::__construct( $product );
            $this->product_type = 'custom';
        }

// 您可以在这里重写父类方法，或添加新方法
        public function get_type() {
            return 'custom';
        }

// 示例：自定义“添加到购物车”按钮文本
        public function add_to_cart_text() {
            return __( '预约服务', 'my-custom-woocommerce' );
        }
    }
}

Anschließend müssen Sie diesen Typ mithilfe eines Filters in die Auswahlliste der Produkttypen hinzufügen.

Empfohlene Lektüre Einfach eine benutzerdefinierte Produktseite für WooCommerce erstellen – von der Grundlage bis zur Meisterschaft。

add_filter( 'product_type_selector', 'add_custom_product_type_to_dropdown' );

function add_custom_product_type_to_dropdown( $types ) {
    $types['custom'] = __( '自定义服务', 'my-custom-woocommerce' );
    return $types;
}

Hinzufügen von benutzerdefinierten Feldern für Waren

Für neue Produkttypen sind in der Regel zusätzliche Datenelemente erforderlich. Dies kann durch… WooCommerce Die Produktdatenbox (Metabox) wird dazu verwendet, Produktinformationen darzustellen und zu verwalten. woocommerce_product_options_general_product_data Fügen Sie Felder zu der Aktion hinzu und verwenden Sie diese anschließend. woocommerce_process_product_meta Speichern Sie die Aktionen.

add_action( 'woocommerce_product_options_general_product_data', 'add_custom_product_fields' );

function add_custom_product_fields() {
    global $product_object;

echo '<div class="options_group show_if_custom">'; // `show_if_custom` 仅对“custom”类型显示

woocommerce_wp_text_input( array(
        'id'          =&gt; '_service_duration',
        'label'       =&gt; __( '服务时长 (小时)', 'my-custom-woocommerce' ),
        'desc_tip'    =&gt; true,
        'description' =&gt; __( '请输入完成此服务预计需要的小时数。', 'my-custom-woocommerce' ),
        'type'        =&gt; 'number',
        'custom_attributes' =&gt; array(
            'step' =&gt; '0.5',
            'min'  =&gt; '0.5'
        )
    ) );

echo '</div>';
}

// 保存字段
add_action( 'woocommerce_process_product_meta', 'save_custom_product_fields' );

function save_custom_product_fields( $post_id ) {
    $product = wc_get_product( $post_id );
    if ( $product-&gt;get_type() === 'custom' ) {
        $duration = isset( $_POST['_service_duration'] ) ? sanitize_text_field( $_POST['_service_duration'] ) : '';
        $product-&gt;update_meta_data( '_service_duration', $duration );
        $product-&gt;save_meta_data();
    }
}

Interaktion mit dem Warenkorb und dem Bezahlprozess

Der Warenkorb und der Bezahlvorgang sind die Kernkomponenten des E-Commerce.WooCommerce Hier stehen zahlreiche Hooks zur Verfügung, um Anpassungen vorzunehmen.

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

Ändern der Verhalten der Warenkorb-Elemente

Sie können dies tun, indem Sie woocommerce_add_cart_item_data Der Filter fügt bei der Hinzufügung eines Produkts zum Warenkorb benutzerdefinierte Daten hinzu. Zum Beispiel wird für Produkte der Kategorie “Benutzerdefinierte Dienstleistungen” ein Termin für die Buchung hinzugefügt.

add_filter( 'woocommerce_add_cart_item_data', 'add_custom_data_to_cart_item', 10, 3 );

function add_custom_data_to_cart_item( $cart_item_data, $product_id, $variation_id ) {
    $product = wc_get_product( $product_id );
    if ( $product->get_type() === 'custom' && isset( $_POST['appointment_date'] ) ) {
        $cart_item_data['appointment_date'] = sanitize_text_field( $_POST['appointment_date'] );
        // 确保每个有不同预约日期的商品都被视为独立项目
        $cart_item_data['unique_key'] = md5( microtime() . rand() );
    }
    return $cart_item_data;
}

Danach können Sie es verwenden. woocommerce_get_item_data Die Filter zeigen diese benutzerdefinierten Daten auf der Warenkorb- und der Kasse-Seite an.

Benutzerdefinierte Abrechnungsfelder

Das Hinzufügen oder Ändern von Bezahlungsfeldern ist sehr üblich. woocommerce_checkout_fields Die Implementierung eines Filters ist ganz einfach möglich.

add_filter( 'woocommerce_checkout_fields', 'add_custom_checkout_field' );

function add_custom_checkout_field( $fields ) {
    $fields['billing']['billing_custom_vat'] = array(
        'label'       => __( '增值税号', 'my-custom-woocommerce' ),
        'placeholder' => _x( '请输入您的公司税号', 'placeholder', 'my-custom-woocommerce' ),
        'required'    => false, // 根据业务需求调整
        'class'       => array( 'form-row-wide' ),
        'clear'       => true,
        'priority'    => 35, // 控制字段顺序
    );
    return $fields;
}

Um den Wert dieses Feldes im Auftrag zu speichern, muss man Folgendes verwenden: woocommerce_checkout_update_order_meta Aktion.

add_action( 'woocommerce_checkout_update_order_meta', 'save_custom_checkout_field' );

function save_custom_checkout_field( $order_id ) {
    if ( ! empty( $_POST['billing_custom_vat'] ) ) {
        update_post_meta( $order_id, '_billing_custom_vat', sanitize_text_field( $_POST['billing_custom_vat'] ) );
    }
}

Zusammenfassungen

WooCommerce Die individuelle Entwicklung von Plugins ist ein systematisches Projekt, das mit dem Verständnis ihrer Architektur beginnt. Von der Einrichtung der richtigen Entwicklungsumgebung über die Erstellung eines plattformkonformen Plugin-Skeletts bis hin zum tiefgreifenden Eingreifen in das Hook-System (Aktionen und Filter) zur Modifizierung der Kernprozesse – jedes Schritt ist die Grundlage für die Entwicklung einzigartiger Funktionen. Durch die Erstellung benutzerdefinierter Warenarten und Metadatenfelder können Sie das Datenmodell erweitern, um anspruchsvolle Geschäftsanforderungen zu erfüllen. Schließlich können Sie durch geschickte Integration von Interaktionen und Daten in den Warenkorb- sowie Abrechnungsprozessen die Benutzererfahrung und die Betriebseffizienz direkt verbessern. Befolgen Sie stets die besten Praktiken: Durchführen Sie umfassende Tests, stellen Sie die Sicherheit des Codes sicher, halten Sie gute Dokumentationen aufrecht und achten Sie auf… WooCommerce Sie sollten die Updates des WordPress-Kerns ebenfalls installieren, um sicherzustellen, dass die von Ihnen entwickelten Plugins stabil, effizient und langlebig sind.

FAQ Häufig gestellte Fragen

Welche Vorkenntnisse sind erforderlich, um ein WooCommerce-Plugin zu entwickeln?

Die Entwicklung von WooCommerce-Plugins erfordert eine solide Grundlage in der PHP-Programmierung sowie ein gutes Verständnis der Konzepte der objektorientierten Programmierung (OOP). Zudem ist ein tiefes Wissen über die Kernmechanismen von WordPress erforderlich – einschließlich des Hook-Systems (Aktionen und Filter), benutzerdefinierter Artikeltypen, Metadaten sowie der Standardstrukturen von Plugins und Themes. Ein Grundverständnis von HTML, CSS und JavaScript ist ebenfalls hilfreich für die Gestaltung der Benutzeroberfläche.

Wie fügt man Probleme in einem selbst erstellten WooCommerce-Plugin hinzu?

Zunächst stellen Sie sicher, dass auf wp-config.php Die Funktion wurde im File aktiviert. WP_DEBUG und WP_DEBUG_LOGFühren Sie die Fehlerprotokollierung in einer Log-Datei durch. Zweitens sollten Sie diese Log-Dateien voll und ganz ausnutzen. WooCommerce Das integrierte Log-System… wc_get_logger() Die Funktion protokolliert Informationen an wichtigen Punkten. Bei Problemen auf der Frontend-Seite sollten Sie die Entwicklerwerkzeuge des Browsers (Console und Netzwerk-Panel) verwenden, um die Ursache zu untersuchen. Zudem können Sie andere Plugins vorübergehend deaktivieren und auf das Standard-Thema wechseln, um mögliche Konflikte auszuschließen.

Ich habe den Preisfilter geändert – warum haben sich auch die Preise in der Liste der Produkte im Backend verändert?

Das ist ein häufiges Problem: Viele preisbezogene Filter wirken sowohl auf die Frontend- als auch auf die Backend-Systeme. Um dies zu vermeiden, müssen Sie in den Filterfunktionen mithilfe von Bedingungen den Anwendungsbereich der Filter einschränken. Dies wird in der Regel so gehandhabt… is_admin() && ! defined( 'DOING_AJAX' ) Wir müssen überprüfen, ob sich der Benutzer derzeit in der Administraturoberfläche befindet und keine AJAX-Anfragen ausführt – schließlich werden Aktionen wie die Aktualisierung des Warenkorbs über AJAX abgewickelt, wobei dabei Preisberechnungen erforderlich sind. In den vorherigen Beispielen haben wir bereits diese Vorgehensweise demonstriert.

Was soll ich tun, wenn die benutzerdefinierten Warenarten in der Bestellung als “Einfache Waren” angezeigt werden?

Das liegt daran, dass… WooCommerce Beim Speichern von Produktabbildungen in einer Bestellung kann es vorkommen, dass Ihre benutzerdefinierten Typen standardmäßig nicht korrekt erkannt werden. Sie müssen sicherstellen, dass die Typeninformationen des Produkts beim Hinzufügen zum Warenkorb korrekt übertragen werden. Überprüfen Sie daher Ihre Einstellungen bzw. die Datenverarbeitungsmethoden. WC_Product_Custom Hat die Klasse die Erbfolge korrekt übernommen? WC_Product Und es wurde auch eingerichtet. $this->product_typeDarüber hinaus, wenn die Waren aus einem Auftrag abgeholt werden…WooCommerce Es könnte ein grundlegendes Objekt instanziiert werden. WC_Product Objekt. Um eine korrekte Instanzierung zu gewährleisten, könnten Sie möglicherweise die folgenden Schritte ausführen: woocommerce_order_get_items Filter, um Ihre benutzerdefinierten Typen zu mappen.

Wie kann ich sicherstellen, dass meine benutzerdefinierte Erweiterung mit zukünftigen Updates von WooCommerce kompatibel ist?

Der Schlüssel zur Beibehaltung der Kompatibilität besteht darin, mit den offiziellen Entwicklungspraktiken Schritt zu halten. Verwenden Sie immer… WooCommerce Offene APIs und Hooks sollten verwendet werden, um direkte Änderungen an Kerndateien oder die Nutzung nicht öffentlicher Klassen und Methoden zu vermeiden. In den Plugin-Hauptinformationen sollte die Kompatibilität genau angegeben werden. WooCommerce VersionWC tested up toRegelmäßig… WooCommerce Die Tests werden auf der Testversion oder der neuesten Version durchgeführt. Folgen Sie den Entwicklungen. WooCommerce Auf dem offiziellen Entwicklungsblog sowie im Update-Log können Sie sich über Funktionen informieren, die bald nicht mehr unterstützt werden, sowie über neue APIs.