# Installation Installieren Sie die App durch **Erweiterungen** > **Meine Erweiterungen**. Geben Sie nach der Installation einen **Verkaufskanal** an, für den die App aktiviert werden soll. Die Standardeinstellung ist Alle Verkaufskanäle. Die Bonussystem-App hat zwei Aspekte: * Grundlegende Konfiguration * Verwaltungs-Dashboard Führen Sie zunächst die Schritte im Abschnitt Basiskonfiguration aus und lesen Sie dann den Abschnitt Admin Dashboard, um zu erfahren, wie Sie die App fortlaufend verwalten können. ### Grundlegende Konfiguration Bevor Sie die App aktivieren, überprüfen Sie die Einstellungen in diesem Abschnitt und stellen Sie sicher, dass sie Ihren Anforderungen entsprechen. Nehmen Sie Änderungen an den einzelnen Feldern wie unten beschrieben vor, indem Sie **Meine Erweiterungen** > **Bonus System für Shopware 6** > **Konfiguration** wählen.
Geben Sie zunächst einen **Verkaufskanal** an, für den die App aktiviert werden soll. Die Standardeinstellung ist Alle Verkaufskanäle. ### Allgemeine Einstellungen Die allgemeinen Eigenschaften bieten grundlegende Steuerelemente, wie z. B. die Aktivierung/Deaktivierung der App und die Festlegung der Sichtbarkeit von Kundenpunkten an wichtigen Standorten. | **Feld** | **Typ** | **Beschreibung** | | ------------------------------------------------------------------ | ------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Bonus System aktivieren | KippSch. | Aktivieren Sie diese Einstellung, um die Bonus-System-App in Ihrem Shop zu aktivieren. | | Bonus Punkte im Kopfbereich anzeigen | KippSch. | Aktivieren Sie diese Einstellung, um den Punktestand des Kunden im oberen rechten Bereich der Kopfzeile des Shops neben den Konto- und Warenkorbkontrollen anzuzeigen. | | Bonus Punkte auf der Rechnung anzeigen | KippSch. | Aktivieren Sie diese Einstellung, um den Punktestand des Kunden in allen Rechnungen anzuzeigen, die er aufgrund von Einkäufen im Shop erhält. | | Punkte Verdienst auf Detailseite von Produkten anzeigen | KippSch. | Aktivieren Sie diese Einstellung, um auf der Produktdetailseite die Anzahl der Punkte anzuzeigen, die Kunden für jeden Produktkauf gutgeschrieben werden. | | Punkte Verdienst in der Produktliste anzeigen | KippSch. | Aktivieren Sie diese Einstellung, um in der Produktliste die Anzahl der Punkte anzuzeigen, die Kunden für jeden Produktkauf gutgeschrieben werden. | | Bonus Punkte Hinweis bei Gast Registrierung anzeigen | KippSch. | Wenn die Option aktiv ist, dann wird dem Kunden bei Auswahl der Gast Registrierung ein Hinweis angezeigt, das er mit einem Kundenkonto Punkte sammeln könnte. | | Kundengruppe verbieten | Dropdown-Menü | Wenn Sie Kundengruppen definiert haben, können Sie diese vom Punktesystem ausschließen, indem Sie sie aus dem Dropdown-Menü auswählen. | | Zeigen Sie den Wert der Bonuspunkte in EUR auf der Detailseite an | KippSch. | Die benötigten Bonus Punkte werden in der Shop Währung angezeigt. Somit kann der Kunde genau sehen, wie viel Geld Wert die Bonus Punkte haben. | | Zeigen Sie den Wert der Bonuspunkte in EUR auf der Listingseite an | KippSch. | Die benötigten Bonus Punkte werden in der Shop Währung angezeigt. Somit kann der Kunde genau sehen, wie viel Geld Wert die Bonus Punkte haben. | | Shopseiten im Bonus System Menü anzeigen | Dropdown-Menü | Sie können Erlebnisswelten Seiten des Typs "Shopseite" auswählen, die nach dem Kundenlogin im Accountbereich des Bonus System Menüs angezeigt werden sollen. | ### Punkte sammeln Die Einstellungen in diesem Bereich beziehen sich darauf, wie Kunden Punkte gutgeschrieben werden. | **Feld** | **Typ** | **Beschreibung** | | ------------------------------------------- | ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | Umrechnungsfaktor (1 EUR = ? Punkte) | Numerische Eingabe | Fügen Sie hier einen Wert für die Anzahl der Punkte ein, die Kunden pro ausgegebenem Euro gutgeschrieben werden. *Beispiel: Geben Sie 10 ein, um 10 Punkte pro ausgegebenem Euro zu erhalten.* | | Bonus Punkte nach Bedingungen | KippSch. | Ist diese Option aktiv dann erhalten Kunden nur Bonus Punkte für Produkte, die per [Bedingung ](https://docs.premsoft.de/plugins/bonus-system/verwaltungs-dashboard/bedingungen)festgelegt sind. | | Punkte ohne Versandkosten sammeln | KippSch. | Aktivieren Sie diese Einstellung, um die Versandkosten vom Sammeln von Kundenpunkten auszuschließen. | | Punkte runden | Dropdown-Menü | Wählen Sie aus der Dropdown-Liste die Methode zum Aufrunden von kumulierten Punktbruchteilen aus, entweder **logisch runden, aufrunden** oder **abrunden**. | | Punkte für Admin/ API Bestellungen erhalten | KippSch. | Wenn aktiviert, dann erhalten Kunden auch Punkte für Bestellung, die in der Admin oder über die API erstellt wurden. | | Punkte für jede Bewertung | Numerische Eingabe | Geben Sie eine Anzahl an Punkten an, die Kunden für eine Bewertung eines Produktes erhalten. Dies funktioniert nur, wenn das reguläre Bewertungssystem von Shopware genutzt wird. | ### Newsletter Einstellungen Registriert sich ein Kunde für den Newsletter so können Punkte vergeben werden. \ Wichtig: Dies funktioniert nur, wenn die Shopware Standard Newsletter Registrierung verwendet wird. | | | | | ------------------------------------------------------- | ------------------ | ----------------------------------------------------------------------------------------------------- | | **Feld** | **Typ** | **Beschreibung** | | Bonus Punkte für die Newsletter Registrierung vergeben | KippSch. | Aktivieren Sie die Einstellung, wenn Kunden Punkte für eine Newsletter Registrierung erhalten sollen. | | Menge der Bonus Punkte für die Newsletter Registrierung | Numerische Eingabe | Geben Sie die Anzahl an Punkten an, die ein Kunde für die Registrierung zum Newsletter erhalten soll. | | Buchungsgrund für die Bonus Punkte | Dropdown-Menü | Wählen Sie hier einen Textbaustein dessen Inhalt später bei der Punkte Buchung erscheinen soll. | ### Punkte ausgeben Die Einstellungen in diesem Bereich beziehen sich darauf, wie Kunden die ihnen gutgeschriebenen Punkte einlösen können. | **Feld** | **Typ** | **Beschreibung** | | ----------------------------------------------------------------------- | ------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Punkte ausgeben deaktivieren | KippSch. | Aktivieren Sie diese Einstellung, um zu verhindern, dass Kunden Punkte einlösen können, die ihnen gutgeschrieben wurden (Kunden können weiterhin Punkte gutgeschrieben bekommen, solange diese Einstellung aktiviert ist). | | Beschränkung für Punkte Einlösung | Dropdown-Menü | Legen Sie optional eine Mindest-/Maximalbeschränkung für das Einlösen von Punkten durch Kunden fest. Wählen Sie entweder **Mindestens X EUR Bestellwert** oder **Maximal X EUR** aus dem Dropdown-Menü. Definieren Sie den Wert X in der nächsten Einstellung. | | EUR Wert der Beschränkung | Numerische Eingabe | Geben Sie den Wert X für alle in der vorherigen Einstellung festgelegten Einschränkungen ein. | | EUR Min. Wert für Bonus Produkt | Numerische Ein | Min. Warenkorbwert, ab dem der Kauf eines Bonus Produktes möglich ist. | | Umrechnungsfaktor (? Punkte = 1 EUR) | Numerische Eingabe |

