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

3-Minuten-Lesung
2026-03-16
2026-06-04
2,727
Ich bekomme eine Provision, wenn du über die untenstehenden Links einkaufst – ohne zusätzliche Kosten für dich.

WooCommerce-Installation und Grundkonfiguration

Der Installationsprozess von WooCommerce ist zwar einfach, aber eine korrekte Initialkonfiguration ist die Grundlage für den Aufbau eines stabilen E-Commerce-Websites. Zunächst benötigen Sie eine Serverumgebung, die PHP 7.4 oder eine höhere Version ausführt und in der WordPress installiert ist. Melden Sie sich im WordPress-Backend an, gehen Sie auf die Seite “Plugins” > “Plugins installieren”, suchen Sie nach “WooCommerce” und installieren Sie es. Nach der Installation wird automatisch der “Einstellungsassistent” gestartet, der Sie durch die grundlegenden Einstellungen Ihres Shops führt.

Im Einrichtungsassistenten müssen Sie nacheinander folgende Schritte ausführen: Festlegen des Standorts, der Währung und der Einheiten für Ihren Shop; Konfigurieren der Zahlungsmethoden (z. B. PayPal, Stripe oder Banküberweisung); Festlegen der Regeln für die Berechnung der Versandkosten (z. B. kostenloser Versand, feste Versandkosten oder Echtzeitgebühren basierend auf Gewicht/Adresse); und Empfehlen der Installation einiger erforderlicher Erweiterungen, wie z. B. WooCommerce Payments oder Lokalisierungs-Plugins. Nachdem Sie den Assistenten abgeschlossen haben, gelangen Sie zum Haupt-Einstellungspanel von WooCommerce. Hier müssen Sie einige wichtige Bereiche sorgfältig konfigurieren: Im Abschnitt “Allgemein” können Sie den Verkaufsstandort und die Steuerberechnung festlegen; Im Abschnitt “Produkte” können Sie Maßeinheiten, Produktbewertungen und Bestandsverwaltung definieren; Auf der Seite “Kasse” konfigurieren Sie alle Zahlungs-Gateways und den Checkout-Prozess; Und im Abschnitt “Versand” verwalten Sie die Versandzonen, -methoden und -verpackungen.

Ein oft übersehener, aber entscheidender Schritt ist die Konfiguration der Permanenzen. In den “Einstellungen” von WordPress unter “Permanente Links” sollten Sie sicherstellen, dass nicht die “Einfache”-Struktur verwendet wird. Es wird empfohlen, die “Artikelbezeichnung” oder eine benutzerdefinierte Struktur zu verwenden – dies verbessert die SEO-Ergebnisse der Produktseiten. Außerdem müssen Sie auf der Registerkarte “Erweitert” der WooCommerce-Einstellungen den entsprechenden WordPress-Seiten für verschiedene Seiten wie Warenkorb, Zahlung und Mein Konto zuweisen. Diese Seiten wurden beim Installieren des Plugins automatisch erstellt.

Empfohlene Lektüre WooCommerce-Customisierungs-Entwicklungshandbuch: Ein umfassendes Praxislehrbuch von der Grundlage bis zur Fortgeschrittenen Stufe

Einstellungen der grundlegenden Ladeninformationen

Die Einstellungen der grundlegenden Informationen Ihres Shops finden hauptsächlich im WordPress Customizer sowie in den Standardeinstellungen von WooCommerce statt. Stellen Sie sicher, dass die Shop-Adresse, die E-Mail-Adresse für den Kundenservice und die Telefonnummer korrekt sind – diese Informationen werden in Bestellbenachrichtigungen, Rechnungen sowie im Fußbereich der Webseite angezeigt. Darüber hinaus können Sie in den “Standardeinstellungen” unter “Währungsoptionen” die Darstellung der Währung festlegen, beispielsweise „Renminbi (¥123,00)“ oder „US-Dollar ($123,00)“.

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.

Integration von Zahlungs- und Lieferungs-Gateways

