Installation & Konfiguration

DasGift in Shopware 6 einrichten

Installation

  1. Plugin-Ordner in custom/plugins/SvenDasGift/ ablegen
  2. Plugin-Liste aktualisieren: 
    bin/console plugin:refresh
  3. Plugin installieren und aktivieren: 
    bin/console plugin:install --activate SvenDasGift
  4. Storefront-Assets kompilieren: 
    bin/console theme:compile
  5. Cache leeren: 
    bin/console cache:clear
✓
Nach der Installation werden Geschenke bzw. Zubehör automatisch auf der Produktdetailseite und beim Hinzufügen zum Warenkorb angezeigt — vorausgesetzt, Cross-Selling-Gruppen sind konfiguriert.

Konfiguration

Die Konfiguration finden Sie unter Erweiterungen > Meine Erweiterungen > DasGift > Konfigurieren.

Cross-Selling

Diese Einstellungen steuern die Verknüpfung zwischen Produkten und ihren Geschenken/Zubehörartikeln über die Shopware Cross-Selling-Funktion.

Einstellung Typ Standard Beschreibung
giftSelectOption Bool true Aktiviert die Produkt-Cross-Selling-Integration. Wenn aktiv, werden die Geschenke aus der Cross-Selling-Gruppe des Produkts geladen.
giftCrossSellingName Text Geschenke Name der Cross-Selling-Gruppe, aus der die Geschenke/Zubehörartikel geladen werden. Muss exakt mit dem Namen in der Produktkonfiguration übereinstimmen.
removefromcross Bool true Entfernt die Geschenk-Cross-Selling-Gruppe aus der normalen Cross-Selling-Anzeige auf der Produktdetailseite, damit Geschenke nicht doppelt erscheinen.
ⓘ
Cross-Selling einrichten: Gehen Sie zum gewünschten Produkt in der Administration, wählen Sie den Tab „Cross-Selling“, erstellen Sie eine neue Gruppe mit dem Namen „Geschenke“ (oder dem in giftCrossSellingName konfigurierten Namen) und fügen Sie die gewünschten Geschenk-Produkte hinzu.

Zubehör-Modus

Im Zubehör-Modus werden die Produkte als kostenpflichtige Zubehörartikel angeboten — mit Checkboxen, Mehrfachauswahl und freier Mengenauswahl.

Einstellung Typ Standard Beschreibung
giftoraccessorie Bool false Aktiviert den Zubehör-Modus. Überschreibt die Geschenk-Konfiguration: Geschenke werden stattdessen als kostenpflichtige Zubehörartikel mit eigenem Frontend-Layout angezeigt. Ermöglicht Checkboxen, Mehrfachauswahl und freie Mengenangabe.
⚠
Hinweis: Wenn der Zubehör-Modus aktiviert ist, werden einige Geschenk-spezifische Einstellungen (z.B. „Kein Geschenk“-Option, Mengenabgleich) überschrieben. Die Zubehörartikel behalten ihren regulären Preis.

Geschenk-Konfiguration

Diese Einstellungen gelten für den Geschenk-Modus und steuern das Verhalten der Geschenk-Auswahl.

Einstellung Typ Standard Beschreibung
giftQuantity Bool true Passt die Geschenk-Menge automatisch an die Artikel-Menge an. Bei 3x Hauptprodukt werden auch 3x Geschenk hinzugefügt.

Ab v7: Bei Kategorie-zugewiesenen Geschenken werden die Mengen aller Artikel dieser Kategorie aufsummiert und zu einer einzigen Geschenk-Position zusammengefasst. Details siehe Abschnitt Kategorie-Geschenke (ab v7).
giftOption Bool true Zeigt eine „Kein Geschenk“-Option in der Auswahl an, damit der Kunde auch kein Geschenk wählen kann.
giftCheckboxes Bool false Zeigt Geschenke als Checkboxen statt als Dropdown an. Ermöglicht die Auswahl mehrerer Geschenke gleichzeitig.
addAll Bool false Alle Geschenke sind standardmäßig ausgewählt. Nur in Kombination mit Checkboxen sinnvoll.
removeNone Bool false Alle Geschenke werden standardmäßig hinzugefügt, ohne dass der Kunde die Auswahl ändern kann.
remover Bool true Erlaubt das Entfernen von Geschenken aus dem Warenkorb. Wenn deaktiviert, können Geschenke nicht einzeln entfernt werden.
disallowedCustomerGroupIds Text — Komma-getrennte Liste von Kundengruppen-IDs, die von der Geschenk-Funktion ausgeschlossen werden sollen. Diese Kundengruppen sehen keine Geschenke.
globalGiftStartDate Datetime — Startdatum für die Geschenk-Kampagne. Vor diesem Datum werden keine Geschenke angezeigt.
globalGiftEndDate Datetime — Enddatum für die Geschenk-Kampagne. Nach diesem Datum werden keine Geschenke mehr angezeigt.
ⓘ
Kampagnen-Tipp: Nutzen Sie globalGiftStartDate und globalGiftEndDate, um saisonale Aktionen zu planen — z.B. Weihnachtsgeschenke nur vom 1. bis 24. Dezember anzubieten.

Kategorie-Geschenke ab v7

Geschenke können entweder direkt am Produkt oder an einer Kategorie zugewiesen werden. Die Zuweisungs-Ebene bestimmt, wie viele Geschenke letztlich im Warenkorb landen.

Zuweisungs-Ebenen

Ist ein Geschenk gleichzeitig per Produkt- und per Kategorie-Zuweisung für denselben Artikel aktiv, hat die Produkt-Zuweisung Vorrang.

Verhalten bei giftQuantity = true (Mengenabgleich aktiv)

Beispiel: Kategorie „Wein“ hat Geschenk X zugewiesen. Der Warenkorb enthält 3× Rotwein und 2× Weißwein (beide in „Wein“) → eine Geschenk-Position X mit Menge 5.

Verhalten bei giftQuantity = false (fester Einzelwert)

Cleanup

ⓘ
Dynamischer Hinweistext: Der Tooltip auf der Produktdetailseite („?“-Icon neben der Geschenk-Überschrift) zeigt automatisch den passenden Text je nachdem, ob das Produkt eine Produkt-Zuweisung, eine Kategorie-Zuweisung oder beides hat.

Darstellung

Diese Einstellungen steuern die optische Darstellung der Geschenk-Auswahl auf der Produktdetailseite.

Einstellung Typ Standard Beschreibung
giftMedia Bool false Zeigt Produktbilder der Geschenke anstelle des Standard-Icons an.
giftHover Bool true Zeigt bei Hover über ein Geschenk zusätzliche Produktinformationen an.
addLink Bool false Fügt nach dem Geschenk-Namen einen Link zur Produktdetailseite hinzu.
addLinktoName Bool false Verlinkt den Geschenk-Namen direkt zur Produktdetailseite.

Badge

Produkte mit zugewiesenen Geschenken können in der Produktübersicht (Listing) mit einem farbigen Badge gekennzeichnet werden.

Einstellung Typ Standard Beschreibung
addBadge Bool true Zeigt ein Geschenk-Badge auf Produktkarten im Listing an, wenn das Produkt Geschenke hat.
badgeGiftColor Color #146ff9 Hintergrundfarbe des Geschenk-Badges im Produktlisting.
rowGiftColor Color #eeeeee Hintergrundfarbe der ausgewählten Geschenk-Zeile in der Geschenk-Auswahl.
Weiter: FAQ →