Ultimate
Loyalty.

Ultimate Loyalty ist ein umfassendes Treuepunkte-System für Shopware 6. Kunden sammeln bei jedem Einkauf automatisch Punkte, steigen in Belohnungsstufen auf und erhalten Gratisprodukte ab definierten Bestellwerten. Das Programm lässt sich wahlweise mit vollem Stufensystem oder — bei abgeschaltetem Belohnungsstufen-Modus — als reines Punkte-Programm betreiben.

Kernfunktionen:

• Punkte-System: Kunden verdienen Punkte bei jedem Einkauf und lösen diese als Cashback-Rabatt ein — im Kundenkonto oder direkt im Warenkorb
• Belohnungsstufen: Bronze, Silber, Gold, Platin und VIP mit automatischem Aufstieg und Stufenrabatten
• Belohnungsstufen-Modus: Stufensystem nutzen oder komplett abschalten für ein reines Punkte-Programm
• Sperrfrist: Punkte aus Bestellungen optional erst X Tage nach Zahlung verfügbar (pro Verkaufskanal)
• Kundengruppen-Beschränkung: Punkte-Sammeln auf bestimmte Kundengruppen begrenzen
• Anmelde-Modus: automatische Teilnahme oder aktive Selbst-Anmeldung mit Zustimmung zu Teilnahmebedingungen
• Gratisprodukt-Engine: Automatische oder vom Kunden wählbare Gratisprodukte ab bestimmten Bestellwerten
• Empfehlungssystem: Kunden werben Kunden mit Referral-Links und erhalten Punkte
• Bewertungsbonus: Punkte für Produktbewertungen
• Newsletter-Bonus: Punkte für Newsletter-Anmeldung
• Registrierungsbonus: Willkommenspunkte bei Kontoerstellung
• 1-Klick-Import: Bestellhistorie importieren und retroaktiv Punkte vergeben
• CSV Import/Export: Kunden- und Transaktionsdaten exportieren, Punkte manuell importieren
• Statistiken & ROI: Detaillierte Auswertungen inkl. Programmkosten und Umsatzanalyse

Systemanforderungen: Shopware ~6.7.0, PHP 8.2+, MySQL 8.0+ / MariaDB 10.11+

Installation:

1. Plugin-Ordner BmaniaUltimateLoyalty nach custom/plugins/ kopieren
2. bin/console plugin:refresh
3. bin/console plugin:install BmaniaUltimateLoyalty
4. bin/console plugin:activate BmaniaUltimateLoyalty
5. bin/console cache:clear

Nach der Installation ist das Plugin unter Marketing > Ultimate Loyalty erreichbar.

Grundkonfiguration in 5 Minuten:

• Name des Treueprogramms setzen (z. B. „Bonuspunkte“, „Meilen“, „Coins“)
• Punkte pro Euro Bestellwert definieren (Standard: 1)
• Wert eines Punktes in Euro festlegen (Standard: 0,01 EUR)
• Optional: Registrierungsbonus aktivieren

Erste Belohnungsstufe anpassen: Marketing > Ultimate Loyalty > Stufen → Stufe wählen → Name, Mindestpunkte, Multiplikator und Stufenrabatt anpassen.

Erstes Gratisprodukt: Marketing > Ultimate Loyalty > Gratisprodukte → Neues Gratisprodukt → Produkt, Mindestbestellwert, Auswahlmodus wählen.

1-Klick Import: Marketing > Ultimate Loyalty > Import → Startdatum wählen → Vorschau laden → Import starten.

Unter Erweiterungen > Meine Erweiterungen > Ultimate Loyalty > Konfiguration. Pro Sales Channel konfigurierbar.

Branding: Name des Treueprogramms (Standard: „Bonuspunkte“)

Punkte-Einstellungen:

• Punkte pro Euro (Standard: 1)
• Wert pro Punkt (Standard: 0,01 EUR)
• Verfall nach Tagen (Standard: 365)
• Sperrfrist (Tage): Punkte aus Bestellungen werden erst nach X Tagen verfügbar (Standard: 0 = sofort) — ideal für Widerrufsfristen
• Registrierungsbonus

Belohnungsstufen:

