WooCommerce-Test-Leitfaden

Dieser Leitfaden erklärt, wie Sie WooCommerce-Checkout-Flows mit Flowguard testen, ohne echte Bestellungen zu erstellen oder Ihre Shop-Daten zu verändern.

Bevor du beginnst

Aktiviere immer den Test Mode, bevor du WooCommerce-Flows testest! Ohne Test Mode werden echte Bestellungen erstellt, Lagerbestand verringert und E-Mails gesendet.

Immer das Flowguard Test Payment Gateway verwenden

Gib beim Testen von Checkout-Flows niemals echte Kreditkartendaten ein. Flowguard hat ein eigenes Test Payment Gateway, das eine erfolgreiche Zahlung simuliert — keine echten Transaktionen, keine Belastungen, keine externen Dienste. Es erscheint waehrend der Testausfuehrung automatisch als "Test Payment (Flowguard)" bei den Zahlungsmethoden. Waehle es einfach anstelle von Stripe, PayPal oder einem anderen Gateway.

Übersicht

Der Test Mode schützt Ihre WooCommerce-Umgebung beim Testen:

Schutz	Was es macht
Keine echten Bestellungen	Bestellungen werden in der Datenbank blockiert
Keine Zahlungsabbuchungen	Gateway-Anfragen werden abgefangen
Lagerbestandsschutz	Inventar bleibt unverändert
Gutscheinsicherheit	Nutzungszähler unberührt
Kundenkonten	Keine Testkonten erstellt
E-Mail-Verhinderung	E-Mails blockiert oder umgeleitet

Wie es funktioniert

Wenn der Test Mode aktiviert ist und ein Flow ausgeführt wird:

1. Bestellungserstellung blockiert: WooCommerce-Bestellungserstellungs-Hooks werden abgefangen
2. Datenbankabfragen verhindert: Direkte Datenbankeinträge in Bestellungstabellen werden blockiert
3. HPOS-Unterstützung: Kompatibel mit Legacy-wp_posts-Bestellungen und High-Performance Order Storage (HPOS)
4. Aktionen protokolliert: Alle verhinderten Aktionen werden in den Flow-Ergebnissen protokolliert

Test Mode einrichten

Test Mode aktivieren

1. Navigieren Sie zu Flowguard → Einstellungen → Test Mode
2. Aktivieren Sie den Test Mode-Schalter
3. Konfigurieren Sie die E-Mail-Behandlung (Blockieren oder an Testadresse umleiten)
4. Einstellungen speichern

E-Mail-Strategie

Wählen Sie, wie WooCommerce-E-Mails während Tests behandelt werden:

• Blockieren: E-Mails komplett verhindern (empfohlen)
• Umleiten: Alle E-Mails stattdessen an eine Test-E-Mail-Adresse senden

WooCommerce-Flows erstellen

Verwenden Sie Standard-Flowguard-Steps, um Ihre WooCommerce-Test-Flows zu erstellen:

Beispiel-Flow: Vollständiger Checkout

1. Seite öffnen
   - URL: https://ihreseite.de/produkt/testprodukt

2. Klicken (In den Warenkorb)
   - Selektor: button[name="add-to-cart"]

3. Warten
   - Zeit: 1000

4. Klicken (Warenkorb anzeigen)
   - Selektor: .cart-button

5. Klicken (Zur Kasse)
   - Selektor: .checkout-button

6. Text eingeben (Vorname)
   - Selektor: #billing_first_name
   - Wert: Max

7. Text eingeben (Nachname)
   - Selektor: #billing_last_name
   - Wert: Mustermann

8. Text eingeben (E-Mail)
   - Selektor: #billing_email
   - Wert: test@beispiel.de

9. Text eingeben (Adresse)
   - Selektor: #billing_address_1
   - Wert: Teststraße 123

10. Text eingeben (Stadt)
    - Selektor: #billing_city
    - Wert: Teststadt

11. Text eingeben (Postleitzahl)
    - Selektor: #billing_postcode
    - Wert: 12345

12. Text eingeben (Telefon)
    - Selektor: #billing_phone
    - Wert: 0123-456789

13. Klicken (Zahlungsmethode - Flowguard Test-Zahlung auswählen)
    - Selektor: #payment_method_flowguard_test

14. Klicken (Bestellung aufgeben)
    - Selektor: #place_order

