> For the complete documentation index, see [llms.txt](https://docs.premsoft.de/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.premsoft.de/plugins/bonus-system/installation.md).
# Installation
Installiere das Plugin über **Erweiterungen → Meine Erweiterungen** und aktiviere es anschließend. Danach folgen zwei Schritte:
1. die **Konfiguration** — alle Einstellungen auf dieser Seite, gespeichert pro Verkaufskanal,
2. das [**Verwaltungs-Dashboard**](/plugins/bonus-system/verwaltungs-dashboard.md) — der laufende Betrieb.
Wer nur schnell starten möchte, findet im [Schnellstart](/plugins/bonus-system/schnellstart.md) die kurze Variante mit den wichtigsten Feldern.
Die Konfiguration öffnest du über **Meine Erweiterungen → Bonus System für Shopware 6 → Konfiguration**. Wähle 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](/plugins/bonus-system/weitere-menupunkte-im-account-anlegen.md). |
| 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](/plugins/bonus-system/verwaltungs-dashboard/bedingungen.md) 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](/plugins/bonus-system/artikelnummer-fur-bonus-punkte.md). |
| 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](/plugins/bonus-system/verwaltungs-dashboard/bonus-produkte-pramien.md).
| 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 legst du 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 brauchst du 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. Trägst du 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 findest du in der Produktdetailansicht unter **Zusatzfelder**.
Soll ein Faktor stattdessen für Produktgruppen, Kategorien, Kundengruppen oder Zeiträume gelten, nutze die [Bedingungen](/plugins/bonus-system/verwaltungs-dashboard/bedingungen.md).
## Danach
* [Verwaltungs-Dashboard](/plugins/bonus-system/verwaltungs-dashboard.md) — Buchungen freigeben, Punkte buchen, Prämien pflegen
* [Flow Builder und Regeln](/plugins/bonus-system/flow-builder-und-regeln.md) — Punkte automatisiert buchen
* [Geplante Aufgaben / Cronjobs](/plugins/bonus-system/geplante-aufgaben-cronjobs.md) — Freigabe, Verfall und Benachrichtigungen im Hintergrund
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://docs.premsoft.de/plugins/bonus-system/installation.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.