• Belohnungsstufen-Modus: Volle Stufen nutzen oder komplett abschalten für ein reines Punkte-Programm (Standard: Stufen aktiv)
• Stufen-Berechnungsmodell: „Lifetime“ (Gesamtpunkte, kein Abstieg) oder „Rollierend 12 Monate“ (letzte 365 Tage, mit Auf- und Abstieg)
• Kombinier-Option (Rabatt-Kombination): Steuerung, ob Stufen-Rabatt und Punkte-Einlösen kombinierbar sind. Bei „nicht kombinierbar“ hat Punkte-Einlösen Vorrang
• Bezeichnung Stufenrabatt (neu in v1.2.0): Frei wählbare Bezeichnung der Stufenrabatt-Zeile im Warenkorb (z. B. „Stufenrabatt 5% (Gold)“)

Kundengruppen-Beschränkung: Modus „alle“ / „nur ausgewählte“ / „alle außer ausgewählte“. Pro Verkaufskanal.

Anmelde-Modus (Verdienst-Regeln, neu in v1.3.0): Legt fest, wie Kunden am Programm teilnehmen. „Automatisch“ (Standard): Alle berechtigten Kunden nehmen automatisch teil. „Selbst-Anmeldung“: Kunden treten aktiv über das Kundenkonto oder eine optionale Checkbox im Checkout bei — mit Zustimmung zu Ihren Teilnahmebedingungen, deren Link direkt in der Konfiguration hinterlegt wird. Dabei gilt eine Zwei-Tore-Logik: Tor 1 — die Kundengruppe des Kunden muss berechtigt sein. Tor 2 — der Kunde muss individuell angemeldet sein; dieses Tor ist nur im Modus „Selbst-Anmeldung“ aktiv.

Punkte-Einlösen im Warenkorb (neu in v1.2.0): Sieben Einstellungen steuern das Einlösefeld direkt im Warenkorb:

• Einlöse-Feld anzeigen: Schaltet das Einlösefeld im Warenkorb ein/aus
• Überschrift: Titel des Einlöse-Bereichs
• Feld-Beschriftung: Label des Eingabefelds
• Platzhalter: Platzhaltertext im Eingabefeld
• Maximum-Button-Text: Beschriftung des Buttons, der das maximale Guthaben einsetzt
• Einlösen-Button-Text: Beschriftung des Bestätigungs-Buttons
• Hinweis „nicht auszahlbar“: Hinweistext, dass Punkte nicht in bar ausgezahlt werden

Einlösung im Off-Canvas-Warenkorb und im Checkout (neu in v1.2.2): Das Einlösefeld lässt sich zusätzlich im Off-Canvas-Warenkorb und direkt im Checkout anzeigen — jeder Ort mit eigenem Schalter pro Verkaufskanal (Standard: aus, bestehende Shops bleiben unverändert).

Mindestbestellwert für die Einlösung (neu in v1.2.1): Koppelt die Punkte-Einlösung an einen Mindestbestellwert. Modus „Aus“ (Standard), „Ausschluss“ (Einlösung unterhalb des Betrags gesperrt) oder „Upsell“ (motivierender Hinweis statt Sperre) — jeweils mit frei definierbarem Betrag und sprechender Meldung.

Gratisprodukte: Engine ein/aus, Auswahlmodus, Kombinationen mit Rabatten. Multi-Select erlaubt mehrere Gratisprodukte gleichzeitig. Optional nur für registrierte Kunden — Gastkunden erhalten stattdessen ein Incentive-Banner. Die Banner-Texte sind frei konfigurierbar und mehrsprachig (de-DE / en-GB).

Newsletter & Bonus: Newsletter-Bonus aktivierbar mit konfigurierbarer Punktzahl.

Empfehlungssystem: Pauschal oder prozentual, Lifetime-Referral optional.

VIP: Sichtbarkeit und Punkte-Sammeln separat steuerbar.

Design & Farben: Banner-Farben, Button-Farben, eigenes CSS.

Bewertungen: Bonus aktivierbar, Punkte pro Bewertung, nur verifizierte Käufer.

E-Mail: Gutschrift-Mail, Verfallserinnerung, Bewertungserinnerung, Empfehlungs-Mail.

Anzeige: Header-Badge, Fortschrittsbalken, Produktseiten-Vorschau.

Standard-Stufen:

• Bronze: 0 Punkte, 0% Rabatt, 1.0x Multiplikator
• Silber: 500 Punkte, 3% Rabatt, 1.5x Multiplikator
• Gold: 1.000 Punkte, 5% Rabatt, 2.0x Multiplikator
• Platin: 2.500 Punkte, 10% Rabatt, 3.0x Multiplikator
• VIP: 99.999 Punkte, 10% Rabatt, 2.0x Multiplikator

Felder: Technischer Name, Name, Beschreibung, Mindestpunkte, Multiplikator, Stufenrabatt (%), Punkte sammeln, Farbe, Position, Aktiv.

Multiplikator-Formel: Verdiente Punkte = Bestellwert × Punkte pro Euro × Tier-Multiplikator.

VIP-Status: 99.999 Mindestpunkte (praktisch nur manuell), standardmäßig kein Punkte-Sammeln, ausgeblendet in Storefront.

Automatischer Aufstieg basiert auf Lifetime-Punkten. Kein Abstieg, auch bei Einlösung.

Stufen-Berechnungsmodell (neu in v1.1.0): Zwei Modelle stehen zur Wahl — Lifetime (Gesamtpunkte, kein Abstieg) und Rollierend 12 Monate (Punkte der letzten 365 Tage, mit automatischem Auf- und Abstieg).

Mindestpunkte je nach Modell: Im Lifetime-Modell zählen die Mindestpunkte gegen die jemals gesammelten Gesamtpunkte — Einlösungen senken die Stufe nicht. Im Modell „Rollierend 12 Monate“ zählen sie gegen die in den letzten 365 Tagen gesammelten Punkte; sinkt dieser Wert unter die Schwelle, steigt der Kunde ab.

Das gewählte Stufen-Berechnungsmodell gilt global für alle Kunden.

Mit dem Belohnungsstufen-Modus entscheiden Sie, ob das Plugin mit vollem Stufensystem oder als reines Punkte-Programm läuft.

Modus „An“ (Standard): Das volle Stufensystem ist aktiv — Status, Punkte-Multiplikatoren, Stufenrabatte und die Stufen-Anzeigen in der Storefront.

Modus „Aus“: Reines Punkte-Programm. Es gibt keinen Status, keinen Stufenrabatt und keinen Multiplikator. Die komplette Stufen-UI wird in der Storefront ausgeblendet. Kunden sammeln und lösen weiterhin Punkte ein — bereits gesammelte Punkte bleiben erhalten.

Kombinier-Option: Steuert, ob sich Stufen-Rabatt und Punkte-Einlösen kombinieren lassen. Bei „nicht kombinierbar“ hat das Punkte-Einlösen Vorrang und der Stufen-Rabatt entfällt für diese Bestellung.

Unter Marketing > Ultimate Loyalty > Gratisprodukte.

Felder: Produkt, Mindestbestellwert, Max. Anzahl, Priorität, Gültigkeitszeitraum, Shopware-Regel.

Automatisch: Höchste Priorität wird in Warenkorb gelegt (0,00 EUR).

Kunden-Auswahl: Banner mit allen verfügbaren Gratisprodukten, Kunde wählt aus. Multi-Select erlaubt die Auswahl mehrerer Gratisprodukte gleichzeitig.

Nur für registrierte Kunden: Die Gratisprodukt-Engine lässt sich optional auf eingeloggte Kunden beschränken. Gastkunden sehen dann statt der Auswahl ein Incentive-Banner, das zur Registrierung einlädt.

Incentive-Banner: Texte frei konfigurierbar und mehrsprachig (de-DE / en-GB).

Warenkorb-Voraussetzungen: Erforderliche Kategorien/Produkte.

Warenkorb-Ausschlüsse: Ausgeschlossene Kategorien/Produkte.

Sammeln: Bestellung, Registrierung, Newsletter, Bewertung, Empfehlung, Lifetime-Referral, Manuell, CSV-Import.

Gast-Kunden: Nur eingeloggte Kunden mit Konto sammeln Punkte. Für Gastbestellungen werden keine Punkte vergeben.

Konto-Steuerung: Das Punkte-Sammeln lässt sich pro Kundenkonto deaktivieren — direkt aus der Kundenkonto-Liste im Admin.

