DfCartRecovery — Warenkorbabbrecher-Rückgewinnung für Shopware 6

Überblick

DfCartRecovery bringt die Warenkorb-Rückgewinnung in Shopware 6 (Community Edition), die normalerweise dem Commercial-Plan vorbehalten ist: Erkennung abgebrochener Warenkörbe, bis zu 3 geplante Erinnerungs-E-Mails, ein individueller Rabattcode pro Kunde, ein 1-Klick-Wiederherstellungslink und Tracking der zurückgewonnenen Bestellungen. Kein externer Dienst, kein Administration-Build: Alles wird in den Plugin-Einstellungen konfiguriert.

Voraussetzungen

• Shopware 6.5, 6.6 oder 6.7 (selbst gehostete Community Edition — Shopware Cloud SaaS nicht unterstützt)
• PHP 8.1 oder höher (8.2+ empfohlen)
• Aktiver Message-Consumer und laufende Scheduled Tasks (Standard-Empfehlung von Shopware in Produktion)
• Funktionierender E-Mail-Versand im Shop (die Erinnerungen laufen über den nativen Mailservice von Shopware)

Installation

1. Entpacken Sie das Archiv und legen Sie den Ordner DfCartRecovery in custom/plugins/ ab.
2. Führen Sie im Shopware-Stammverzeichnis aus:

bin/console plugin:refresh
bin/console plugin:install --activate DfCartRecovery
bin/console cache:clear

Der Scheduled Task df_cart_recovery.process wird automatisch registriert und läuft alle 15 Minuten. Stellen Sie sicher, dass Ihre Worker laufen:

bin/console scheduled-task:run
bin/console messenger:consume async low_priority

Konfiguration

Öffnen Sie Erweiterungen → Meine Erweiterungen → DfCartRecovery → Konfiguration. Drei Einstellungskarten:

Allgemein

• Warenkorb-Recovery aktivieren — globaler Schalter des Plugins.
• Mindestwarenkorbwert — Warenkörbe unter diesem Betrag werden ignoriert (0 = kein Minimum).
• Datenaufbewahrung (Tage) — ältere Tracking-Einträge werden automatisch gelöscht (Standard 30 Tage, siehe Abschnitt DSGVO).

Erinnerungs-E-Mails

• Anzahl der Erinnerungen — 1, 2 oder 3 (Standard: 2).
• Erinnerung 1 — Minuten nach dem Warenkorbabbruch (Standard 60, also 1 Stunde).
• Erinnerung 2 — Minuten nach Erinnerung 1 (Standard 1440, also 24 Stunden).
• Erinnerung 3 — Minuten nach Erinnerung 2 (Standard 4320, also 72 Stunden).

Rabattgutschein

• Individuellen Rabattcode beilegen — aktiviert die Generierung individueller Codes.
• Promotion für generierte Codes — wählen Sie die Shopware-Promotion, die die Codes trägt (siehe unten).
• Code senden mit Erinnerung Nr. — Standard 2: Kunden, die schon nach der ersten E-Mail zurückkommen, bestellen ohne Rabatt.
• Gutscheincode-Präfix — Standard CART; generierte Codes sehen aus wie CART-7F3A91B2.

Die Promotion für individuelle Codes einrichten

1. Öffnen Sie im Shopware-Admin Marketing → Aktionen und erstellen Sie eine Promotion (oder verwenden Sie eine bestehende).
2. Aktivieren Sie im allgemeinen Tab Individuelle Promotion-Codes.
3. Definieren Sie Rabatt (Prozent oder Betrag), Bedingungen und Gültigkeitszeitraum wie gewohnt.
4. Aktivieren Sie die Promotion und wählen Sie sie in der Plugin-Konfiguration aus.

Die Erinnerungs-E-Mail anpassen

Der Inhalt wird unter Einstellungen → E-Mail-Vorlagen bearbeitet, Typ „Warenkorbabbrecher-Erinnerung (DataFirefly)“, für jede Shopsprache. Verfügbare Twig-Variablen:

• firstName / lastName — Vor- und Nachname des Kunden
• items — Warenkorbartikel, jeweils mit label und quantity
• total und currency — Warenkorbsumme und Währungscode
• recoveryUrl — der Wiederherstellungslink (auf den Call-to-Action-Button legen)
• voucherCode — der individuelle Rabattcode (leer wenn deaktiviert oder bei Erinnerungen ohne Code: umschließen Sie den Block mit einer Twig-Bedingung)
• shopName — der Shopname des Verkaufskanals
• reminderNumber — die Nummer der aktuellen Erinnerung (1, 2 oder 3)

Der Wiederherstellungslink

Jede E-Mail enthält einen eindeutigen Link der Form /df-cart-recovery/token, generiert auf der Domain des Verkaufskanals des Kunden, in seiner Sprache. Beim Klick baut das Plugin den Warenkorb Artikel für Artikel wieder auf, meldet nicht mehr verfügbare Produkte mit einer Storefront-Meldung, protokolliert den Klick mit Zeitstempel und leitet zur Warenkorbseite weiter. Ungültige oder abgelaufene Links leiten mit einer klaren Meldung zur Startseite weiter.

Recovery-Tracking

Sobald eine Bestellung aufgegeben wird, gleicht das Plugin die E-Mail des Kunden mit den offenen abgebrochenen Warenkörben ab: Der Eintrag wechselt auf „zurückgewonnen“ mit Bestell-ID, Datum und Anzahl der versendeten Erinnerungen. Die Erinnerungen stoppen sofort für diesen Warenkorb. Die Daten liegen in der Tabelle df_cart_recovery (Token, Status, Klicks, verknüpfte Bestellungen) für Ihre SQL- oder BI-Auswertungen.

DSGVO und Daten

• Keine Daten verlassen Ihren Server; es wird kein Drittanbieter-Dienst aufgerufen.
• Tracking-Einträge werden nach der konfigurierten Aufbewahrungsfrist automatisch bereinigt.
• Wählen Sie bei der Deinstallation „Alle App-Daten entfernen“, um Tabelle, E-Mail-Vorlage und Konfiguration zu löschen — oder behalten Sie sie, um die Historie zu bewahren.

Fehlerbehebung

Es werden keine E-Mails versendet

• Prüfen Sie, ob der Scheduled Task läuft: bin/console scheduled-task:list muss df_cart_recovery.process als scheduled anzeigen, und Ihre Messenger-Worker müssen aktiv sein.
• Testen Sie den globalen E-Mail-Versand des Shops (Einstellungen → Mailer): Das Plugin nutzt den Standard-Mailservice.
• Prüfen Sie Mindestwarenkorbwert und Verzögerung der Erinnerung 1: Ein vor 20 Minuten abgebrochener Warenkorb ist bei 60 Minuten Verzögerung noch nicht fällig.

Gäste erhalten nichts

Das ist erwartetes Verhalten: Ohne E-Mail-Adresse ist keine Erinnerung möglich. Gäste werden erfasst, sobald sie sich identifizieren (Login oder Kontoerstellung im Checkout) — die Warenkorb-Zusammenführung aktualisiert den Eintrag mit ihrer Adresse.

Der Rabattcode erscheint nicht in der E-Mail

• Prüfen Sie, ob „Individuellen Rabattcode beilegen“ aktiv ist und eine Promotion ausgewählt wurde.
• Die Promotion muss existieren, aktiv sein und individuelle Codes aktiviert haben.
• Der Code wird erst ab der konfigurierten Erinnerung beigefügt (Standard: die 2.): Erinnerung 1 enthält in der Standardkonfiguration keinen Code.

Der Wiederherstellungslink führt zur Startseite

Der Token ist ungültig oder der Eintrag wurde bereinigt (Aufbewahrungsfrist überschritten) — der Kunde sieht eine Meldung mit der Bitte, den Warenkorb neu zusammenzustellen. Erhöhen Sie die Aufbewahrungsfrist, wenn Ihre Erinnerungsintervalle lang sind.