Geben Sie einen Zahlenwert für die Anzahl der eingelösten Punkte ein, die erforderlich sind, um einen Wert von 1 Euro zu erreichen.
Beispiel: 20 = 20 Punkte für 1 Euro.

| | Einlösen von Punkten für den Versand ausschließen | KippSch | Wenn aktiviert, können Versandkosten nicht mit Bonus Punkten bezahlt werden. | | Bonus Produkte aktivieren | KippSch. | Aktivieren Sie diese Einstellung, um Kunden zu ermöglichen, bestimmte Bonusprodukte zu kaufen, indem sie die gesammelten Punkte einlösen. | | Standardmäßig mit Punkten kaufen | KippSch. | Wenn die Option „Nur mit Punkten kaufbar“ eines Bonusprodukts nicht aktiv ist, wird standardmäßig die Option „Für je X Bonuspunkte in den Warenkorb legen“ verwendet. | | Bonus Produkte Menü Eintrag deaktivieren | KippSch. | Durch die Aktivierung wird die Landingpage der Bonus Produkte deaktiviert. Diese Einstellung hat nur einen Effekt, wenn Sie Bonus Produkte aktiviert haben. | | Aktivieren Sie die Bonusproduktfunktion für jedes Produkt | KippSch. | Wenn aktiviert, so kann jedes Produkt des Shops mit Bonus Punkten erworben werden. | | Verfügbare Bonusprodukte im Warenkorb anzeigen | KippSch. | Zeigt alle verfügbaren Bonus Produkten im Warenkorb. | | Verfügbare Bonusprodukte im Checkout anzeigen | KippSch. | Zeigt alle verfügbaren Bonus Produkten im Checkout. | | Bonus Produkte Liste Header Bild | Bildauswahl | Zeigt ein Header Bild auf der Bonus Produkte Listing Seite. Es wird nur angezeigt, wenn Bonus Produkte aktiviert sind. | | Bonus Produkte Liste Header Text | Freie Texteingabe | Zeigt einen Header Text auf der Bonus Produkte Listing Seite. Es wird nur angezeigt, wenn Bonus Produkte aktiviert sind. | | Bonus Punkte automatisch bei Bestellung einlösen | KippSch. | Wenn aktiviert, dann werden Bonus Punkte automatisch im Checkout eingelöst. | | Deaktivieren von Gutscheinen, wenn Punkte im Warenkorb eingelöst werden | KippSch. | Wenn aktiviert und Bonus Punkte eingelöst werden, dann werden andere Gutscheine automatisch deaktiviert. | | Bonuspunkte-Artikelnummer | Freie Texteingabe |