Sperrfrist: Optional werden Punkte aus Bestellungen und Empfehlungen erst X Tage nach Zahlung verfügbar (pro Verkaufskanal, Standard: aus). Ideal für Widerrufsfristen.

Einlösen (Cashback) — im Kundenkonto und an drei Orten im Bestellprozess:

• Im Kundenkonto: Mein Konto > Mein Treuekonto → Punktzahl eingeben → Einlösen → Rabatt im Warenkorb.
• Direkt im Warenkorb (neu in v1.2.0): Punkte ohne Umweg über das Kundenkonto direkt im Warenkorb als Cashback einlösen — mit Eingabefeld, Maximum-Button und Euro-Vorschau.
• Im Off-Canvas-Warenkorb (neu in v1.2.2): Einlösefeld direkt im seitlichen Warenkorb — eigener Schalter pro Verkaufskanal (Standard: aus).
• Im Checkout (neu in v1.2.2): Einlösefeld direkt auf der Checkout-Seite — eigener Schalter pro Verkaufskanal (Standard: aus).

Mindestbestellwert (neu in v1.2.1): Die Einlösung lässt sich an einen Mindestbestellwert koppeln — Modus „Ausschluss“ sperrt die Einlösung darunter, Modus „Upsell“ zeigt stattdessen einen motivierenden Hinweis.

Formel: Eingelöste Punkte × Wert pro Punkt.

Warenkorb-Begrenzung (neu in v1.2.0): Der Punkte-Rabatt wird automatisch auf den Warenkorbwert gedeckelt. Der Warenkorb wird nie negativ — überschüssige Punkte bleiben als Guthaben erhalten.

Verfall: Konfigurierbar (Standard: 365 Tage, 0 = nie). Es verfallen nur Punkte aus Bestellungen — Bonus-Punkte (z. B. Registrierung, Newsletter, Bewertung, Empfehlung) verfallen nicht. Optionale E-Mail-Erinnerung.

Manuelle Anpassung: Marketing > Ultimate Loyalty > Konten → Konto öffnen → Gutschrift oder Abzug.

Jeder Kunde erhält einen Code: REF-NACHNAME-XXXX. Umlaute werden konvertiert (ä→AE etc.).

Link auf Mein Konto > Mein Treuekonto, teilbar per Kopie, WhatsApp oder E-Mail.

Einmaliger Referral: Punkte bei erster bezahlter Bestellung des Neukunden.

Lifetime Referral: Zusätzlich Prozentsatz bei Folgebestellungen, zeitlich begrenzbar.

Modi: Pauschal (feste Punkte) oder Prozentual (% der Punkte/Bestellwert).

Schutzmechanismen: Keine Selbst-Empfehlung, keine zirkulären Empfehlungen, Einmal-Schutz.

Auto-Rückbuchung (verbessert in v1.2.0): Empfehlungs-Boni werden bei Stornierung der zugehörigen Bestellung jetzt zuverlässig automatisch zurückgebucht.

1-Klick Import: Startdatum, Filter (bezahlt/storniert), Vorschau, Import mit Fortschrittsbalken. Duplikatschutz.

CSV Export: Kunden (loyalty-customers.csv) und Transaktionen (loyalty-transactions.csv), Streaming-Download in 500er-Batches.

CSV Import: Format: Kundennummer_oder_Email;Punkte;Beschreibung. Semikolon/Komma/Tab. UTF-8. Duplikatschutz.

Dashboard: KPI-Karten, Top-5-Kunden, letzte 5 Transaktionen, Stufen-Verteilung.

Konten: Alle Loyalty-Konten, manuelle Anpassung, Transaktionshistorie. Das Punkte-Sammeln lässt sich pro Konto direkt aus der Liste deaktivieren (Konto-Deaktivierung). Im Modus „Selbst-Anmeldung“ zeigt die Konto-Liste die Spalte „Angemeldet“ mit Filter (alle / nur angemeldete / nur nicht angemeldete).

Beste Kunden: KPI-Highlights, Filter nach Zeitraum und Sortierung. Die Tabelle nutzt jetzt die volle Breite.

Statistiken: Gratisprodukt-Kosten, Cashback-Statistiken, ROI-Übersicht.

Templates:

• gk_loyalty_points_earned
• gk_loyalty_expiry_reminder
• gk_loyalty_referral_success
• gk_loyalty_review_reminder

