Ultimate
Loyalty.

GkUltimateLoyalty 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.

Kernfunktionen:

• Punkte-System: Kunden verdienen Punkte bei jedem Einkauf und lösen diese als Cashback-Rabatt ein
• Belohnungsstufen: Bronze, Silber, Gold, Platin und VIP mit automatischem Aufstieg und Stufenrabatten
• 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 GkUltimateLoyalty nach custom/plugins/ kopieren
2. bin/console plugin:refresh
3. bin/console plugin:install GkUltimateLoyalty
4. bin/console plugin:activate GkUltimateLoyalty
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)
• Registrierungsbonus

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

Empfehlungssystem: Pauschal oder prozentual, Lifetime-Referral optional.

VIP: Sichtbarkeit und Punkte-Sammeln separat steuerbar.

Gratisprodukte: Engine ein/aus, Auswahlmodus, Kombinationen mit Rabatten.

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 (Lifetime), 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.

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.

Warenkorb-Voraussetzungen: Erforderliche Kategorien/Produkte.

Warenkorb-Ausschlüsse: Ausgeschlossene Kategorien/Produkte.

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

Einlösen (Cashback): Mein Konto > Mein Treuekonto → Punktzahl eingeben → Einlösen → Rabatt im Warenkorb.

Formel: Eingelöste Punkte × Wert pro Punkt.

Verfall: Konfigurierbar (Standard: 365 Tage, 0 = nie). 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.

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.

Beste Kunden: KPI-Highlights, Filter nach Zeitraum und Sortierung.

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.

Header-Badge: Punktestand und Stufe in Navigation.

Warenkorb: Fortschrittsbalken zum Gratisprodukt, Gratisprodukt-Banner, Punkte-Rabatt, Stufenrabatt, Gratisprodukt mit „GRATIS“-Badge.

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.

Einlösung funktioniert nicht: Eingeloggt? Genug Punkte? Reservierung prüfen (30 Min).

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.