Falls benötigst, kannst du eine Artikelnummer für Bonus Punkte festlegen. Diese wird genutzt, wenn Bonus Punkte eingelöst werden.
Hier findest Du mehr Informationen.

| | Bonuspunkte-Artikelnummer im Warenkorb anzeigen | KippSch. | Sollen Bonus Punkte eine Artikelnummer haben, so kannst Du festlegen, ob die Artikelnummer im Checkout angezeigt wird. | ### Abzug von Punkten Mit den Einstellungen in diesem Bereich können Sie steuern, wie die Erweiterung Rücksendungen handhabt. | | | | | ----------------------------------------------- | -------- | --------------------------------------------------------------------------------------------- | | **Feld** | **Typ** | **Beschreibung** | | Abzug von Punkten beim Bestellstatus: Storniert | KippSch. | Entfernt die zuvor gutgeschriebenen Punkte, wenn der Bestellstatus auf storniert gesetzt ist. | | Abzug von Punkten bei Lieferstatus: Retour | KippSch. | Entfernt die zuvor gutgeschriebenen Punkte, wenn der Lieferstatus auf Retour gesetzt ist. | | Abzug von Punkten bei Lieferstatus: Teilretour | KippSch. | Entfernt die zuvor gutgeschriebenen Punkte, wenn der Lieferstatus auf Teilretour gesetzt ist. | ### Punkte Verfall In diesem Bereich können Sie festlegen, ob Punkte ablaufen können und wie dies gehandhabt wird. | | | | | ------------------------------------------------------------- | ------------------ | ----------------------------------------------------------------------------------------------------------------- | | **Feld** | **Typ** | **Beschreibung** | | Bonus Punkte verfallen nach Tagen | Numerische Eingabe | Wenn der Wert größer 0 ist, werden die Punkte die abgelaufen sind (Heute - Eingabe Tage) vom Kundenkonto entfernt | | Zeige nach dem Login einen Hinweis, das Punkte bald verfallen | KippSch. | Verfallen bald Punkte, so wird dies einmalig nach dem Kunden Login angezeigt. | | Automatische E-Mail für den Ablauf von Punkten aktivieren | KippSch. | Verfallen bald Punkte, so kann der Kunde automatisch per E-Mail darüber informiert werden. | | Kunde kann sich von der Liste abmelden | KippSch. | Mit dieser Option können Kunden sich von der automatischen E-Mail Benachrichtigung abmelden. | | E-Mail Anzahl Tage vor Ablauf der Punkte | Numerische Eingabe | Die automatische E-Mail Benachrichtigung wird automatisch n-Tag vor Verfall der Punkte versendet. | ### Bonuspunkte Aktivierung Die Einstellungen in diesem Bereich steuern die Aktivierung und den Verfall von Bonuspunkten. | **Feld** | **Typ** | **Beschreibung** | | ----------------------------------------------- | ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Bonuspunkte Aktivierung Bestellung | Dropdown-Menü |