Payment gateways sind die Lebensader des E-Commerce. WooCommerce bietet eine Vielzahl von integrierten Zahlungsmöglichkeiten an, wie zum Beispiel… WC_Gateway_BACS(Banküberweisung)WC_Gateway_CHEQUE(Betrag per Scheck) und WC_Gateway_COD(„Bezahlung bei Lieferung“). Um fortschrittliche Zahlungsgateways wie Stripe oder PayPal zu aktivieren, ist es in der Regel notwendig, separate Plugins zu installieren und die API-Schlüssel zu konfigurieren. Beim Konfigurieren von Stripe müssen Sie beispielsweise den öffentlichen Schlüssel sowie den privaten Schlüssel auf der entsprechenden Einstellungsseite eingeben.

Die Versandeinstellungen sind genauso wichtig. Sie können in der Rubrik “Versandgebiete” separate Versandkostenregeln für verschiedene Länder oder Regionen erstellen. Zum Beispiel können Sie für das chinesische Festland ein eigenes Versandgebiet definieren und verschiedene Optionen wie “kostenloser Versand”, “eine einheitliche Versandgebühr” oder “Abholung vor Ort” hinzufügen. woocommerce_shipping_init Entwickler können sogar völlig benutzerdefinierte Klassen für die Zustellmethoden erstellen.

Kernfunktionen und Datenverwaltung

WooCommerce integriert alle E-Commerce-Daten in die benutzerdefinierten Artikeltypen und Kategorien von WordPress. Die Produkte werden dabei gespeichert als… product Artikeltypen, während Bestellungen entsprechend… shop_order Art des Artikels: Das Verständnis dieses Datemodells ist eine Voraussetzung für die Durchführung fortgeschrittener, benutzerdefinierter Entwicklungen.

Produktmanagement ist das A und O. WooCommerce unterstützt vier Arten von Produkten:simple(Einfache Produkte)grouped(Gruppierte Produkte)external(Externe/Verknüpfte Produkte) und variable(Variable Produkte): Variable Produkte ermöglichen es Ihnen, für denselben Artikel verschiedene Eigenschaften (z. B. Farbe, Größe) sowie die entsprechenden Preise, Bestände und SKU-Werte einzustellen. Beim Editieren von Produkten im Hintergrund stehen Ihnen eine Reihe von Metadatenfeldern zur Verfügung, mit denen Sie den Bestand, die Preise, den Bestandsstatus, die Lieferinformationen sowie die zugehörigen Produktbilder verwalten können.

Empfohlene Lektüre Was ist WooCommerce und welche ist seine Kernarchitektur?

Die Bestellverwaltungs-Software bietet eine umfassende Übersicht über die Verkäufe. Jede Bestellung enthält umfangreiche Metadaten. shop_order Die Beiträge enthalten Informationen zu den Kunden, den gekauften Produkten, den Preisen, dem Zahlungszustand sowie der Historie der Bestellnotizen. Die Verwaltung des Status ist von großer Bedeutung; die Standardzustände umfassen: pending(Wartend auf die Zahlung)processing(Bearbeitung in Progress)on-hold(Pause) Und completed(Fertiggestellt.) Sie können es jetzt verwenden. wc_get_order_statuses Die Funktion erhält alle Statuswerte und verarbeitet sie anschließend. woocommerce_register_shop_order_post_statuses Filter registrieren einen benutzerdefinierten Status.

Produkttyp- und Attributverwaltung

Produktattribute sind ein wertvolles Werkzeug zur Organisation komplexer Warenkataloge. Sie können globale Attribute wie “Farbe” oder “Größe” in “Produkt” > “Attribute” erstellen. Anschließend können Sie diese Attribute bei der Bearbeitung variabler Produkte verwenden, um “Attributekombinationen” zu erstellen, und für jede Kombination (z. B. “Rot – Groß”) separate Variantendaten festlegen. Auf der Codeebene ist dies durch… WC_Product_Variable Klassen und ihre… get_available_variations() Methoden zur Abrufung und Verarbeitung aller Variableninformationen.

Verarbeitung von Bestellungen und Kundendaten

WooCommerce verwendet WC_Order Eine Klasse wird verwendet, um Bestelldaten zu verpacken. Mithilfe dieser Klasse können Sie Bestellungen programmatisch erstellen oder aktualisieren. Zum Beispiel zeigt der folgende Code, wie man eine neue Bestellung erstellt und Waren hinzufügt:

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%
// 创建一个新订单对象
$order = wc_create_order();

// 通过商品ID获取商品对象并添加到订单中
$product = wc_get_product(123);
$order->add_product($product, 2); // 数量为2