15. Warten
    - Zeit: 3000

16. Prüfen (Assert)
    - Selektor: .woocommerce-notice
    - Erwartet: "Danke"

Testszenarien

Gast-Checkout

Testen Sie den Checkout-Prozess ohne Kundenanmeldung:

1. Produkt zum Warenkorb hinzufügen
2. Zur Kasse gehen
3. Rechnungsdetails ausfüllen (ohne Konto zu erstellen)
4. Zahlungsmethode auswählen
5. Bestellung aufgeben
6. Bestellbestätigungsnachricht überprüfen

Gutscheinanwendung

Gutscheinfunktion testen:

1. Produkt zum Warenkorb hinzufügen
2. Warenkorb anzeigen
3. Gutschein anwenden (mit Gutscheincode)
4. Überprüfen, ob Rabatt angewendet wird (Assert-Step verwenden)
5. Zur Kasse gehen
6. Bestellung aufgeben

Hinweis: Im Test Mode werden Gutscheinnutzungszähler NICHT erhöht, sodass Sie denselben Gutschein wiederholt testen können.

Zahlungs-Gateway-Tests

Flowguard Test-Zahlungs-Gateway verwenden (Empfohlen)

Erforderlich: Flowguard Test-Zahlungs-Gateway verwenden

Für WooCommerce-Test-Flows MÜSSEN Sie das Flowguard Test-Zahlungs-Gateway verwenden! Dies ist der einzige sichere Weg, Checkout-Flows zu testen.

Flowguard hat ein Test-Zahlungs-Gateway, das nur während Testläufen sichtbar ist:

Funktion	Vorteil
Simuliert Zahlungen	Keine echten Transaktionen
Funktioniert im Test Mode	Vollständig integriert
Erscheint automatisch in Tests	Keine Einrichtung nötig
Vollständig sicher	Keine Bestellungen oder Abbuchungen
Für Kunden versteckt	Nur in Tests sichtbar

Verwendung in Ihren Test-Flows:

1. Test Mode in Flowguard > Einstellungen > Test Mode aktivieren
2. Checkout-Flow wie gewohnt erstellen
3. Bei der Zahlungsmethodenauswahl Test-Zahlung (Flowguard) wählen
4. Das Gateway ist in der Zahlungsmethodenliste während der Testausführung sichtbar
5. Checkout abschließen - die Zahlung wird erfolgreich simuliert

Beispiel-Selektor:

Klicken (Flowguard Test-Zahlung auswählen)
- Selektor: #payment_method_flowguard_test

Warum das Flowguard Test-Zahlungs-Gateway?

• Standard-Zahlungs-Gateways (Stripe, PayPal, etc.) haben ihre externen API-Anfragen im Test Mode blockiert
• Das Flowguard Test-Gateway ist für automatisiertes Testen gebaut
• Keine Sandbox-Anmeldedaten oder Einrichtung nötig
• Sofortige, zuverlässige Zahlungssimulation

Was im Test Mode blockiert wird

WooCommerce-Bestellungen

Blockiert:

• Bestellungserstellung über woocommerce_new_order-Hook
• Bestellungserstellung über wc_create_order()-Funktion
• Direkte Datenbankeinträge in wp_wc_orders (HPOS)
• Direkte Datenbankeinträge in wp_woocommerce_order_items
• Bestellungs-Meta-Updates

Lagerverwaltung

Blockiert:

• Lagerbestandsreduzierungen
• Lagerbestandserhöhungen (Rückerstattungen)
• Produkt-Meta-Updates für Lagerbestand

Gutscheine

Blockiert:

• Gutscheinnutzungszähler-Erhöhungen
• Gutscheinnutzungs-Tracking

Erlaubt:

• Gutscheinvalidierung (Gutscheine werden weiterhin normal validiert)
• Rabattberechnungen

Kundenkonten

Blockiert:

• Kundenbenutzererstellung
• Kunden-Meta-Updates
• Kundensitzungsdaten (persistent)

E-Mails

Blockiert/Umgeleitet:

• Bestellbestätigungs-E-Mails
• Kundenrechnungs-E-Mails
• Admin-Neubestellungsbenachrichtigungen
• Alle anderen WooCommerce-E-Mails

Zahlungs-Gateways

Blockiert:

• Alle externen HTTP-Anfragen an:
  • Stripe API
  • PayPal API
  • Square API
  • Andere Zahlungsprozessoren

Testergebnisse überprüfen

Nach dem Ausführen eines WooCommerce-Flows im Test Mode:

1. Gehen Sie zu Flowguard → Flows
2. Klicken Sie auf Ihren Flow
3. Sehen Sie sich den Test-Protokolle-Tab an

Test-Protokoll-Kategorien

WooCommerce-Protokolle:

• Bestellungserstellungsversuche
• Lagerbestandsreduzierungsversuche
• Gutscheinnutzungsversuche
• Kundenerstellungsversuche
• Zahlungs-Gateway-Auswahlen

Datenbank-Protokolle:

• Verhinderte Datenbankabfragen
• Post/Meta-Operationen

E-Mail-Protokolle:

• Blockierte oder umgeleitete E-Mails
• Empfänger und Betreffs

HTTP-Protokolle:

• Blockierte Zahlungs-Gateway-Anfragen
• Externe API-Aufrufe

Häufige WooCommerce-Selektoren

Hier sind typische Selektoren für WooCommerce-Elemente:

Produktseiten

• In den Warenkorb-Button: button[name="add-to-cart"], .single_add_to_cart_button
• Mengeneingabe: input.qty, input[name="quantity"]
• Varianten-Auswahl: select[id^="pa_"] (z.B. #pa_size, #pa_color)

Warenkorbseite

• Warenkorb-Button: .cart-button, .wc-proceed-to-checkout a
• Checkout-Button: .checkout-button, a.checkout-button
• Gutscheineingabe: #coupon_code
• Gutschein anwenden-Button: button[name="apply_coupon"]
• Warenkorb aktualisieren-Button: button[name="update_cart"]

Kassenseite

• Rechnungsfelder: #billing_first_name, #billing_last_name, #billing_email, etc.
• Versand-Checkbox: #ship-to-different-address-checkbox
• Versandfelder: #shipping_first_name, #shipping_address_1, etc.
• Zahlungsmethoden:
  • Flowguard Test-Zahlung (Empfohlen): #payment_method_flowguard_test
  • Banküberweisung: #payment_method_bacs
  • Stripe: #payment_method_stripe
  • PayPal: #payment_method_paypal
• AGB-Checkbox: #terms
• Bestellung aufgeben-Button: #place_order, button[name="woocommerce_checkout_place_order"]

Bestellbestätigung

• Erfolgsmeldung: .woocommerce-notice--success, .woocommerce-thankyou-order-received
• Bestellnummer: .woocommerce-order-overview__order, .order-number

Best Practices

#1: Immer Test Mode aktivieren

Führen Sie niemals WooCommerce-Flows ohne aktivierten Test Mode aus, es sei denn, Sie beabsichtigen, echte Bestellungen zu erstellen.

2. Testprodukte verwenden

Erstellen Sie dedizierte Testprodukte:

Einstellung	Empfehlung
Preis	0,01 EUR oder 1,00 EUR
SKU	TEST-001, TEST-002
Name	"TEST - Produktname"
Lagerbestand	Unbegrenzt oder hohe Menge

3. Dedizierte Test-Gutscheine erstellen

Test-Gutschein-Einrichtung

• Nutzungslimit: Keins (unbegrenzt)
• Benennung: TEST-GUTSCHEIN-20, TEST-VERSANDFREI
• Dokumentieren: Führen Sie eine Liste für Ihr Team

4. Flowguard Test-Zahlungs-Gateway verwenden

Zahlungs-Gateway-Auswahl

Gateway	Sicherheit	Empfehlung
Flowguard Test-Zahlung	Sicher	DIES VERWENDEN!
Banküberweisung (bacs)	Riskant	Kann Bestellungen erstellen
Nachnahme (cod)	Riskant	Kann Bestellungen erstellen
Scheck (cheque)	Riskant	Kann Bestellungen erstellen
Stripe/PayPal/Extern	Blockiert	Sandbox-Modus separat verwenden

5. Selektor-Picker verwenden

Der Flow Editor hat ein Selektor-Picker-Tool:

• Klicken Sie auf das Fadenkreuz-Symbol im Step-Konfigurationspanel
• Klicken Sie auf ein beliebiges Element in der Vorschau
• Der Selektor wird automatisch ausgefüllt
• Spart Zeit und reduziert Selektorfehler

6. Beschreibende Namen hinzufügen

Gut	Schlecht
"Klicken (In den Warenkorb)"	"Klicken"
"Ausfüllen (Rechnungs-E-Mail)"	"Ausfüllen"
"Auswählen (Versandmethode)"	"Auswählen"

7. Test-Protokolle überwachen

Nach jedem Testlauf prüfen:

• [ ] Bestellungen wurden ordnungsgemäß blockiert
• [ ] Lagerbestand wurde nicht reduziert
• [ ] Keine E-Mails an echte Kunden gesendet

Fehlerbehebung

Flow schlägt bei "Bestellung aufgeben" fehl

Problem: Flow hat Timeout oder schlägt beim Klicken auf "Bestellung aufgeben" fehl

Lösungen:

1. Wartezeit nach dem Bestellung-aufgeben-Step erhöhen
2. Prüfen, ob ein Zahlungs-Gateway-Redirect blockiert wird
3. Test-Protokolle auf JavaScript-Fehler überprüfen
4. Überprüfen, ob Zahlungsmethode im Test Mode verfügbar ist

Gutschein wird nicht angewendet

Problem: Gutscheinvalidierung schlägt während des Tests fehl

Lösungen:

1. Überprüfen, ob Gutschein existiert und aktiv ist
2. Gutscheinnutzungsbeschränkungen prüfen (Benutzer-/E-Mail-Limits)
3. Sicherstellen, dass Gutschein-Datumsbereich gültig ist
4. Gutschein zuerst manuell testen

"Bestellung nicht gefunden" nach Checkout

Problem: Flow erwartet Bestellbestätigung, sieht aber Fehler

Lösung: Das ist im Test Mode normal! Die Bestellung wird nicht erstellt, daher kann WooCommerce einen Fehler anzeigen. Stattdessen:

1. Assert-Steps verwenden, um auf Fehlermeldungen zu prüfen
2. Überprüfen, dass das Checkout-Formular abgesendet wurde
3. Test-Protokolle prüfen, um zu bestätigen, dass Bestellungserstellung blockiert wurde

Lagerbestand wird trotzdem verringert

Problem: Produktlagerbestand wird trotz Test Mode reduziert

Lösungen:

1. Überprüfen, ob Test Mode in Einstellungen aktiviert ist
2. Prüfen, ob flowguard_preview=1-Parameter in der URL während der Flow-Ausführung ist
3. Test-Protokolle überprüfen, um sicherzustellen, dass WooCommerce-Interceptors aktiv sind
4. Sicherstellen, dass WooCommerce aktiv und erkannt wird

Kompatibilität

WooCommerce-Versionen

Flowguards WooCommerce Test Mode ist kompatibel mit:

• WooCommerce 5.0+
• WooCommerce 8.0+ (HPOS-Unterstützung)
• WooCommerce 9.0+

Zahlungs-Gateways

Kompatibel mit allen Standard-WooCommerce-Zahlungs-Gateways:

• WooCommerce-Kern-Zahlungsmethoden (Banküberweisung, Scheck, Nachnahme)
• Stripe für WooCommerce
• PayPal Standard/Express
• Square
• Authorize.net
• Und jedes andere Gateway, das WooCommerce-Standards folgt

Themes

Der Test Mode-Schutz funktioniert mit jedem WooCommerce-kompatiblen Theme. Selektoren können jedoch zwischen Themes variieren:

Für Standard-Themes: Oben aufgeführte häufige Selektoren verwenden Für benutzerdefinierte Themes: Selektor-Picker verwenden, um die richtigen Elemente zu identifizieren

Support

Wenn Sie Probleme beim WooCommerce-Testen haben:

1. Diese Dokumentation prüfen
2. Test-Protokolle in Flow-Ergebnissen überprüfen
3. Überprüfen, ob Test Mode aktiviert ist
4. WooCommerce-Kompatibilität prüfen
5. Support kontaktieren mit:
   • WooCommerce-Version
   • Verwendetes Zahlungs-Gateway
   • Theme-Name
   • Test-Protokoll-Export

Verwandte Dokumentation

• Test Mode-Leitfaden
• Flow Editor-Leitfaden
• Step Types-Referenz
• Monitoring