Legen Sie fest, wie die Bonuspunkte aktiviert werden, indem Sie eine Option aus dem Dropdown-Menü auswählen:
– Immer manuell: über das Admin-Modul
– Bestellung bezahlt: Bonuspunkte werden automatisch aktiviert, nachdem die Bestellung bezahlt wurde
– Bestellung abgeschlossen: Bonuspunkte werden gutgeschrieben, sobald der Bestellstatus auf abgeschlossen gesetzt wird
– Direkt nach Bestellung: Bonuspunkte werden nach dem Absenden der Bestellung gutgeschrieben

| | Bonuspunkte n-Tage nach Bestellung freischalten | Numerische Eingabe | Diese Einstellung kann die Einstellung von „Bonuspunkte Aktivierung Bestellung“ umgehen. Ist das Feld nicht ausgefüllt oder hat den Wert 0, so erfolgt keine automatische Freischaltung nach n-Tagen.Ansonsten wird die Bestellung beim nächsten Login des Kunden nach n-Tagen freigeschaltet und die Bonus Punkte gutgeschrieben. Wurden die Bonuspunkte bereits manuell oder über eine andere Regel freigeschaltet, so hat die Einstellung keinen Effekt. | | Punkte abziehen bei Stornierung Bestellung | KippSch. | Aktivieren Sie diese Option, um automatisch alle gutgeschriebenen Punkte, die mit einer stornierten Bestellung verbunden sind, abzuziehen. | | Bonus Punkte verfallen nach Tagen | Numerische Eingabe | Legen Sie die Anzahl der gültigen Tage für Bonuspunkte fest, nach denen sie automatisch verfallen und vom Punktekonto des Kunden abgezogen werden. | ### Checkout Einstellungen Die Einstellungen in diesem Bereich steuern, wie die Bonuspunkte den Kunden während des Bestellvorgangs gutgeschrieben werden | **Feld** | **Typ** | **Beschreibung** | | ------------------------------------------------- | ------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Bonus Punkte für Bestellung im Warenkorb anzeigen | Dropdown-Menü | Wählen Sie, ob Sie die Bonuspunkte anzeigen möchten, die dem Kunden gutgeschrieben werden, wenn er den Bestellvorgang abschließt, entweder **oberhalb von Warenkorb**, **unterhalb von Warenkorb** oder **nein**, um diese Option zu deaktivieren. | | Bonus Punkte Einlösung im Checkout möglich | Dropdown-Menü | Standardmäßig können Bonuspunkte nur im Einkaufswagen eingelöst werden. Geben Sie optional an, ob Bonuspunkte auch **oberhalb vom Checkout** oder **unterhalb vom Checkout** eingelöst werden können (Standard ist **nein**). | | Bonus Punkte für Bestellung im Checkout anzeigen | Dropdown-Menü | Geben Sie an, ob und wo dem Benutzer angezeigt werden soll, wie viele Punkte mit der aktuellen Bestellung gutgeschrieben werden. Wählen Sie zwischen **„Nein“, „Über der Kasse“** und „**Unter der Kasse“.** | ### Design Einstellungen Die Einstellungen in diesem Bereich definieren das Aussehen und die Bedienung der Bonuspunkte-Benutzeroberfläche in Ihrem Shop. | **Feld** | **Typ** | **Beschreibung** | | ----------------------------------- | ----------- | -------------------------------------------------------------------------------------------------------------------------------- | | Buchstabe Farbe | Farbwähler | Wählen Sie eine Primärfarbe mit dem Farbwähler aus oder geben Sie einen Hexadezimalwert für das Bonuspunkte-Symbol „P“ ein. | | Buchstabe Hintergrund Farbe | Farbwähler | Wählen Sie mit dem Farbwähler eine Hintergrundfarbe aus oder geben Sie einen Hexadezimalwert für das Bonuspunktesymbol „P“ ein. | | Badge Farbe | Farbwähler | Wählen Sie eine Hintergrundfarbe mit dem Farbwähler oder geben Sie einen Hexadezimalwert für das Abzeichensymbol ein. | | Farbe Punkte Text | Farbwähler | Wählen Sie eine Hintergrundfarbe mit dem Farbwähler oder geben Sie einen Hexadezimalwert für den numerischen Bonuspunktwert ein. | | Farbe Slider Punkt | Farbwähler | Wählen Sie eine Hintergrundfarbe mit dem Farbwähler oder geben Sie einen hexadezimalen Wert für den Schieberegler ein. | | Icon für Punkte Label (50×50 Pixel) | Bildauswahl | Wählen Sie ein Bild (50 x 50 Pixel) aus, das als Symbol für die Punktebeschriftung verwendet werden soll. |