Bonus System
Installation
Installieren Sie das Plugin über Erweiterungen → Meine Erweiterungen und aktivieren Sie es anschließend. Danach folgen zwei Schritte:
- die Konfiguration — alle Einstellungen auf dieser Seite, gespeichert pro Verkaufskanal,
- das Verwaltungs-Dashboard — der laufende Betrieb.
Wer nur schnell starten möchte, findet im Schnellstart die kurze Variante mit den wichtigsten Feldern.
Die Konfiguration öffnen Sie über Meine Erweiterungen → Bonus System für Shopware 6 → Konfiguration. Wählen Sie oben den Verkaufskanal, für den die Einstellungen gelten sollen. Die Auswahl Alle Verkaufskanäle setzt die Standardwerte, einzelne Kanäle können davon abweichen.
Ohne die Einstellung Bonus System aktivieren im jeweiligen Verkaufskanal rendert das Plugin in der Storefront nichts.
Allgemeine Einstellungen
| Feld | Typ | Beschreibung |
|---|---|---|
| Bonus System aktivieren | Schalter | Aktiviert das Bonus System für den gewählten Verkaufskanal. |
| Bonus Punkte im Kopfbereich anzeigen | Schalter | Zeigt den Punktestand nach dem Login im Header neben dem Account-Icon. Ist die Option aus, erscheinen Stand und Link im Account-Menü. |
| Bonus Punkte auf der Rechnung anzeigen | Schalter | Weist eingesetzte und erhaltene Bonuspunkte auf dem Rechnungsdokument aus. Standard: aus. |
| Punkte Verdienst auf Detailseite von Produkten anzeigen | Schalter | Zeigt auf der Produktdetailseite, wie viele Punkte der Kauf einbringt. Standard: ein. |
| Punkte Verdienst in der Produktliste anzeigen | Schalter | Wie zuvor, aber in Produktlisten und Slidern. Standard: ein. |
| Zeigen Sie den Wert der Bonuspunkte in EUR auf der Detailseite an | Schalter | Zeigt zusätzlich den Geldwert der Punkte in Shop-Währung. Standard: aus. |
| Zeigen Sie den Wert der Bonuspunkte in EUR auf der Listingseite an | Schalter | Wie zuvor, aber in Produktlisten. Standard: aus. |
| Bonus Punkte Hinweis bei Gast Registrierung anzeigen | Schalter | Weist Kunden bei der Auswahl „Gast“ darauf hin, dass sie mit einem Kundenkonto Punkte sammeln könnten. Standard: aus. |
| Shopseiten im Bonus System Menü anzeigen | Mehrfachauswahl | Erlebniswelten-Seiten des Typs Shopseite, die im Bonus-System-Menü des Kundenkontos erscheinen. Siehe Weitere Menüpunkte. |
| Kundengruppe verbieten | Mehrfachauswahl | Kundengruppen, für die das Bonus System deaktiviert ist. |
Punkte sammeln
| Feld | Typ | Beschreibung |
|---|---|---|
| Umrechnungsfaktor (1 EUR = ? Punkte) | Zahl | Punkte je 1 EUR Bestellwert, bis zu fünf Dezimalstellen. Beispiel: 1 ergibt 10 Punkte bei 10 EUR, 0.5 ergibt 5 Punkte. |
| Bonus Punkte nach Bedingungen | Schalter | Punkte werden nur für Produkte gutgeschrieben, die über eine Bedingung vom Typ Produkte für Bonus Punkte einschließen freigegeben sind. Standard: aus. |
| Punkte ohne Versandkosten sammeln | Schalter | Versandkosten fließen nicht in die Punkteberechnung ein. |
| Punkte runden | Auswahl | Aufrunden (Standard), Logisch runden oder Abrunden für Punkte-Bruchteile. |
| Punkte für Admin/API Bestellungen erhalten | Schalter | Auch Bestellungen, die in der Administration oder über die API angelegt wurden, erzeugen Punkte. |
| Punkte für jede Bewertung | Zahl | Punkte für eine freigegebene Produktbewertung. Standard: 100. Funktioniert nur mit dem Shopware-Bewertungssystem. |
Newsletter Einstellungen
Meldet sich ein Kunde zum Newsletter an, können Punkte gutgeschrieben werden. Das funktioniert nur mit der Shopware-Standard-Newsletter-Anmeldung.
| Feld | Typ | Beschreibung |
|---|---|---|
| Bonus Punkte für die Newsletter Registrierung vergeben | Schalter | Aktiviert die Gutschrift bei der Newsletter-Anmeldung. Standard: aus. |
| Menge der Bonus Punkte für die Newsletter Registrierung | Zahl | Anzahl der Punkte für die Anmeldung. |
| Buchungsgrund für die Bonus Punkte | Textbaustein | Snippet, dessen Text später als Buchungsgrund erscheint (Standard: Newsletter Registrierung). |
Punkte ausgeben
| Feld | Typ | Beschreibung |
|---|---|---|
| Punkte ausgeben deaktivieren | Schalter | Kunden sammeln weiter Punkte, können sie aber nicht als Gutschein einlösen. |
| Beschränkung für Punkte Einlösung | Auswahl | Mindestens noch X EUR Bestellwert oder Maximal X EUR Gutscheinwert. Der Wert X folgt im nächsten Feld. |
| EUR Wert der Beschränkung | Zahl | Wert X zur vorherigen Einstellung. |
| EUR Min. Wert für Bonus Produkt | Zahl | Mindest-Warenkorbwert, ab dem ein Bonus Produkt bestellt werden kann. |
| Mindestanzahl von Punkten für die Einlösung | Zahl | Unterhalb dieses Punktestands ist keine Einlösung möglich; die Storefront weist darauf hin. Standard: 0 (keine Grenze). |
| Umrechnungsfaktor (? Punkte = 1 EUR) | Zahl | Punkte je 1 EUR Rabatt. Beispiel: 20 bedeutet 20 Punkte für 1 EUR. Standard: 0 — dann ist keine Einlösung möglich. |
| Einlösen von Punkten für den Versand ausschließen | Schalter | Versandkosten können nicht mit Punkten bezahlt werden. |
| Bonus Punkte automatisch bei Bestellung einlösen | Schalter | Vorhandenes Guthaben wird ohne Zutun des Kunden eingelöst. Standard: aus. |
| Deaktivieren von Gutscheinen, wenn Punkte im Warenkorb eingelöst werden | Schalter | Andere Gutscheine werden entfernt, sobald Punkte eingelöst werden. Standard: aus. |
| Fehlermeldungen bei Gutscheinen im Warenkorb ausblenden | Schalter | Unterdrückt die Hinweise über entfernte Gutscheine aus der vorherigen Option. Standard: aus. |
| Bonuspunkte-Artikelnummer | Text | Artikelnummer für die Punkte-Position im Warenkorb, z. B. für die Warenwirtschaft. Details unter Artikelnummer für Bonus Punkte. |
| Bonuspunkte-Artikelnummer im Warenkorb anzeigen | Schalter | Zeigt diese Artikelnummer in Warenkorb und Checkout an. Standard: aus. |
| Art der Punkteeinlösung | Auswahl | Bedienelement in der Storefront: Slider (Standard), Zahlfeld + Button oder Button — der Button löst direkt das mögliche Maximum ein. |
Bonus Produkte
Bonus Produkte sind Prämien: bestehende Shop-Produkte, die mit Punkten bestellt werden können. Angelegt werden sie im Admin-Modul unter Bonus Produkte / Prämien.
| Feld | Typ | Beschreibung |
|---|---|---|
| Bonus Produkte aktivieren | Schalter | Schaltet die Prämien-Funktion ein. Ohne diese Option bleiben angelegte Bonus Produkte in der Storefront unsichtbar. |
| Standardmäßig mit Punkten kaufen | Schalter | Ist „Nur mit Punkten erwerbbar“ beim Bonus Produkt aus, wird die Option „Für je X Bonus Punkte in den Warenkorb“ vorausgewählt. Standard: aus. |
| Bonus Produkte Menü Eintrag deaktivieren | Schalter | Deaktiviert die Landingpage /bonus-products und den zugehörigen Menüeintrag. |
| Aktivieren Sie die Bonusproduktfunktion für jedes Produkt | Schalter | Jedes Produkt des Shops kann mit Punkten erworben werden — ohne einzelne Bonus Produkte anzulegen. |
| Verfügbare Bonusprodukte im Warenkorb anzeigen | Schalter | Zeigt einen Slider mit verfügbaren Prämien im Warenkorb. Standard: aus. |
| Verfügbare Bonusprodukte im Checkout anzeigen | Schalter | Wie zuvor, im Checkout. Standard: aus. |
| Anzahl der Bonusprodukte im Slider | Zahl | Maximale Anzahl Prämien im Slider. Standard: 24. |
| Position der Slider-Steuerelemente | Auswahl | Keine, Innen oder Außen (Standard) für die Pfeile des Sliders. |
| Bonus Produkte Liste Header Bild | Bild | Header-Bild auf der Prämien-Listenseite. |
| Bonus Produkte Liste Header Text | Text | Header-Text auf der Prämien-Listenseite. |
Bonuspunkte Aktivierung
Hier legen Sie fest, wann gesammelte Punkte für den Kunden nutzbar werden.
| Feld | Typ | Beschreibung |
|---|---|---|
| Bonuspunkte Aktivierung Bestellung | Auswahl | Immer manuell (Freigabe im Admin-Modul), Bestellung bezahlt, Bestellung abgeschlossen, Direkt nach Bestellung oder Bestellung versendet. |
| Aktivierungsbedingung für Bonuspunkte | Auswahl | Verknüpfung zwischen dem Ereignis oben und der Freigabe nach n Tagen: ODER (Standard, eine Bedingung genügt) oder UND (beide müssen erfüllt sein). |
| Bonuspunkte n-Tage nach Bestellung freischalten | Zahl | Zeitgesteuerte Freigabe nach n Tagen — leer oder 0 bedeutet keine zeitgesteuerte Freigabe. Die Freigabe erfolgt beim nächsten Login des Kunden oder über die geplante Aufgabe. Bereits freigegebene Punkte bleiben unberührt. |
Abzug von Punkten
| Feld | Typ | Beschreibung |
|---|---|---|
| Abzug von Punkten beim Bestellstatus: Abgebrochen | Schalter | Entfernt die gutgeschriebenen Punkte, wenn die Bestellung storniert wird. |
| Abzug von Punkten bei Lieferstatus: Retour | Schalter | Entfernt die gutgeschriebenen Punkte beim Lieferstatus Retour. |
| Abzug von Punkten bei Lieferstatus: Teilretour | Schalter | Entfernt die gutgeschriebenen Punkte beim Lieferstatus Teilretour. |
Verfall der Punkte
| Feld | Typ | Beschreibung |
|---|---|---|
| Bonus Punkte verfallen nach Tagen | Zahl | Ist der Wert größer als 0, werden abgelaufene Punkte (heute minus n Tage) vom Punktekonto entfernt. Standard: 0. |
| Zeige nach dem Login einen Hinweis, das Punkte bald verfallen | Schalter | Einmaliger Hinweis nach dem Login. Standard: ein. |
| Automatische E-Mail für den Ablauf von Punkten aktivieren | Schalter | Versendet die E-Mail-Vorlage Bonuspunkte Ablaufbenachrichtigung. Standard: aus. |
| Kunde kann sich von der Liste abmelden | Schalter | Kunden verwalten das Abonnement selbst im Punktekonto. Standard: aus. |
| E-Mail Anzahl Tage vor Ablauf der Punkte | Zahl | Vorlaufzeit der Benachrichtigung. Standard: 7. |
Checkout Einstellungen
| Feld | Typ | Beschreibung |
|---|---|---|
| Bonus Punkte für Bestellung im Warenkorb anzeigen | Auswahl | Nein, Oberhalb vom Warenkorb oder Unterhalb vom Warenkorb — zeigt die Punkte, die die Bestellung einbringt. |
| Bonus Punkte Einlösung im Checkout möglich | Auswahl | Punkte sind regulär nur im Warenkorb einlösbar; hier zusätzlich Oberhalb oder Unterhalb vom Checkout freischaltbar. |
| Bonus Punkte für Bestellung im Checkout anzeigen | Auswahl | Nein, Oberhalb oder Unterhalb vom Checkout. |
Design Einstellungen
| Feld | Typ | Beschreibung |
|---|---|---|
| Buchstabe Farbe | Farbwähler | Farbe des „P“-Icons. Standard: #ffffff. |
| Buchstabe Hintergrund Farbe | Farbwähler | Hintergrund des „P“-Icons. Standard: #f1c40f. |
| Badge Farbe | Farbwähler | Hintergrund des Punkte-Badges. Standard: #fbf5db. |
| Farbe Punkte Text | Farbwähler | Textfarbe der Punktangabe. Standard: #ae8e0a. |
| Farbe Slider Punkt | Farbwähler | Farbe des Einlöse-Sliders. Standard: #f1c40f. |
| Icon für Punkte Label (50×50 Pixel) | Bild | Ersetzt den Buchstaben „P“ durch ein eigenes Icon. |
Technische Einstellungen
Diese Optionen brauchen Sie nur in Sonderfällen.
| Feld | Typ | Beschreibung |
|---|---|---|
| Punkte für den customLineItemType kalkulieren | Schalter | Nur nötig, wenn Drittanbieter-Erweiterungen wie Konfiguratoren eigene Positionen erzeugen und dafür keine Punkte berechnet werden. Im Normalfall aus lassen. |
| Whitelist: Custom Line Items | Text | Zusätzliche Line-Item-Typen von Drittanbietern, die Punkte erhalten sollen — mehrere Typen mit Komma trennen, z. B. line-item-type-1,line-item-type-2. |
| Logging aktivieren | Schalter | Schreibt Logdateien des Bonus Systems in den Ordner var/log. Nur zur Fehlersuche aktivieren. Standard: aus. |
Bonus Punkte je Produkt (Zusatzfeld)
Bei der Installation wird das Zusatzfeld-Set Bonus System mit dem Produktfeld Bonus Punkte bei Kauf des Produktes angelegt. Tragen Sie dort bei einem Produkt einen Wert größer 0 ein, erhält der Kunde diese Punkte je gekaufter Menge — zusätzlich zur Berechnung über den Umrechnungsfaktor. Das Feld finden Sie in der Produktdetailansicht unter Zusatzfelder.
Soll ein Faktor stattdessen für Produktgruppen, Kategorien, Kundengruppen oder Zeiträume gelten, nutzen Sie die Bedingungen.
Danach
- Verwaltungs-Dashboard — Buchungen freigeben, Punkte buchen, Prämien pflegen
- Flow Builder und Regeln — Punkte automatisiert buchen
- Geplante Aufgaben / Cronjobs — Freigabe, Verfall und Benachrichtigungen im Hintergrund