// 设置客户地址
$order->set_address(array(
    'first_name' => '张',
    'last_name'  => '三',
    'email'      => '[email protected]',
    'phone'      => '13800138000',
), 'billing');

// 计算总额并保存
$order->calculate_totals();
$order->save();

Die Kundendaten werden mit den WordPress-Usern in Verbindung gebracht.WP_UserTiefe Bindung: WooCommerce nutzt dazu… wc_get_customer_order_count und wc_get_customer_total_spent Funktionen wie diese erweitern die Fähigkeiten der Benutzer.

Thema-Integration und Vorlagenüberwrite

Die Integrationsstärke von WooCommerce mit dem verwendeten Theme bestimmt das Erscheinungsbild des Shops auf der Benutzeroberfläche. Durch sein leistungsfähiges Template-System befinden sich alle Dateien, die auf der Benutzeroberfläche angezeigt werden (z. B. Produktlisten, Produktseiten, Warenkörbe), im Verzeichnis der Plugins. /templates/ Im Ordner befinden sich die entsprechenden Vorlagen. Um diese Vorlagen ohne Änderung der Kern-Plugin-Dateien anzupassen, müssen Sie sie in Ihr eigenes Thema übertragen (d.h. sie dort ersetzen).

Die richtige Methode ist: Erstellen Sie in Ihrem Verzeichnis mit den Themen Ihrer Veranstaltungen ein Verzeichnis mit dem Namen… woocommerce Die entsprechende Ordnerstruktur erstellen. Anschließend kopieren Sie die WooCommerce-Vorlagen-Dateien, die Sie ändern möchten, aus dem Plugin-Verzeichnis in diesen neuen Ordner und führen die Änderungen an dieser Kopie durch. Zum Beispiel, um die Struktur einer einzelnen Produktseite zu ändern, müssen Sie die entsprechenden Dateien aus dem Plugin-Verzeichnis in den neuen Ordner kopieren und dort die gewünschten Anpassungen vornehmen. plugins/woocommerce/templates/single-product.php bis themes/your-theme/woocommerce/single-product.phpWooCommerce lädt zuerst die Template-Dateien aus dem verwendeten Theme.

Empfohlene Lektüre Die ultimative Anleitung zur Einrichtung von WooCommerce: Bauen Sie Ihr E-Commerce-Imperium von Grund auf auf.

Neben der Übernahme des gesamten Inhalts eines Files können Sie auch Action-Hooks und Filter-Hooks verwenden, um an bestimmten Stellen Inhalte einzufügen oder zu ändern.woocommerce_before_single_product_summary Der Hook wird vor den Produktzusammenfassungsangaben ausgeführt und stellt daher den idealen Ort dar, um benutzerdefinierte Bannerwerbung einzufügen.

Struktur der benutzerdefinierten Vorlagendateien

Die Template-Dateien von WooCommerce verfügen über eine klare Hierarchie. Nehmen wir beispielsweise die Produktsammlung („Product Loop“) als Beispiel:archive-product.php Es handelt sich um ein Template für die Hauptseite eines Ladens, das bestimmte Funktionen aufrufen wird. content-product.php Um jedes Produkt anzuzeigen, werden diese Dateien verwendet. Durch das Überschreiben dieser Dateien können Sie die Darstellung der Produkte in der Liste vollständig ändern – beispielsweise indem Sie das Layout in ein Raster oder eine Liste umwandeln oder benutzerdefinierte Embleme hinzufügen.

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.

Funktionaler Erweiterung durch die Verwendung von Hooks

Hooks sind die “Rückgrat” von WooCommerce-Erweiterungen. Aktionshooks ermöglichen es Ihnen, Code auszuführen – beispielsweise um nach der Warenkorb-Tabelle ein benutzerdefiniertes Informationsfeld hinzuzufügen.

add_action('woocommerce_after_cart_table', 'my_custom_cart_message');
function my_custom_cart_message() {
    echo '<div class="custom-notice">Ab einem Einkauf von 500 Yuan erhalten Sie kostenlosen Versand!</div>';
}

Filter-Hooks ermöglichen es Ihnen, Daten zu “ändern”. Zum Beispiel können Sie damit… woocommerce_add_to_cart_fragments Die Filter können den Inhalt des Mini-Warenkorbs dynamisch aktualisieren:

add_filter('woocommerce_add_to_cart_fragments', 'update_mini_cart_count');
function update_mini_cart_count($fragments) {
    $fragments['div.cart-count'] = '<div class="cart-count">' . WC()-&gt;cart-&gt;get_cart_contents_count() . '</div>';
    return $fragments;
}

Advanced Customization and Development Practices

Wenn die integrierten Funktionen und Schnittstellen die Anforderungen nicht erfüllen können, ist eine tiefgreifendere Anpassung des Systems erforderlich. Dazu gehört die Erstellung benutzerdefinierter Produkttypen, die Entwicklung eigener Zahlungs- oder Liefergateways sowie die Integration mit externen Systemen über REST-APIs.

Um benutzerdefinierte Produkttypen zu erstellen, ist eine Erweiterung erforderlich. WC_Product Klasse. Zunächst müssen Sie eine neue Klasse definieren, die von dieser Klasse erbt, und diesen Produkttyp registrieren. Zum Beispiel erstellen Sie eine Produktklasse mit dem Namen “Reservierung”:

class WC_Product_Booking extends WC_Product {
    public function __construct($product) {
        parent::__construct($product);
        $this->product_type = 'booking';
    }
    // 在这里添加自定义方法和属性,如 get_booking_dates()
}
// 将新类注册到工厂
add_filter('woocommerce_product_class', 'register_booking_product_class', 10, 2);
function register_booking_product_class($classname, $product_type) {
    if ($product_type == 'booking') {
        $classname = 'WC_Product_Booking';
    }
    return $classname;
}

Die WooCommerce REST API bietet eine leistungsstarke Schnittstelle für mobile Anwendungen oder externe Verwaltungssysteme. Mit der API können Sie nahezu alle Daten wie Produkte, Bestellungen und Kunden verwalten. Um auf die API zuzugreifen, müssen Sie diese zunächst im Backend unter “WooCommerce” > “Einstellungen” > “Erweitert” > “Alte API” aktivieren und einen API-Schlüssel (Consumer Key & Consumer Secret) erstellen. Anschließend können Sie Anfragen an die API mit Endpunkten wie den folgenden senden:GET /wp-json/wc/v3/products Um die Produktenliste zu erhalten.

Die Entwicklung eines benutzerdefinierten Gateways

Ein benutzerdefinierter Zahlungsgateway ist eine Erweiterung eines Standard-Zahlungsgateways, die zusätzliche Funktionen und Sicherheitsmechanismen bietet. WC_Payment_Gateway Sie benötigen eine PHP-Klasse für ein Gateway. In dieser Klasse müssen Sie die ID des Gateways, den Titel, die Beschreibung sowie die Zahlungsfelder definieren und die entsprechenden Funktionen implementieren. process_payment Methoden werden verwendet, um die Zahlungslogik umzusetzen. Nach Abschluss der Entwicklung muss dies überprüft werden. woocommerce_payment_gateways Der Filter fügt es der Liste der verfügbaren Gateways hinzu.

API-Integration mit externen Diensten

WooCommerce bietet eine Vielzahl von Hooks, um mit ERP-, CRM- oder Logistiksystemen zu integrieren. Zum Beispiel wird ein Hook ausgelöst, wenn der Status eines Auftrags auf “Abgeschlossen” geändert wird. woocommerce_order_status_completed Aktionshook: Sie können eine Funktion an diesen Hook binden, um die Bestelldaten in Ihr Lagerverwaltungssystem zu übertragen.

add_action('woocommerce_order_status_completed', 'sync_order_to_erp');
function sync_order_to_erp($order_id) {
    $order = wc_get_order($order_id);
    $data = array(
        'order_id' => $order->get_id(),
        'total'    => $order->get_total(),
        // ... 准备其他数据
    );
    // 使用 wp_remote_post 将 $data 发送到外部 API
}

Zusammenfassungen

