PS PrestaShop Mittel

Box Builder (Mix & Match): vollständige Anleitung

Box Builder in PrestaShop 8 und 9 installieren, einrichten und nutzen: Boxen nach Stückzahl oder nach Gewicht, Slots als Schritte, 5 Preismodelle inklusive Preis nach Gewicht, Geschenkoptionen, Verfügbarkeit, Anzeige im Katalog, Bearbeitung aus dem Warenkorb, Bestand und Statistiken.

Aktualisiert Modulversion 1.4.0

Überblick

Box Builder (Mix & Match) (dfboxbuilder) fügt eine Seite hinzu, auf der Ihre Kunden ihre eigene Box zusammenstellen, aus den Produkten, die Sie auswählen. Sie wählen Artikel in einem Raster, verfolgen einen Fortschrittsbalken, sehen Boxpreis und Ersparnis live und legen die Box in den Warenkorb. Die Box wird nach Stückzahl oder nach Gewicht befüllt. Jede Box ist eine Warenkorbzeile mit eigenem Preis; der Inhalt bleibt im Warenkorb, in der Bestellung und auf der Rechnung lesbar.

Legen Sie so viele Boxen an, wie Sie brauchen, jede mit eigenen Produkten, Regeln, Preismodell und Verkaufszeitraum. Derselbe Katalog kann sehr unterschiedliche Boxen speisen (Aperitif-Box, Weihnachtsbox, Pralinenbox nach Gewicht, Probierpaket…).

Kompatibilität

  • PrestaShop 8.x und 9.x
  • PHP 7.4 bis 8.x
  • Einzelshop und Multishop
  • Oberfläche in 5 Sprachen: FR, EN, ES, DE, IT
  • Classic, Hummingbird und eigene Themes (Konfigurator in nativem JavaScript, ohne jQuery)
  • Keine Abhängigkeiten (weder Composer noch Framework)

Installation und Update

  1. Öffnen Sie im Back-Office Module > Modulmanager.
  2. Klicken Sie auf Modul hochladen und wählen Sie dfboxbuilder.zip.
  3. Öffnen Sie den neuen Menüpunkt Box Builder, um Ihre erste Box anzulegen.

Für ein Update laden Sie die neue ZIP-Datei genauso hoch: Die Update-Skripte laufen automatisch (neue Spalten, neue Hooks, sprechende URLs aus den Boxnamen). Bestehende Boxen werden weiterhin nach Stückzahl befüllt.

Beim ersten Speichern einer Box legt das Modul ein technisches Produkt an, das die Box im Warenkorb trägt. Es ist standardmäßig verborgen; Sie können es in Ihren Kategorien anzeigen (siehe Anzeige im Katalog). Seine Produktseite leitet immer zum Konfigurator weiter. Beim Löschen einer Box wird auch dieses Produkt gelöscht.

Moduleinstellungen