Bearbeitung unter Einstellungen > Shop > E-Mail-Templates (Suche „Loyalty“).

Variablen: customerName, pointsEarned, programName, orderNumber, totalPoints, loyaltyUrl, expiringPoints, expiryDate, referredCustomerName, reviewPoints, reviewUrl.

Meine Punkte (/account/loyalty): Punktestand, Stufen-Zeitleiste mit Fortschritt, Punkte einlösen, Transaktionshistorie, Empfehlungsbereich.

Teilnahme-Status (neu in v1.3.0): Im Modus „Selbst-Anmeldung“ zeigt das Treuekonto den Teilnahme-Status: Noch nicht angemeldete Kunden sehen „Am Bonusprogramm teilnehmen“, Teilnehmer sehen „Sie nehmen teil“ sowie „Teilnahme beenden“. Wer sich abmeldet, behält seine bereits gesammelten Punkte.

Reservierungs-Anzeige (neu in v1.2.0): Hat ein Kunde Punkte eingelöst, zeigt das Treuekonto den Reservierungsstatus — ein Countdown bei offener Einlösung oder ein Hinweis, sobald die Bestellung aufgegeben wurde.

Header-Badge: Punktestand und Stufe in Navigation.

Warenkorb: Fortschrittsbalken zum Gratisprodukt, Gratisprodukt-Banner, Punkte-Rabatt, Stufenrabatt, Gratisprodukt mit „GRATIS“-Badge. Neu in v1.2.0: Punkte-Einlösefeld direkt im Warenkorb, Incentive-Banner für Gastkunden und eine frei konfigurierbare Bezeichnung des Stufenrabatts (z. B. „Stufenrabatt 5% (Gold)“).

Checkout-Checkbox (optional, neu in v1.3.0): Auf Wunsch erscheint im Checkout eine Beitritts-Checkbox für das Bonusprogramm. Sie ist freiwillig und blockiert die Bestellung nicht — der Beitritt erfolgt erst bei erfolgreicher Bestellung.

Produktseiten: „Du verdienst X Bonuspunkte mit diesem Kauf“ (Position konfigurierbar).

Keine Punkte-Vorschau: Einstellung prüfen, Position prüfen, Cache leeren.

Keine Gratisprodukte: Engine aktiv? Produkt aktiv? Bestellwert erreicht? Voraussetzungen erfüllt?

Punkte nicht gutgeschrieben: Zahlung muss Status „bezahlt“ haben. Stufe muss Punkte-Sammeln erlauben.

Kunde nimmt nicht teil / sammelt nicht: Im Modus „Selbst-Anmeldung“ den Anmelde-Status des Kunden prüfen — in der Konto-Liste die Spalte „Angemeldet“ und den zugehörigen Filter nutzen.

Einlösung funktioniert nicht: Eingeloggt? Genug Punkte? Reservierung prüfen — reservierte Punkte werden zeitnah beim nächsten Seitenaufruf wieder freigegeben.

Einlösefeld erscheint nicht im Warenkorb: Einstellung „Einlöse-Feld anzeigen“ aktiviert? Kunde eingeloggt? Verfügbares Guthaben > 0? Cache leeren.

Warum wird nicht das ganze eingelöste Guthaben abgezogen? Der Punkte-Rabatt wird auf den Warenkorbwert gedeckelt (Warenkorb-Begrenzung). Überschüssige Punkte bleiben als Guthaben erhalten.

Stufen werden nicht angezeigt / kein Stufenrabatt: Belohnungsstufen-Modus prüfen — bei abgeschaltetem Modus entfallen Status, Stufenrabatt und Stufen-Anzeigen.

Stufen nicht aktualisiert: Basiert auf Lifetime-Punkten, automatisch bei Gutschrift.

Import-Probleme: Nur ein Import gleichzeitig, PHP max_execution_time erhöhen.

E-Mails nicht gesendet: Einstellung aktiviert? Task Runner konfiguriert? Mailer prüfen.

Unterstützte Versionen: Shopware 6.7.x. Ältere nicht unterstützt.

Mehrsprachig: Ja, de-DE und en-GB. Stufen-Namen übersetzbar.

Programmname änderbar: Ja, unter Konfiguration > Branding.