Zum Inhalt

Nutzungsanleitung

Diese Anleitung behandelt alle Funktionen und Möglichkeiten des Ultimativen Bundle Plugins.

Inhaltsverzeichnis

Bundles erstellen

Was es bewirkt

Sie können Produktbundles erstellen, die auf den Produktdetailseiten der enthaltenen Produkte angezeigt werden. Kunden sehen das Bundle-Angebot mit allen Gruppenprodukten und können es mit einem Klick in den Warenkorb legen.

So erstellen Sie ein Bundle

  1. Navigieren Sie zu Kataloge → Bundles
  2. Klicken Sie auf Bundle anlegen
  3. Füllen Sie die Grundeinstellungen aus:
  4. Titel: Geben Sie einen aussagekräftigen Namen für das Bundle ein (z.B. "Komplett-Set Smartphone")
  5. Aktiv: Aktivieren Sie das Bundle für die Anzeige in der Storefront
  6. Rabatt in Prozent: Legen Sie den prozentualen Rabatt fest (z.B. 10 für 10%)
  7. Wählen Sie den Bundle-Typ:
  8. Produkte: Wählen Sie manuell die Hauptprodukte aus, bei denen das Bundle angezeigt werden soll
  9. Produktstream: Wählen Sie einen Produktstream, dessen Produkte automatisch als Bundle-Trigger dienen
  10. Klicken Sie auf Speichern

Erweiterte Bundle-Optionen

  • Rabatt auf Hauptprodukt anwenden: Wenn aktiviert, wird der Rabatt auf den Gesamtpreis (Hauptprodukt + Gruppenprodukte) berechnet. Wenn deaktiviert, gilt der Rabatt nur für die Gruppenprodukte.
  • Kein Rabatt: Deaktiviert den Rabatt komplett für dieses Bundle. Nützlich für Werbe-Bundles ohne Preisnachlass.
  • Produkte ohne Bestand ausblenden: Blendet Produkte automatisch aus, die nicht auf Lager sind.

Bundles bearbeiten

So bearbeiten Sie ein bestehendes Bundle

  1. Navigieren Sie zu Kataloge → Bundles
  2. Klicken Sie auf das gewünschte Bundle in der Liste
  3. Nehmen Sie Ihre Änderungen vor
  4. Klicken Sie auf Speichern (oder verwenden Sie die Tastenkombination Strg+S / Cmd+S)

Tipp: Verwenden Sie die Sprachumschaltung oben rechts, um den Bundle-Titel in verschiedenen Sprachen zu pflegen.

Bundle-Gruppen verwalten

Bundle-Gruppen sind das Herzstück des Plugins. Jede Gruppe enthält eine Auswahl an Produkten, aus denen Kunden wählen können.

Für eine detaillierte Anleitung zu Gruppen, optionalen Gruppen und der Mengenauswahl, lesen Sie die Bundle-Gruppen Dokumentation.

Kurzübersicht: Gruppe hinzufügen

  1. Öffnen Sie ein Bundle zur Bearbeitung
  2. Scrollen Sie zum Bereich Gruppen
  3. Klicken Sie auf Hinzufügen
  4. Geben Sie einen Titel ein und klicken Sie auf Bearbeiten, um die Gruppendetails zu öffnen
  5. Konfigurieren Sie die Gruppenoptionen im Modal:
  6. Titel: Anzeigename der Gruppe
  7. Typ: Produktquelle (Produkte, Produktstream oder Kategorie)
  8. Aktiv: Gruppe anzeigen oder ausblenden
  9. Optional: Kunden können diese Gruppe abwählen
  10. Mengenauswahl erlauben: Kunden können die Menge pro Artikel wählen
  11. Maximale Menge: Obergrenze für die Mengenauswahl
  12. Wählen Sie die Produkte basierend auf dem gewählten Typ aus
  13. Klicken Sie auf Übernehmen

Storefront-Darstellung

Desktop-Ansicht

Auf der Produktdetailseite werden Bundles als horizontale Karte dargestellt:

  • Links: Hauptprodukt-Bild
  • Mitte: Gruppenprodukte verbunden durch +-Zeichen
  • Rechts: Preisbereich mit:
  • Originalpreis (durchgestrichen)
  • Bundle-Preis (hervorgehoben)
  • Ersparnis-Anzeige
  • "In den Warenkorb"-Button

