DataFirefly Loyalty — Shopware 6 Treueprogramm

Überblick

DataFirefly Loyalty fügt Shopware 6 ein vollständiges Treueprogramm hinzu: Ihre Kunden sammeln Punkte bei jeder Bestellung, steigen in Stufen mit Punkte-Multiplikatoren auf und wandeln ihre Punkte in Gutscheine um, die auf den nativen Promotions von Shopware basieren. Die Erweiterung läuft auf Shopware 6.5, 6.6 und 6.7 mit einem einzigen ZIP, ganz ohne Kompilierung.

Installation

Über die Administration

1. Öffnen Sie Erweiterungen > Meine Erweiterungen.
2. Klicken Sie auf Erweiterung hochladen und wählen Sie die Datei DfLoyalty-1.0.0.zip.
3. Klicken Sie auf Installieren und aktivieren Sie die Erweiterung.

Über die Kommandozeile

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

Die Installation legt zwei eigene Tabellen an: df_loyalty_account (eine Zeile pro Kunde) und df_loyalty_transaction (das Journal aller Punktevorgänge).

Konfiguration

Öffnen Sie Erweiterungen > Meine Erweiterungen > DataFirefly Loyalty > Konfigurieren. Alle Einstellungen sind pro Verkaufskanal verfügbar: Sie können das Programm nur in einem Shop aktivieren oder je Kanal unterschiedliche Sätze anwenden.

Punktegutschrift

• Programm aktivieren: Hauptschalter. Deaktiviert liefert die Kundenkonto-Seite einen 404-Fehler und es werden keine Punkte gutgeschrieben.
• Gutschrift-Auslöser: Zahlung eingegangen (Transaktionsstatus paid, empfohlen) oder Bestellung abgeschlossen (Bestellstatus completed).
• Punkte pro Währungseinheit: gesammelte Punkte pro ausgegebener Einheit. Standard: 1.
• Berechnungsbasis: Bestellwert brutto oder netto.
• Versandkosten einbeziehen: standardmäßig sind Versandkosten von der Berechnung ausgeschlossen.

Stufen

Drei Stufen sind konfigurierbar, jeweils mit Name, Schwelle und Multiplikator. Die Schwellen gelten für die insgesamt gesammelten Punkte (die durch eine Einlösung nie sinken), der Multiplikator gilt für alle künftigen Gutschriften.

• Stufe 1 — Standard: Bronze, ab 0 Punkten, Multiplikator ×1.0
• Stufe 2 — Standard: Silber, ab 500 Punkten, Multiplikator ×1.25
• Stufe 3 — Standard: Gold, ab 2 000 Punkten, Multiplikator ×1.5

Gutschein-Einlösung

• Umrechnungskurs: benötigte Punkte pro 1 € Gutscheinwert. Standard: 100 (100 Punkte = 1,00 €).
• Einlöse-Minimum: Mindestpunktzahl für eine Einlösung. Standard: 200.
• Schrittweite: Punkte werden in Vielfachen dieses Werts umgewandelt. Standard: 100.
• Gutschein-Gültigkeit: Lebensdauer des Gutscheins in Tagen. Standard: 90.

Ablauf für Kunden

Im Kundenkonto-Menü erscheint ein Eintrag Treueprogramm. Die Seite /account/loyalty zeigt:

• den verfügbaren Punktestand und die insgesamt gesammelten Punkte;
• die aktuelle Stufe mit einem Fortschrittsbalken zur nächsten Stufe;
• das Einlöseformular;
• den Verlauf der letzten 50 Vorgänge (Gutschriften, Einlösungen, Stornierungen).

Löst ein Kunde Punkte ein, erstellt die Erweiterung eine native Shopware-Promotion: ein eindeutiger Code der Form LOYAL-XXXXXXXX, an sein Konto gebunden, einmalig nutzbar, mit festem Warenkorbrabatt. Der Code wird im Warenkorb wie jeder Gutscheincode eingelöst. Alle erzeugten Promotions finden Sie unter Marketing > Aktionen.

Stornierungen und Erstattungen

Wechselt eine Bestellung in den Status Storniert oder ihre Zahlung in den Status Erstattet, werden die auf diese Bestellung gutgeschriebenen Punkte automatisch zurückgenommen. Der Vorgang wird im Verlauf des Kunden unter dem Label „Storniert“ nachgewiesen. Die Rücknahme ist idempotent: Sie kann höchstens einmal pro Bestellung erfolgen.

Sicherheit und Datenintegrität

• Der Punkteabzug ist auf Datenbankebene atomar: Zwei gleichzeitige Einlösungen können dasselbe Guthaben nicht doppelt ausgeben.
• Jeder Vorgang wird in ein Append-only-Journal geschrieben, mit Bestellreferenz, Typ, vorzeichenbehafteten Punkten und ggf. Gutscheincode.
• Gutscheinerstellung und Journalbuchung laufen in derselben SQL-Transaktion: nie ein Gutschein ohne Abzug, nie ein Abzug ohne Gutschein.

Fehlerbehebung

Der Treueprogramm-Link erscheint nicht im Konto

Die Erweiterung fügt ihren Link über den Twig-Block page_account_sidebar_link_orders ein. Falls Ihr angepasstes Theme diesen Block entfernt oder umbenannt hat, fügen Sie den Link manuell in das Sidebar-Template des Kontos ein und verweisen Sie auf die Route frontend.account.dfloyalty.page.

Es werden keine Punkte gutgeschrieben

1. Prüfen Sie, ob das Programm für den betreffenden Verkaufskanal aktiviert ist.
2. Prüfen Sie den konfigurierten Auslöser: Bei Zahlung eingegangen muss die Transaktion den Status paid erreichen, bei Bestellung abgeschlossen die Bestellung den Status completed.
3. Leeren Sie den Cache nach jeder Konfigurationsänderung: bin/console cache:clear.

Deinstallation

Bei der Deinstallation bietet Shopware an, die Daten zu behalten. Wenn Sie diese Option abwählen, werden die Tabellen df_loyalty_account und df_loyalty_transaction endgültig entfernt — bereits erzeugte Gutscheine bleiben bestehen, da es sich um Standard-Promotions von Shopware handelt.