FAQ

Prüfen Sie folgende Punkte:

• Cross-Selling-Gruppe: Ist am Produkt eine Cross-Selling-Gruppe mit dem exakten Namen „Geschenke“ (oder dem in giftCrossSellingName konfigurierten Namen) angelegt?
• giftSelectOption: Ist die Einstellung auf true gesetzt?
• Kampagnen-Datum: Liegt das aktuelle Datum innerhalb des konfigurierten Kampagnen-Zeitraums (globalGiftStartDate / globalGiftEndDate)?
• Kundengruppe: Ist Ihre Kundengruppe möglicherweise in disallowedCustomerGroupIds eingetragen?
• Cache: Leeren Sie den Shopware-Cache mit bin/console cache:clear.

Produkt-Geschenke (Zuweisung direkt am Artikel):

• giftQuantity = true: Die Geschenk-Menge entspricht der Produkt-Menge. Bei 3x Produkt A im Warenkorb werden auch 3x das gewählte Geschenk hinzugefügt.
• giftQuantity = false: Pro Produkt-Zuweisung wird genau 1 Geschenk hinzugefügt, unabhängig von der Produkt-Menge.

Kategorie-Geschenke ab v7 (Zuweisung an einer Kategorie):

• giftQuantity = true: Alle Artikel der Kategorie im Warenkorb werden zusammengezählt. Aus 3x Rotwein und 2x Weißwein (beide in Kategorie „Wein“) wird eine Geschenk-Position mit Menge 5.
• giftQuantity = false: Pro Kategorie gibt es genau 1 Geschenk — egal wie viele Artikel dieser Kategorie im Warenkorb liegen. Geschenke aus unterschiedlichen Kategorien bleiben nebeneinander bestehen.

Ist ein Geschenk sowohl auf Produkt- als auch auf Kategorie-Ebene konfiguriert, hat die Produkt-Zuweisung Vorrang. Mehr Details: Kategorie-Geschenke (ab v7).

Tragen Sie die Kundengruppen-IDs komma-getrennt in das Feld disallowedCustomerGroupIds ein. Sie finden die Kundengruppen-IDs in der Shopware-Administration unter Einstellungen > Shop > Kundengruppen. Kopieren Sie die UUID der jeweiligen Gruppe.

Beispiel: 018a1b2c3d4e5f6g,018a1b2c3d4e5f7h

Verwenden Sie die Felder globalGiftStartDate und globalGiftEndDate in der Plugin-Konfiguration. Geben Sie das gewünschte Start- und Enddatum im Datetime-Format ein.

• Wenn nur ein Startdatum gesetzt ist, werden Geschenke ab diesem Zeitpunkt dauerhaft angezeigt.
• Wenn nur ein Enddatum gesetzt ist, werden Geschenke bis zu diesem Zeitpunkt angezeigt.
• Wenn beide Daten gesetzt sind, werden Geschenke nur innerhalb dieses Zeitraums angezeigt.
• Wenn kein Datum gesetzt ist, werden Geschenke immer angezeigt.

Das hängt von der Einstellung remover ab:

• remover = true (Standard): Geschenke können einzeln aus dem Warenkorb entfernt werden.
• remover = false: Geschenke können nicht separat entfernt werden. Sie werden automatisch entfernt, wenn das zugehörige Hauptprodukt aus dem Warenkorb gelöscht wird.

1. Öffnen Sie das gewünschte Produkt in der Shopware-Administration.
2. Wechseln Sie zum Tab „Cross-Selling“.
3. Erstellen Sie eine neue Cross-Selling-Gruppe mit dem Namen „Geschenke“ (oder dem in giftCrossSellingName konfigurierten Namen).
4. Wählen Sie den Typ „Manuelle Auswahl“.
5. Fügen Sie die gewünschten Geschenk-Produkte hinzu.
6. Speichern Sie das Produkt.

Die Geschenke erscheinen nun auf der Produktdetailseite und beim Hinzufügen zum Warenkorb.

Wenn Geschenke sowohl in der Geschenk-Auswahl als auch im normalen Cross-Selling-Bereich angezeigt werden, aktivieren Sie die Einstellung removefromcross (Standard: true). Diese entfernt die Geschenk-Gruppe aus der regulären Cross-Selling-Anzeige.

Eigenschaft	Geschenk-Modus	Zubehör-Modus
Preis	Kostenlos (0,00)	Regulärer Produktpreis
Auswahl	Dropdown oder Checkboxen	Checkboxen mit Mengenfeld
Mehrfachauswahl	Optional (via giftCheckboxes)	Immer aktiv
Mengenauswahl	An Hauptprodukt gekoppelt	Frei wählbar
Layout	Standard-Geschenk-Layout	Eigenes Zubehör-Layout

Aktivieren Sie den Zubehör-Modus mit giftoraccessorie = true. Dies überschreibt die Geschenk-Konfiguration.

Prüfen Sie folgende Punkte:

• addBadge: Ist die Einstellung auf true gesetzt?
• Geschenke zugewiesen: Hat das Produkt tatsächlich eine Cross-Selling-Gruppe mit Geschenken?
• Theme kompiliert: Führen Sie bin/console theme:compile aus, um sicherzustellen, dass die Storefront-Templates aktuell sind.
• Cache: Leeren Sie den Cache mit bin/console cache:clear.

Ja. Verwenden Sie die Einstellung badgeGiftColor, um die Hintergrundfarbe des Badges zu ändern. Der Standardwert ist #146ff9 (Blau). Geben Sie einen beliebigen HEX-Farbwert ein.

Zusätzlich können Sie mit rowGiftColor die Hintergrundfarbe der ausgewählten Geschenk-Zeile in der Auswahl anpassen (Standard: #eeeeee).