Bei Gruppen mit mehreren Produkten wird ein "Option wählen"-Button angezeigt, der ein Modal mit allen verfügbaren Optionen öffnet.

Mobile Ansicht

Auf Mobilgeräten wird eine kompaktere, vertikale Darstellung verwendet:

  • Bundle-Vorschau mit kleinen Produktbildern
  • Ausklappbare Detailansicht
  • Preise und Aktionsbutton im ausgeklappten Bereich
  • Optimiert für Touch-Bedienung

Position der Bundle-Anzeige

Die Position auf der Produktseite kann in den Konfigurationseinstellungen angepasst werden: - Unter dem "In den Warenkorb"-Button - Über der Produktbeschreibung (Standard) - Unter der Produktbeschreibung

Warenkorb-Verhalten

Bundle im Warenkorb

Wenn ein Kunde ein Bundle in den Warenkorb legt, erscheint das Hauptprodukt als übergeordnete Position. Die Bundle-Gruppenprodukte werden als untergeordnete Positionen angezeigt.

Automatische Bundle-Erstellung

Wenn die Einstellung Bundles automatisch erstellen aktiviert ist, erkennt das Plugin automatisch, wenn ein zum Warenkorb hinzugefügtes Produkt ein Bundle vervollständigt, und gruppiert die Produkte automatisch.

Rabattanzeige im Warenkorb

Je nach Konfiguration wird der Rabatt als: - Eigene Position: Negative Rabattposition unterhalb der Bundle-Produkte - Direktabzug: Bereits im Produktpreis verrechnet (unsichtbar als separate Position)

Bundle-Index

Der Bundle-Index ist ein Hintergrundsystem, das die Bundle-Produkt-Zuordnungen vorberechnet, um eine schnelle Darstellung in der Storefront zu gewährleisten.

Wann muss der Index neu aufgebaut werden?

  • Nach dem Erstellen oder Ändern von Bundles mit Produktstreams
  • Nach dem Ändern von Kategoriezuordnungen bei Gruppen mit Kategorie-Typ
  • Bei Inkonsistenzen in der Bundle-Anzeige

Index manuell neu aufbauen

Führen Sie folgenden Befehl in der Konsole aus:

php bin/console wl-bundles:index

Fehlerbehebung

Bundle wird nicht auf der Produktseite angezeigt

Symptom: Das Bundle ist im Admin angelegt, erscheint aber nicht auf der Produktdetailseite.

Mögliche Ursachen und Lösungen: 1. Bundle nicht aktiv: Prüfen Sie, ob das Bundle und alle Gruppen auf "Aktiv" gesetzt sind 2. Einstellung "Bundles aktivieren" deaktiviert: Prüfen Sie die globale Einstellung unter Erweiterungen → Meine Erweiterungen → Ultimatives Bundle Plugin → Konfigurieren 3. Produkt nicht zugewiesen: Stellen Sie sicher, dass das Produkt im Bundle oder im gewählten Produktstream/der Kategorie enthalten ist 4. Index veraltet: Bauen Sie den Index mit php bin/console wl-bundles:index neu auf 5. Cache leeren: Leeren Sie den Shopware-Cache unter Einstellungen → System → Caches & Indizes

Rabatt wird nicht berechnet

Symptom: Das Bundle wird angezeigt, aber es wird kein Rabatt abgezogen.

Mögliche Ursachen und Lösungen: 1. Rabatt auf 0% gesetzt: Prüfen Sie den Rabattprozentsatz im Bundle 2. "Kein Rabatt" aktiviert: Prüfen Sie, ob die Option "Kein Rabatt" im Bundle deaktiviert ist 3. Unvollständiges Bundle: Stellen Sie sicher, dass alle Pflichtgruppen ein Produkt ausgewählt haben (sofern "Unvollständige Bundles erlauben" deaktiviert ist)

Produkte in einer Gruppe werden nicht angezeigt

Symptom: Eine Bundle-Gruppe zeigt keine Produkte an.

Mögliche Ursachen und Lösungen: 1. Gruppe nicht aktiv: Aktivieren Sie die Gruppe im Bundle-Detail 2. Keine Produkte zugewiesen: Prüfen Sie die Produktzuweisung in der Gruppe 3. Produkte nicht verfügbar: Wenn "Produkte ohne Bestand ausblenden" aktiv ist, werden ausverkaufte Produkte nicht angezeigt 4. Index veraltet: Bauen Sie den Index neu auf

Verwandte Dokumentation