Dokumentation

Isotope Bundle Products

Sets aus mehreren Produkten für Isotope eCommerce. Jedes Teil behält seine eigene Steuerklasse, Warenkorb und Rechnung weisen z. B. 19 % und 7 % getrennt aus. Paket: contaolabs/isotope-bundle-products

Einrichtung

  1. Erweiterung im Contao Manager hochladen (beim ersten Mal zusammen mit license-client-….zip), „Änderungen anwenden“ und die Datenbank aktualisieren.
  2. Lizenzschlüssel unter System → Einstellungen → contaolabs-Lizenzen eintragen und speichern (siehe Übersicht).
  3. Unter Shop-Konfiguration → Produkttypen einen neuen Produkttyp mit der Produktklasse Bundle (Set aus mehreren Produkten) anlegen und als Leser-Template iso_reader_bundle wählen. Die Felder „Teile des Bundles“, „Ersparnis anzeigen“ und „Inhalt auf der Produktseite ausblenden“ sind automatisch aktiv. Das Feld „Preis“ nicht aktivieren, der Preis ergibt sich aus den Teilen.
  4. Ein Produkt mit diesem Produkttyp anlegen und eine eigene Artikelnummer vergeben.
  5. Unter Teile des Bundles Produkte suchen und per Klick oder Drag & Drop hinzufügen, dann Menge und Preis im Set eintragen.

Teile und Preise

  • Der Set-Preis ist die Summe der Preise im Set. Preise so eingeben wie bei normalen Produkten (brutto oder netto, je nach Steuerklasse).
  • Unter der Liste stehen die Summen je Steuerklasse, der Preis bei Einzelkauf und die Ersparnis.
  • Die Reihenfolge änderst du per Drag & Drop am Griff, mit × entfernst du ein Teil.
  • Teile, die nur im Set verkauft werden, brauchen keine Kategorie im Shop.
  • Gewicht am Set leer lassen, die Teile bringen ihr Gewicht mit.

Einstellungen pro Set

  • Ersparnis anzeigen: Preis bei Einzelkauf und Ersparnis auf der Produktseite.
  • Inhalt auf der Produktseite ausblenden: nur der Set-Preis, ohne Liste der Teile. Warenkorb, Kasse und Rechnung zeigen die Teile trotzdem, weil die Steuer pro Teil ausgewiesen wird.

Produktseite, Warenkorb und Kasse

  • Die Produktseite zeigt „Inhalt des Sets“ mit Bild, Menge, Preis im Set, Steuerhinweis, Summen und auf Wunsch der Ersparnis. Ist im Modul „Produktleser“ ein eigenes Leser-Template eingestellt (z. B. iso_reader_default), fügt die Erweiterung die Liste automatisch unter dem Produkt ein.
  • Im Warenkorb und in der Kasse steht das Set als eine Zeile mit der Set-Summe, darunter die Box „Inhalt des Sets“. Menge und Entfernen wirken immer auf das ganze Set.
  • Warenkorb und Kasse brauchen kein eigenes Template. Das klappt mit den Standard-Templates und mit dem Isotope OnePage-Checkout.
  • Live ansehen: Pisten-Starterset in der Demo.

Wie gerechnet wird

Im Warenkorb liegt das Set als Kopfzeile (0 €, ohne Steuer) und jedes Teil als eigene Position mit dem Preis im Set und der Steuerklasse des Teils. Menge Teil = Menge Set × Menge im Set. Isotope berechnet die Steuer wie gewohnt pro Position, darum stimmen Steuerzeilen, Rechnungen und Exporte ohne Sonderlogik.

Steuerlich entspricht das der Aufteilung einer Warenzusammenstellung nach Einzelpreisen. Lass die Aufteilung für deinen Shop von deiner Steuerberatung bestätigen.

Templates

  • iso_reader_bundle: Produktseite des Sets (Leser-Template im Produkttyp)
  • iso_bundle_parts: Liste „Inhalt des Sets“ auf der Produktseite
  • iso_collection_bundle: optional für Bestelldetails, PDF und Mails (Set-Summe in der Kopfzeile, Teile mit „Teil von“)

Alle Templates lassen sich wie gewohnt im Ordner templates überschreiben. Das Aussehen steuert bundle-frontend.css (Klassen cl-bundle-…).

Ohne gültige Lizenz

Die Liste der Teile ist im Backend dann nur lesbar. Der Shop läuft weiter, Sets bleiben bestellbar.

Grenzen (Version 1.0)

  • Rabattregeln auf Produktpreise (Isotope Rules) greifen nicht für Teile im Set. Warenkorb-Regeln wie Gutscheine oder Rabatt auf den Warenkorb funktionieren.
  • Staffelpreise der Teile werden im Set nicht genutzt.
  • Änderst du ein Set, während es in einem Warenkorb liegt, gilt sofort der neue Preis. Fehlt ein Teil, meldet der Warenkorb einen Fehler.