WooCommerce ist nicht nur ein Plugin, sondern auch ein umfassendes und hocherweiterbares E-Commerce-Entwicklungsframework. Von der einfachen Installation und Konfiguration bis hin zu tiefgehender individueller Anpassung bietet es Entwicklern durch ein klares Template-System, eine reiche Auswahl an Hooks (Actions & Filters) sowie ein objektorientiertes Datenmodell unendliche Möglichkeiten. Der Schlüssel zum Erfolg beim Aufbau eines WooCommerce-Shops liegt darin: Eine solide Grundkonfiguration, die einen stabilen Betrieb des Shops gewährleistet; ein tieferes Verständnis des Produkten- und Bestelldatenmodells; die geschickte Anwendung von Templates sowie Hooks für die Frontend-Anpassung; sowie die Fähigkeit, durch die Integration von benutzerdefinierten Klassen, Gateways und APIs individuelle Geschäftsanforderungen zu erfüllen. Indem Sie diese Best Practices befolgen, können Sie einen leistungsstarken, effizienten Online-Shop erstellen, der voll und ganz der Geschäftslogik entspricht.

FAQ Häufig gestellte Fragen

Wie kann ich den Text der Schaltfläche “In den Warenkorb legen” ändern?

Sie können die woocommerce_product_add_to_cart_text Filter oder woocommerce_product_single_add_to_cart_text Filter zur Änderung des Button-Textes. Zum Beispiel wird der Button-Text auf der Produktseite mit dem folgenden Code in “Sofort kaufen” geändert:

add_filter('woocommerce_product_single_add_to_cart_text', 'change_single_add_to_cart_text');
function change_single_add_to_cart_text() {
    return '立即购买';
}

Für die Archivseite (Produktliste) verwenden Sie bitte… woocommerce_product_add_to_cart_text Ein Filter muss verwendet werden, und innerhalb der Funktion muss der Produkttyp ermittelt werden.

Wie fügt man benutzerdefinierte Felder für eine bestimmte Produktkategorie hinzu?

Sie müssen die Produktkategorien-Hooks von WooCommerce mit der WordPress-Termin-Metadaten-API kombinieren. Zuerst verwenden Sie… product_cat_add_form_fields und product_cat_edit_form_fields Die Aktion fügt Felder auf der Seite zur Klassifizierung hinzugeben bzw. bearbeiten. Anschließend werden diese Felder verwendet. created_term und edit_term Tat: Die Feldwerte werden gespeichert. term_metaSchließlich können Sie dies in der Template-Datei verwenden. get_term_meta Um diesen Wert abzurufen und anzuzeigen.

Warum haben die Änderungen an meinem benutzerdefinierten Template keine Wirkung gezeigt?

Folgen Sie den folgenden Schritten zur Fehlerbehebung: Zuerst stellen Sie sicher, dass Sie die Template-Datei an den richtigen Ort im Thema-Verzeichnis kopiert haben:your-theme/woocommerce/ Zuerst müssen Sie die Dateien herunterladen und die Verzeichnisstruktur mit der des ursprünglichen Plugins vergleichen, um sicherzustellen, dass sie übereinstimmen. Anschließend sollten alle Caches gelöscht werden – einschließlich der Browser-Caches, der WordPress-Objekt-Caches sowie jeglicher Serverseiten-Caches (z. B. OPcache). Zum Schluss sollten Sie Ihr Theme überprüfen. functions.php Wurde die Unterstützung für WooCommerce korrekt deklariert?add_theme_support('woocommerce');Falls das Problem weiterhin besteht, versuchen Sie, vorübergehend auf das Standard-Thema (z. B. Storefront) zu wechseln, um mögliche Kompatibilitätsprobleme mit dem aktuellen Thema auszuschließen.

Wie erstellt man programmatisch ein variabels Produkt für WooCommerce?

Sie müssen WC_Product_Variable Klasse. Die grundlegenden Schritte sind: Erstellen eines Produktobjekts und Festlegen der grundlegenden Eigenschaften; Erstellen und Hinzufügen globaler Eigenschaften (z. B. Farben); Erstellen spezifischer Kombinationen dieser Eigenschaften (d. h. Varianten); Schließlich wird für jede Variante eine eigene Instanz des Produktobjekts erstellt. WC_Product_Variation Ein Objekt wird mit spezifischen Eigenschaften wie Preis und Lagerbestand versehen und anschließend mit dem Hauptprodukt verknüpft. Dies ist ein mehrschrittiger Prozess, der in der Regel folgende Schritte umfasst: wp_set_object_terms, set_attributes, und save usw.