Das Feld Einstellungen über der Boxliste enthält drei Optionen:

  • Boxen auf der Startseite anzeigen: Block auf dem Hook displayHome.
  • Akzentfarbe: Farbe des Fortschrittsbalkens, der Schritt-Reiter und der Hervorhebungen. Tragen Sie die Hauptfarbe Ihres Themes ein (zum Beispiel #8a5a2b); leer lassen für das Standardblau. Die Textfarbe darauf wird automatisch lesbar gewählt.
  • Nach dem Hinzufügen einer Box zum Warenkorb: zur Warenkorbseite (Standard) oder im Konfigurator bleiben. Beim Bleiben wird der Warenkorb-Block des Themes aktualisiert und öffnet sein Bestätigungsfenster; danach kann der Kunde eine weitere Box zusammenstellen.

In der Boxliste bietet das Menü jeder Zeile Konfiguratorseite öffnen und Duplizieren. Die Kopie übernimmt Preise, Staffelpreise, Slots, Quellen, Vorlagen, Einschränkungen und Gruppen; sie wird inaktiv angelegt. Bei einer Box nach Gewicht zeigen die Spalten Min und Max die Gewichte.

Eine Box anlegen

Das Formular einer Box hat sechs Reiter.

Allgemein

  • Name, Beschreibung, Beschriftung der Schaltfläche: pro Sprache.
  • Sprechende URL: pro Sprache, wird aus dem Namen erzeugt, wenn das Feld leer bleibt. Bei aktivierten sprechenden URLs lautet die Adresse der Boxseite /box/ID-sprechende-url.
  • Box befüllen nach: Anzahl der Artikel (Standard) oder Gewicht (siehe Boxen nach Gewicht).
  • Min. / max. Artikel (Befüllung nach Stückzahl): Grenzen der Zusammenstellung (0 = kein Maximum).
  • Mindest- / Höchstgewicht (Befüllung nach Gewicht): in der Gewichtseinheit des Shops; 0 = kein Maximum, derselbe Wert für ein genaues Gewicht.
  • Gleichen Artikel mehrfach erlauben und maximale Einheiten pro Artikel.
  • Nicht vorrätige Produkte ausblenden: sonst bleiben sie sichtbar, können aber nicht hinzugefügt werden.
  • „Überrasch mich“ aktivieren, Speichern und Teilen aktivieren, Aktiv.

Verfügbarkeit

  • Verfügbar ab / bis: Verkaufszeitraum. Vor dem Startdatum zeigt die Boxseite „Diese Box ist ab … verfügbar“; nach dem Enddatum wird die Box aus den Warenkörben entfernt, die sie noch enthalten.
  • Begrenzter Bestand (Boxen): Höchstzahl verkaufter Boxen über alle Shops, ohne stornierte Bestellungen (0 = unbegrenzt). Das Formular zeigt verkaufte und verbleibende Boxen; die Boxseite zeigt „Limitierte Auflage: noch N“.
  • Im Katalog anzeigen: nirgends (Standard), Kategorien und Suche, nur Kategorien oder nur Suche, mit den Kategorien, in denen die Box erscheinen soll.
  • Kundengruppen: keine Gruppe ausgewählt = alle. Sonst sehen und bestellen nur die ausgewählten Gruppen die Box.
  • Box auf Produktseiten vorschlagen: fügt „Stellen Sie eine Box mit diesem Produkt zusammen“ auf der Seite jedes enthaltenen Produkts hinzu.

Preise

Alle Preise werden netto in der Standardwährung eingegeben. Die Box hat eine eigene Steuerregel, die im Warenkorb nach der Adresse des Kunden angewendet wird.

  • Festpreis: ein Preis unabhängig vom Inhalt.
  • Mengenstaffeln: Der Preis hängt von der Artikelzahl ab (z. B. ab 3 Artikeln: 25 €, ab 6: 45 €). Der Kunde sieht „Fügen Sie noch 2 Artikel hinzu und Ihre Box kostet nur noch …“.
  • Summe der Produkte mit Rabatt: Summe der Artikelpreise abzüglich eines Prozentsatzes. Die Artikelpreise werden dann im Raster angezeigt.
  • Preis pro Slot: Jeder Slot hat einen Preis pro Artikel (erfordert Slots).
  • Preis nach Gewicht: Gesamtgewicht der Artikel mal einem Preis pro Gewichtseinheit (pro kg, wenn der Shop in kg arbeitet). Optionale Staffelpreise ändern diesen Preis ab einem bestimmten Boxgewicht, und die ganze Box wird dann zum neuen Preis berechnet: Bei 30 € pro kg und 26 € pro kg ab 1 kg kostet eine Box mit 1,05 kg 27,30 €. Der Kunde sieht den aktuellen Kilopreis und „Noch 100 g und der Preis sinkt auf 26,00 € / kg“. Dieses Modell funktioniert auch mit Boxen, die nach Stückzahl befüllt werden.

Ersparnis anzeigen vergleicht den Boxpreis mit dem Preis der einzeln gekauften Artikel zu den aktuellen Katalogpreisen: „Statt 34,00 €: Sie sparen 5,20 € (-15 %)“.

Belohnungen bei vollständiger Box: Gratisprodukt und/oder Gratisversand über eine Warenkorbregel mit geheimem Code, einmalig nutzbar und nur gültig, solange die Box im Warenkorb liegt. Die Bezeichnung der Belohnung wird im Konfigurator angezeigt.

Geschenkoptionen:

  • Geschenknachricht mit maximaler Länge (1 bis 500 Zeichen). Die Nachricht erscheint in der Bestellung im Back-Office und auf der Rechnung.
  • Geschenkverpackung mit Nettopreis (0 = kostenlos), der zum Boxpreis addiert wird.

Zusammensetzung

Die wählbaren Produkte stammen aus einzeln hinzugefügten Produkten (Suche nach Name, Artikelnummer oder ID) oder aus ganzen Kategorien. Jede Kombination eines Produkts wird ein wählbarer Artikel mit eigenem Bestand, Preis und Gewicht.

Slots verwenden gibt der Box eine Struktur, zum Beispiel „2 herzhaft + 1 süß“. Jeder Slot hat einen Namen pro Sprache, ein Minimum, ein Maximum, einen Preis pro Artikel (Modell pro Slot) und eigene Quellen. Im Shop werden Slots zu nummerierten Schritten.

Vorlagen

Fertige Boxen, die der Kunde mit einem Klick übernimmt und dann anpasst. Die Produkte einer Vorlage müssen in der Box ebenfalls wählbar sein.

Einschränkungen

Produktpaare, die nicht in derselben Box sein dürfen. Der Konfigurator verhindert die Kombination, der Server lehnt sie ab.

Boxen nach Gewicht

Für eine Pralinenbox, ein Teesortiment oder eine Box mit losen Waren füllt der Kunde die Box bis zu einem Gewicht, statt Artikel zu zählen.

  1. Reiter Allgemein: Box befüllen nach = Gewicht, dann ein Mindest- und/oder Höchstgewicht. Beispiel: 1 und 1,2 für eine Box von 1 bis 1,2 kg; 1 und 1 für genau 1 kg. Mindestens einer der beiden Werte ist erforderlich.
  2. Reiter Preise: Alle Preismodelle funktionieren. Preis nach Gewicht berechnet die Box zum Kilopreis, bei Bedarf mit Staffelpreisen; ein Festpreis passt zu einer Box für 35 € unabhängig von der Auswahl.
  3. Prüfen Sie das Gewicht der Produkte: Produktseite, Reiter Versand, und die Gewichtsauswirkung jeder Variante.
  • Gewicht eines Artikels: Produktgewicht + Auswirkung der Variante, derselbe Wert, den PrestaShop für den Versand verwendet.
  • Produkte ohne Gewicht: Sie werden in einer Box nach Gewicht oder mit Preis nach Gewicht nicht angeboten, und der Block auf den Produktseiten schlägt die Box auf ihrer Seite nicht vor. Das Boxformular zeigt, wie viele wählbare Produkte betroffen sind.
  • Konfigurator: Gewicht auf jeder Karte, in der Übersicht und in der Schnellansicht; Zähler und Fortschrittsbalken in g / kg („800 g / 1,2 kg“, Minimum markiert); ein Artikel, der das Maximum überschreiten würde, wird mit „Passt nicht mehr ins Restgewicht“ deaktiviert; bis das Minimum erreicht ist, sieht der Kunde „Noch 200 g, um Ihre Box zu vervollständigen“.
  • Artikelregeln: Im Gewichtsmodus gelten die min. / max. Artikel der Box nicht; Slots, Duplikate, maximale Einheiten pro Artikel und Unverträglichkeiten bleiben aktiv.
  • Überrasch mich füllt die Box innerhalb der Gewichtsspanne.
  • Warenkorb, Bestellung und Rechnung: Das Gesamtgewicht steht beim Inhalt.
  • Anzeige der Gewichte: unter 1 kg in Gramm, darüber in Kilogramm, mit dem Dezimaltrennzeichen der Sprache des Besuchers.

Im Shop

Der Konfigurator

  • Schritte: Mit Slots zeigen nummerierte Reiter den Fortschritt („Herzhaft 2/3“). Ist ein Schritt voll, wechselt der Konfigurator zum nächsten; eine Schaltfläche „Weiter“ erscheint, sobald ein Schritt vollständig ist.
  • Raster: Ab 8 Produkten erscheinen ein Suchfeld (Akzente werden ignoriert), ein Kategoriefilter und eine Sortierung nach Name oder Preis. Ein Klick auf Bild oder Name öffnet die Schnellansicht (Bild, Beschreibung, Link zur Produktseite, Schaltfläche Hinzufügen). Gewählte Artikel haben eine Schaltfläche „-„.
  • Übersicht: Zähler mit der Regel (min. 5, max. 6, oder in Gewicht bei einer Box nach Gewicht), Fortschrittsbalken mit markiertem Minimum, visuelle Vorschau der Box (ein Feld pro Artikel), Preis, Ersparnis, freizuschaltende Belohnung und Geschenkoptionen. Was noch fehlt, wird blau angezeigt („Fügen Sie noch 2 Artikel hinzu…“); Rot bleibt echten Sperren vorbehalten.
  • Smartphone: Raster mit zwei Spalten, horizontal scrollende Vorlagen und Schritte, feste Leiste mit Artikelzahl (oder Gewicht) und Preis, die zu „In den Warenkorb“ wird, sobald die Box gültig ist.
  • Überrasch mich füllt die Box zufällig im Rahmen der Regeln; Speichern und Teilen erzeugt einen Link, der die Zusammenstellung wieder lädt.

Der Preis wird immer vom Server aus Ihrem Katalog neu berechnet; eine vom Browser gesendete Zusammenstellung wird vor dem Hinzufügen erneut geprüft (Produkte, Kombinationen, Slots, Gewicht, Bestand).

Eine Box aus dem Warenkorb bearbeiten

Im Warenkorb und im Bestellprozess folgt auf den Inhalt der Box ein Link Diese Box bearbeiten. Er öffnet den Konfigurator mit Inhalt und Geschenkoptionen; die Schaltfläche heißt dann „Meine Box aktualisieren“. Nach der Bestätigung wird die Box an derselben Stelle mit derselben Menge ersetzt. Im Classic-Theme stehen Inhalt und Link im Anpassungsfenster der Warenkorbzeile.

Anzeige und Kundengewinnung

  • Boxseite: Link „Konfiguratorseite öffnen“ im Formular und in der Liste. Adresse /box/ID-sprechende-url bei sprechenden URLs, Canonical-Tag, Sprachumschalter auf die URL der gewählten Sprache.
  • Startseite: Block mit den verfügbaren Boxen (Moduleinstellung).
  • Widget: Der Block lässt sich in jeden Anzeige-Hook einhängen (Design > Positionen) oder in ein Template setzen: {widget name='dfboxbuilder'}, {widget name='dfboxbuilder' id_dfbox=3} oder {widget name='dfboxbuilder' title='Unsere Boxen'}.
  • Produktseiten: Block „Stellen Sie eine Box mit diesem Produkt zusammen“ (bis zu 3 Boxen), der den Konfigurator mit dem bereits hinzugefügten Produkt öffnet.
  • Katalog: Mit „Im Katalog anzeigen“ erscheint die Box in den gewählten Kategorien und/oder der Suche. Angezeigt wird der Ab-Preis (günstigste gültige Zusammenstellung, inklusive Steuer und Gruppenrabatt; bei einer Box nach Gewicht zum Mindestgewicht oder zur günstigsten Staffel); eine Box mit Festpreis zeigt ihren Preis. Der Link führt zum Konfigurator, eine Schaltfläche zum Hinzufügen gibt es dort nicht.

Preisfilter der Facettennavigation und Preissortierung verwenden den gespeicherten Preis des technischen Produkts, also 0: Eine sichtbare Box steht bei aufsteigender Preissortierung ganz vorne.

In den Blöcken erscheinen nur aktive Boxen im Verkaufszeitraum, die nicht ausverkauft und für die Gruppe des Besuchers freigegeben sind. Wird eine Box deaktiviert, wird auch ihr technisches Produkt deaktiviert und verschwindet aus den Listen.

Warenkorb, Bestellungen und Bestand

  • Preis pro Zeile: Der Boxpreis wird in der Warenkorbzeile gespeichert; zwei Boxen mit unterschiedlichem Inhalt behalten ihren Preis. Kundengruppenrabatte gelten; Katalogpreisregeln und Mengenrabatte gelten nicht für Boxen.
  • Bestand der Komponenten: wird beim Hinzufügen über den gesamten Warenkorb geprüft (andere Boxen und einzeln gekaufte Produkte). Erhöht der Kunde die Menge einer Box über den Bestand, wird sie auf der Warenkorbseite mit einem Hinweis auf das Maximum gesenkt.
  • Bestellungen: Der Bestand jeder Komponente wird bei der Bestellbestätigung abgebucht, zurückgebucht, wenn die Bestellung storniert wird oder einen Zahlungsfehler erhält, und erneut abgebucht, wenn sie reaktiviert wird. Eine direkt im Fehlerstatus angelegte Bestellung bucht keinen Bestand ab.
  • Nicht verfügbare Boxen: Eine gelöschte, deaktivierte, beendete, noch nicht gestartete oder einer anderen Gruppe vorbehaltene Box wird auf den Warenkorb- und Bestellseiten aus dem Warenkorb entfernt, auch nach „Erneut bestellen“.
  • Back-Office und Rechnung: Inhalt (pro Slot), Geschenkverpackung, Geschenknachricht und bei einer Box nach Gewicht das Gesamtgewicht stehen in der Bestellung und auf der Rechnung.

Statistiken

Die Schaltfläche für die Statistiken in der Liste öffnet ein Dashboard mit Zeitraumauswahl (7, 30, 90 oder 365 Tage):

  • bestellte Boxen, Nettoumsatz, durchschnittliche Artikelzahl pro Box, Konversion (Bestellungen / Aufrufe);
  • pro Box: Konfigurator-Aufrufe, in den Warenkorb gelegt, Bestellungen, Boxen, Hinzufügerate, Konversion, Umsatz und Durchschnittspreis;
  • am häufigsten gewählte Artikel und am häufigsten bestellte Kombinationen.

Aufrufe und Hinzufügungen werden seit Version 1.2.0 gezählt, ohne Robots; stornierte Bestellungen sind ausgeschlossen.

Tracking mit Google Analytics 4

Nach dem Hinzufügen einer Box sendet der Konfigurator ein Event add_to_cart an window.dataLayer (wenn Google Tag Manager oder gtag.js vorhanden ist) mit currency, value und dem Artikel dfbox-ID. Zusätzlich wird ein Event dfbox:added auf document mit denselben Daten ausgelöst, für andere Werkzeuge.

FAQ und Fehlerbehebung

Schaltflächen reagieren nicht oder die Seite bleibt leer

Leeren Sie den PrestaShop-Cache (Erweiterte Einstellungen > Leistung) und deaktivieren Sie während der Tests das Zusammenfassen von JS/CSS-Dateien. Prüfen Sie, ob die Box aktiv ist, dem Shop zugeordnet ist und mindestens eine Produktquelle hat.

Das Raster ist leer

Die Quellen müssen Produkte enthalten, die im aktuellen Shop aktiv und bestellbar sind. Ist das Ausblenden nicht vorrätiger Produkte aktiv, erscheinen Produkte ohne Bestand nicht. In einer Box nach Gewicht oder mit Preis nach Gewicht erscheinen auch Produkte ohne Gewicht nicht.

Ein Produkt erscheint nicht in einer Box nach Gewicht

Es hat kein Gewicht. Tragen Sie es auf der Produktseite im Reiter Versand ein oder in der Gewichtsauswirkung seiner Varianten. Der Hinweis oben im Boxformular zeigt, wie viele wählbare Produkte betroffen sind.

Eine in einer Kategorie sichtbare Box zeigt 0,00 €

Aktualisieren Sie das Modul auf 1.2.1 oder neuer: Die Listen zeigen dann den Ab-Preis.

Die Box erscheint für einen Kunden nicht

Prüfen Sie Verkaufszeitraum, begrenzten Bestand und Kundengruppen im Reiter Verfügbarkeit.

Er wird nur im Warenkorb und im Bestellprozess angezeigt, für eine noch verfügbare Box. Öffnen Sie im Classic-Theme das Anpassungsfenster der Zeile.

Der Bestand der Komponenten sinkt nicht

Er wird bei der Bestellbestätigung abgebucht, nicht beim Hinzufügen zum Warenkorb, und nur bei aktivierter Lagerverwaltung. Eine stornierte Bestellung bucht den Bestand zurück.

War diese Seite hilfreich?

Immer noch nicht weiter? Support kontaktieren