Box Builder (Mix & Match) — Vollständige Anleitung
Den „Mix & Match“-Box-Builder installieren, konfigurieren und nutzen: Produkt-/Kategoriequellen, 4 Preismodelle, Kategorie-Slots, vorgefertigte Vorlagen, Überraschung, Speichern & Teilen, Gamification und Statistiken für PrestaShop 8 und 9.
Überblick
Das Modul Box Builder (Mix & Match) (dfboxbuilder) fügt eine Seite hinzu, auf der Ihre Kunden ihre eigene Box zusammenstellen – aus einer von Ihnen kuratierten Produktauswahl. Sie wählen Artikel aus einem Raster, folgen einer Fortschrittsleiste, sehen den Preis live aktualisiert und legen die komplette Box mit einem Klick in den Warenkorb. Ideal für Gourmet-Boxen, Beauty-Boxen, Geschenkkörbe, „3 kaufen“-Pakete, Entdeckungs-Abos und mehr.
Sie erstellen beliebig viele Boxen, jede mit eigenen Produkten, eigenen Regeln (Minimum / Maximum an Artikeln) und eigenem Preismodell. Ein einziger Katalog kann mehrere sehr unterschiedliche Boxen speisen.
Kompatibilität
- PrestaShop 1.7.6 bis 8.x und 9.x
- PHP 7.4 bis 8.x
- Einzel-Shop und Multistore
- 5 Sprachen: FR, EN, ES, DE, IT (vollständig übersetzt, ohne Rückgriff)
- Classic-Theme und individuelle Themes (Builder in nativem JavaScript, ohne jQuery-Abhängigkeit)
- Keine Abhängigkeiten (kein Composer, kein Framework)
Installation
- Öffnen Sie im Back-Office Module > Modul-Manager.
- Klicken Sie auf Modul hochladen und wählen Sie die Datei
dfboxbuilder.zip. - Öffnen Sie nach der Installation den im Menü hinzugefügten Reiter Box Builder, um Ihre erste Box zu erstellen.
Bei der Installation legt das Modul seine Tabellen an, registriert seine Hooks (displayHeader, actionFrontControllerSetMedia, displayHome und actionValidateOrder) und fügt einen Admin-Reiter Box Builder hinzu. Beim ersten Speichern einer Box wird automatisch ein verstecktes Container-Produkt erzeugt: Es trägt die Box-Zeile im Warenkorb und ist im Katalog nicht sichtbar.
Eine Box konfigurieren
Das Bearbeitungsformular einer Box ist in fünf Reiter gegliedert.
Reiter Allgemein
- Name, Beschreibung, Button-Beschriftung: in allen 5 Sprachen übersetzbar.
- Min / Max Artikel: Grenzen der Zusammenstellung. Das Maximum bestimmt das Ziel der Fortschrittsleiste.
- Duplikate erlauben und Max. Einheiten pro Artikel: erlauben (oder nicht) das mehrfache Hinzufügen desselben Produkts, mit Obergrenze pro Produkt.
- Nicht vorrätige Produkte ausblenden: entfernt nicht verfügbare Produkte aus dem Raster (unter Beachtung der Ausverkauft-Einstellung jedes Produkts).
- „Überrasch mich“ aktivieren und Speichern & Teilen aktivieren: blenden diese Kundenaktionen ein oder aus.
- Aktiv: veröffentlicht die Box oder nicht.
Reiter Preisgestaltung
Vier Preismodelle stehen zur Verfügung:
- Festpreis: ein einziger Preis für die Box, unabhängig vom Inhalt.
- Mengenstaffeln: der Preis ändert sich mit der Artikelzahl (z. B. 3 Artikel = 25 €, 6 Artikel = 45 €). Sie legen beliebig viele „ab X Artikeln“-Staffeln fest.
- Summe der Produkte mit Rabatt: der Preis ist die Summe der Produkte in der Box, abzüglich eines Rabattprozentsatzes.
- Preis pro Slot: jeder Slot steuert einen festen Stückpreis bei; die Summe hängt von den befüllten Slots ab.
Dieser Reiter steuert auch die Gamification: Geschenk bei vollständiger Box (Wahl des Geschenkprodukts, kostenlos in den Warenkorb gelegt) und kostenloser Versand bei Vollständigkeit.
Der Basis- / Festpreis wird netto eingegeben. Das Modul wendet anschließend die Steuer des Container-Produkts an und zeigt dem Kunden den Bruttopreis an.
Reiter Zusammenstellung (Quellen & Slots)
Sie legen die zulässigen Produkte fest, die im Builder-Raster erscheinen, über zwei Quelltypen:
- Produkte: einzeln über eine Suche mit Autovervollständigung hinzugefügt.
- Kategorien: alle aktiven Produkte der Kategorie werden zulässig.
Die Option Kategorie-Slots verwenden aktiviert eine „schrittweise“ Zusammenstellung. Jeder Slot hat einen eigenen Namen, seine Min / Max-Grenzen, einen optionalen Slot-Preis und seine eigenen Quellen. So können Sie z. B. „2 Hauptgerichte + 3 Beilagen + 1 Dessert“ verlangen. Ohne Slots wählt der Kunde frei aus der globalen Liste.
Reiter Vorlagen (vorgefertigte Boxen)
Sie bieten fertige Boxen an, die der Kunde mit einem Klick wählt und dann beliebig anpasst. Jede Vorlage hat einen Namen, eine Beschreibung und eine Produktliste (über Suche mit Autovervollständigung hinzugefügt). Ideal, um unentschlossene Kunden zu führen oder ein Bestseller-Sortiment hervorzuheben.
Reiter Einschränkungen
Sie deklarieren inkompatible Produktpaare, die nicht gemeinsam in derselben Box vorkommen dürfen. Der Builder verhindert dann ihre gemeinsame Auswahl, und die Server-Validierung lehnt sie ab.
Nutzung auf Kundenseite
Der interaktive Builder
Die Zusammenstellungsseite zeigt das Produktraster (Bild, Name, ggf. Hinweis „geringer Bestand“) und ein klebriges Zusammenfassungs-Panel: Fortschrittsleiste, Liste der gewählten Artikel, live berechneter Preis (optimierter AJAX-Aufruf) und Validierungsmeldungen. Der Warenkorb-Button wird erst aktiv, wenn die Zusammenstellung alle Regeln erfüllt.
Kategorie-Slots
Wenn Slots aktiviert sind, führen Reiter den Kunden von einem Slot zum nächsten, jeder mit seinem Zähler (z. B. „Hauptgerichte 2/3“) und seiner eigenen Produktauswahl.
Überrasch mich
Der Button Überrasch mich befüllt die Box automatisch mit zulässigen Produkten und beachtet dabei das Artikelmaximum, die Grenzen jedes Slots und die Inkompatibilitäten. Der Kunde kann die vorgeschlagene Auswahl anschließend anpassen.
Speichern & Teilen
Der Kunde kann seine Zusammenstellung speichern und einen Teilen-Link erhalten. Wer diesen Link öffnet, findet die Box vorbefüllt vor, bereit zum Anpassen und Bestellen.
In den Warenkorb und Bestellung
Beim Hinzufügen zum Warenkorb wird die Zusammenstellung als Personalisierung der Zeile gespeichert (und bleibt im Warenkorb und in der Bestellung sichtbar), und der berechnete Box-Preis wird angewendet. Ist die Gamification aktiv, wird das Geschenk kostenlos hinzugefügt. Bei der Bestellbestätigung reduziert das Modul den Bestand jedes Komponenten-Produkts der Box und erfasst den Verkauf für die Statistiken.
Statistiken (Back-Office)
Der Reiter Statistiken aggregiert die bestellten Boxen: Umsatz, Anzahl der Bestellungen, durchschnittliche Artikel pro Box, Leistung pro Box und beliebteste Kombinationen. Alles, um Ihre erfolgreichen Sortimente zu erkennen und Ihre Quellen zu verfeinern.
Anzeige auf der Startseite (optional)
Ein optionaler Startseiten-Block listet Ihre aktiven Boxen mit einem direkten Link zu ihrem Builder. Eine Box-Seite ist auch direkt über ihre Adresse erreichbar: index.php?fc=module&module=dfboxbuilder&controller=builder&id_dfbox=ID. Sie können sie aus Ihrem Menü, einer CMS-Seite oder einem Banner verlinken.
Technische Funktionsweise
Für jede Box trägt ein verstecktes Container-Produkt (Sichtbarkeit „nirgends“, nicht navigierbar) die Zeile im Warenkorb. Der Box-Preis wird über einen auf den Warenkorb beschränkten Sonderpreis angewendet, sodass der Katalogpreis des Containers nie angezeigt wird. Die Zusammenstellung wird als Personalisierung gespeichert, und der Bestand der Komponenten wird bei der Bestellbestätigung reduziert.
Im Modell Summe mit Rabatt gilt: Fügt ein Kunde zwei Boxen derselben Box-Definition mit unterschiedlich bepreisten Zusammenstellungen hinzu, wird der zuletzt berechnete Preis auf beide Zeilen angewendet (der Sonderpreis hängt am Container-Produkt). Bei Fest-, Staffel– oder Slot-Preis bei gleicher Artikelzahl gibt es keine Auswirkung.
Das Löschen einer Box löscht ihr verstecktes Container-Produkt nicht automatisch (v1). Wenn Sie eine Test-Box löschen, können Sie das zugehörige Container-Produkt manuell aus dem Katalog entfernen.
FAQ und Fehlerbehebung
Der Builder wird nicht angezeigt oder die Buttons reagieren nicht
Leeren Sie den PrestaShop-Cache (Erweiterte Parameter > Leistung) und deaktivieren Sie beim Testen die Datei-Kombination/Komprimierung (CCC). Stellen Sie sicher, dass die Box aktiv ist und mindestens eine Produktquelle hat.
Das Raster ist leer
Prüfen Sie, dass die Quellen (Produkte oder Kategorien) aktive Produkte für den aktuellen Shop enthalten. Ist „Nicht vorrätige Produkte ausblenden“ aktiviert, erscheinen nicht verfügbare Produkte nicht.
Der angezeigte Preis entspricht nicht meinen Erwartungen
Prüfen Sie das gewählte Preismodell: Festpreis ignoriert den Inhalt, Staffeln hängen von der Artikelzahl ab, Summe mit Rabatt hängt vom Produktpreis ab, und Preis pro Slot hängt von den befüllten Slots ab. Der Basispreis wird netto eingegeben.
Der Komponentenbestand wird nicht reduziert
Die Reduzierung erfolgt bei der Bestellbestätigung (Hook actionValidateOrder), nicht beim Hinzufügen zum Warenkorb. Prüfen Sie, dass die Bestellung einen gültigen Status erreicht.
Kann ich eine genaue Struktur (nach Kategorien) verlangen?
Ja: Aktivieren Sie die Slots und legen Sie für jeden ein Minimum / Maximum und seine Quellen fest. Sie erhalten eine geführte Zusammenstellung wie „2 + 3 + 1“.
Ist es mit PrestaShop 9 kompatibel?
Ja. Das Modul ist mit PrestaShop 8 und 9 kompatibel, im Multistore und mehrsprachig (FR, EN, ES, DE, IT).