Box Builder (Mix & Match): volledige gids
Box Builder installeren, instellen en gebruiken in PrestaShop 8 en 9: boxen per aantal of op gewicht, slots als stappen, 5 prijsmodellen met prijs op gewicht, cadeauopties, beschikbaarheid, weergave in de catalogus, bewerken vanuit de winkelwagen, voorraad en statistieken.
Overzicht
Box Builder (Mix & Match) (dfboxbuilder) voegt een pagina toe waar je klanten hun eigen box samenstellen uit de producten die jij kiest. Ze kiezen artikelen in een raster, volgen een voortgangsbalk, zien de prijs van de box en de besparing bijwerken en leggen de box in de winkelwagen. De box wordt gevuld per aantal artikelen of op gewicht. Elke box is één winkelwagenregel met een eigen prijs; de inhoud blijft leesbaar in de winkelwagen, op de bestelling en op de factuur.
Maak zoveel boxen als je nodig hebt, elk met eigen producten, regels, prijsmodel en verkoopperiode. Dezelfde catalogus kan heel verschillende boxen voeden (borrelbox, kerstbox, bonbondoos op gewicht, proefpakket…).
Compatibiliteit
- PrestaShop 8.x en 9.x
- PHP 7.4 tot 8.x
- Eén winkel en multistore
- Interface van de module in het Frans, Engels, Spaans, Duits, Italiaans, Pools, Nederlands en Portugees; in andere talen verschijnen de teksten van de module in het Engels (ze zijn te vertalen in PrestaShop)
- Classic, Hummingbird en eigen thema’s (configurator in native JavaScript, zonder jQuery)
- Geen afhankelijkheden (geen Composer, geen framework)
Installatie en update
- Open in de back-office Modules > Modulebeheer.
- Klik op Een module uploaden en kies
dfboxbuilder.zip. - Open het nieuwe menu-item Box Builder om je eerste box aan te maken.
Upload voor een update het nieuwe ZIP-bestand op dezelfde manier: de updatescripts draaien automatisch (nieuwe kolommen, nieuwe hooks, nette URL’s op basis van de boxnamen). Bestaande boxen worden verder per aantal artikelen gevuld.
Bij het eerste opslaan van een box maakt de module een technisch product aan dat de box in de winkelwagen draagt. Het is standaard verborgen; je kunt het in je categorieën tonen (zie Weergave in de catalogus). De productpagina ervan stuurt altijd door naar de configurator. Wie een box verwijdert, verwijdert ook dit product.
Instellingen van de module
Het paneel Settings boven de lijst met boxen heeft drie opties:
- Boxen op de homepage: blok op de hook
displayHome. - Accentkleur: kleur van de voortgangsbalk, de stap-tabbladen en de accenten. Vul de hoofdkleur van je thema in (bijvoorbeeld
#8a5a2b); laat leeg voor het standaardblauw. De tekstkleur erop wordt automatisch leesbaar gekozen. - Na het toevoegen van een box aan de winkelwagen: naar de winkelwagenpagina (standaard) of in de configurator blijven. Bij blijven wordt het winkelwagenblok van het thema vernieuwd en opent het zijn bevestigingsvenster; daarna kan de klant nog een box samenstellen.
In de lijst met boxen biedt het menu van elke regel Open the builder page (configuratorpagina openen) en Duplicate (dupliceren). De kopie neemt prijzen, dalende tarieven, slots, bronnen, sjablonen, beperkingen en groepen over en wordt inactief aangemaakt. Bij een box op gewicht tonen de kolommen Min en Max de gewichten.

Een box aanmaken
Het formulier van een box heeft zes tabbladen.
Algemeen
- Naam, omschrijving, knoptekst: per taal.
- Nette URL: per taal, gemaakt op basis van de naam als het veld leeg blijft. Met de nette URL’s van PrestaShop ingeschakeld heeft de boxpagina het adres
/box/ID-nette-url. - Manier van vullen (Fill the box by): aantal artikelen (Number of items, standaard) of gewicht (Weight), zie Boxen op gewicht.
- Min. / max. artikelen (vullen per aantal): grenzen van de samenstelling (0 = geen maximum).
- Minimum- / maximumgewicht (vullen op gewicht): in de gewichtseenheid van de winkel; 0 = geen maximum, dezelfde waarde voor een exact gewicht.
- Hetzelfde artikel meerdere keren toestaan en maximum aantal per artikel.
- Producten zonder voorraad verbergen: anders blijven ze zichtbaar maar kunnen ze niet worden toegevoegd.
- Willekeurig vullen, opslaan en delen, actief.

Beschikbaarheid
- Beschikbaar vanaf / tot: verkoopperiode. Vóór de startdatum meldt de boxpagina vanaf wanneer de box beschikbaar is; na de einddatum wordt de box uit de winkelwagens gehaald die hem nog bevatten.
- Beperkte voorraad (boxen): maximum aantal verkochte boxen over alle winkels, zonder geannuleerde bestellingen (0 = onbeperkt). Het formulier toont het aantal verkochte en resterende boxen; de boxpagina toont hoeveel er nog over zijn.
- Weergave in de catalogus: nergens (standaard), categorieën en zoeken, alleen categorieën of alleen zoeken, met de categorieën waarin de box moet staan.
- Klantgroepen: geen groep aangevinkt = iedereen. Anders zien en bestellen alleen de aangevinkte groepen de box.
- De box voorstellen op productpagina’s: voegt een voorstel toe op de pagina van elk product dat in de box zit.

Prijzen
Alle prijzen worden exclusief btw ingevoerd, in de standaardvaluta. De box heeft een eigen btw-regel, die in de winkelwagen wordt toegepast op basis van het adres van de klant.
- Vaste prijs: één prijs, wat de inhoud ook is.
- Staffels: de prijs hangt af van het aantal artikelen (bijv. vanaf 3 artikelen: € 25, vanaf 6: € 45). De klant ziet hoeveel artikelen er nog nodig zijn voor de lagere prijs.
- Som van producten met korting: som van de artikelprijzen min een percentage. De artikelprijzen worden dan in het raster getoond.
- Prijs per slot: elk slot heeft een prijs per artikel (vereist slots).
- Prijs op gewicht (Price per weight): totaalgewicht van de artikelen maal een prijs per gewichtseenheid (per kg als de winkel kg gebruikt). Optionele dalende tarieven veranderen die prijs vanaf een bepaald boxgewicht, en de hele box wordt dan tegen het nieuwe tarief afgerekend: met € 30 per kg en € 26 per kg vanaf 1 kg kost een box van 1,05 kg € 27,30. De klant ziet de huidige kiloprijs en hoeveel gram er nog nodig is voor het lagere tarief. Dit model werkt ook met boxen die per aantal worden gevuld.
Besparing tonen vergelijkt de prijs van de box met de prijs van de artikelen los gekocht, tegen de huidige prijzen van je catalogus.
Beloningen bij een volledige box: gratis product en/of gratis verzending, toegekend via een winkelwagenregel met geheime code, voor eenmalig gebruik en alleen geldig zolang de box in de winkelwagen ligt. Het label van de beloning staat in de configurator.
Cadeauopties:
- Cadeaubericht met een maximale lengte (1 tot 500 tekens). Het bericht staat bij de bestelling in de back-office en op de factuur.
- Cadeauverpakking met een prijs exclusief btw (0 = gratis), die bij de prijs van de box wordt opgeteld.


Samenstelling
De kiesbare producten komen van producten die één voor één worden toegevoegd (zoeken op naam, referentie of ID) of van hele categorieën. Elke combinatie van een product wordt een kiesbaar artikel met eigen voorraad, prijs en gewicht.
Slots geven de box structuur, bijvoorbeeld “2 hartig + 1 zoet”. Elk slot heeft een naam per taal, een minimum, een maximum, een prijs per artikel (model per slot) en eigen bronnen. In de winkel worden slots genummerde stappen.

Sjablonen
Kant-en-klare boxen die de klant met één klik overneemt en daarna aanpast. De producten van een sjabloon moeten ook kiesbaar zijn in de box.

Beperkingen
Combinaties van producten die niet in dezelfde box mogen. De configurator voorkomt de combinatie en de server weigert haar.
Boxen op gewicht
Voor een bonbondoos, een theeassortiment of een box met losse waren vult de klant de box tot een bepaald gewicht in plaats van artikelen te tellen.
- Tabblad Algemeen: manier van vullen = Weight, daarna een minimum- en/of maximumgewicht. Voorbeeld: 1 en 1,2 voor een box van 1 tot 1,2 kg; 1 en 1 voor precies 1 kg. Minstens één van beide is verplicht.
- Tabblad Prijzen: alle prijsmodellen werken. Prijs op gewicht rekent de box per kilo af, zo nodig met dalende tarieven; een vaste prijs past bij een doos van € 35 ongeacht de keuze.
- Controleer het gewicht van de producten: productpagina, tabblad Verzending, en de gewichtsimpact van elke combinatie.
- Gewicht van een artikel: productgewicht + impact van de combinatie, dezelfde waarde die PrestaShop voor de verzending gebruikt.
- Producten zonder gewicht: ze worden niet aangeboden in een box op gewicht of met prijs op gewicht, en het blok op productpagina’s stelt de box niet voor op hun pagina. Het boxformulier toont om hoeveel kiesbare producten het gaat.
- Configurator: gewicht op elke kaart, in het overzicht en in de snelle weergave; teller en voortgangsbalk in g / kg (“800 g / 1,2 kg”, minimum gemarkeerd); een artikel dat boven het maximum zou uitkomen wordt uitgeschakeld met de melding dat het niet meer in het resterende gewicht past; zolang het minimum niet is bereikt, ziet de klant hoeveel gram er nog ontbreekt.
- Artikelregels: in gewichtsmodus gelden de min. / max. artikelen van de box niet; slots, dubbele artikelen, maximum per artikel en onverenigbaarheden blijven actief.
- Willekeurig vullen vult de box binnen de gewichtsmarge.
- Winkelwagen, bestelling en factuur: het totaalgewicht staat bij de inhoud.
- Weergave van gewichten: in gram onder 1 kg, in kilo daarboven, met het decimaalteken van de taal van de bezoeker.


In de winkel
De configurator
- Stappen: met slots tonen genummerde tabbladen de voortgang. Is een stap vol, dan gaat de configurator naar de volgende; een knop voor de volgende stap verschijnt zodra een stap compleet is.
- Raster: boven 8 producten verschijnen een zoekveld (accenten worden genegeerd), een categoriefilter en sorteren op naam of prijs. Een klik op de afbeelding of naam opent de snelle weergave (afbeelding, omschrijving, link naar de productpagina, knop Toevoegen). Gekozen artikelen hebben een “-“-knop.
- Overzicht: teller met de regel (min. 5, max. 6, of in gewicht bij een box op gewicht), voortgangsbalk met het minimum gemarkeerd, visueel voorbeeld van de box (één vak per artikel), prijs, besparing, beloning en cadeauopties. Wat nog ontbreekt staat in het blauw; rood is voorbehouden aan echte blokkades.
- Mobiel: raster in twee kolommen, horizontaal scrollende sjablonen en stappen, vaste balk met aantal artikelen (of gewicht) en prijs die een winkelwagenknop wordt als de box geldig is.
- Willekeurig vullen vult de box binnen de regels; opslaan en delen maakt een link die de samenstelling opnieuw laadt.
De prijs wordt altijd door de server opnieuw berekend uit je catalogus; een samenstelling die door de browser wordt verstuurd, wordt opnieuw gecontroleerd (producten, combinaties, slots, gewicht, voorraad) voordat ze in de winkelwagen komt.



Een box bewerken vanuit de winkelwagen
In de winkelwagen en bij het afrekenen staat na de inhoud van de box een bewerklink (Edit this box als de interface Engels is). Die opent de configurator met de inhoud en de cadeauopties. Na bevestiging wordt de box op dezelfde plek vervangen, met hetzelfde aantal. In het Classic-thema staan de inhoud en de link in het personalisatievenster van de winkelwagenregel.

Weergave en klantenwerving
- Boxpagina: link naar de configuratorpagina in het formulier en in de lijst. Adres
/box/ID-nette-urlmet nette URL’s, canonical-tag, taalkeuze die naar de URL van de gekozen taal wijst. - Homepage: blok met de beschikbare boxen (instelling van de module).
- Widget: het blok kan aan elke weergavehook worden gekoppeld (Uiterlijk > Posities) of in een template worden geplaatst:
{widget name='dfboxbuilder'},{widget name='dfboxbuilder' id_dfbox=3}of{widget name='dfboxbuilder' title='Onze boxen'}. - Productpagina’s: blok met een voorstel (tot 3 boxen) dat de configurator opent met het product al toegevoegd.
- Catalogus: met weergave in de catalogus verschijnt de box in de gekozen categorieën en/of zoekresultaten. De getoonde prijs is de vanaf-prijs (goedkoopste geldige samenstelling, inclusief btw en groepskorting; bij een box op gewicht bij het minimumgewicht of bij het gunstigste dalende tarief); een box met vaste prijs toont zijn prijs. De link opent de configurator en er is geen knop om in de winkelwagen te leggen.
Het prijsfilter van de gelaagde navigatie en het sorteren op prijs gebruiken de opgeslagen prijs van het technische product, namelijk 0: een zichtbare box staat vooraan bij sorteren op oplopende prijs.
In de blokken verschijnen alleen actieve boxen binnen hun verkoopperiode, niet uitverkocht en toegestaan voor de groep van de bezoeker. Wordt een box uitgeschakeld, dan wordt ook het technische product uitgeschakeld en verdwijnt het uit de lijsten.


Winkelwagen, bestellingen en voorraad
- Prijs per regel: de prijs van de box wordt op zijn winkelwagenregel opgeslagen; twee boxen met verschillende inhoud houden hun eigen prijs. Klantgroepkortingen gelden; catalogusprijsregels en kwantumkortingen gelden niet voor boxen.
- Voorraad van onderdelen: bij het toevoegen gecontroleerd over de hele winkelwagen (andere boxen en los gekochte producten). Verhoogt de klant het aantal van een box boven de voorraad, dan wordt het op de winkelwagenpagina met een melding teruggebracht tot het maximum.
- Bestellingen: de voorraad van elk onderdeel wordt afgeboekt bij het bevestigen van de bestelling, teruggeboekt als de bestelling naar geannuleerd of betalingsfout gaat, en opnieuw afgeboekt bij heractivering. Een bestelling die direct in een foutstatus wordt aangemaakt, boekt geen voorraad af.
- Niet-beschikbare boxen: een box die verwijderd, uitgeschakeld, afgelopen, nog niet begonnen of voor een andere groep bedoeld is, wordt op de winkelwagen- en bestelpagina’s uit de winkelwagen gehaald, ook na opnieuw bestellen.
- Back-office en factuur: inhoud (per slot), cadeauverpakking, cadeaubericht en, bij een box op gewicht, het totaalgewicht staan op de bestelling en de factuur.


Statistieken
De knop Analytics in de lijst opent een dashboard met een periodekeuze (7, 30, 90 of 365 dagen):
- bestelde boxen, omzet exclusief btw, gemiddeld aantal artikelen per box, conversie (bestellingen / weergaven);
- per box: weergaven van de configurator, toevoegingen aan de winkelwagen, bestellingen, boxen, toevoegratio, conversie, omzet en gemiddelde prijs;
- vaakst gekozen artikelen en vaakst bestelde combinaties.
Weergaven en toevoegingen worden geteld sinds versie 1.2.0, zonder robots; geannuleerde bestellingen tellen niet mee.

Tracking met Google Analytics 4
Na het toevoegen van een box stuurt de configurator een add_to_cart-event naar window.dataLayer (als Google Tag Manager of gtag.js aanwezig is) met currency, value en het artikel dfbox-ID. Daarnaast wordt op document een dfbox:added-event met dezelfde gegevens afgevuurd, voor andere tools.
FAQ en probleemoplossing
Knoppen doen niets of de pagina blijft leeg
Leeg de cache van PrestaShop (Geavanceerde instellingen > Prestaties) en schakel tijdens het testen het samenvoegen van JS/CSS-bestanden uit. Controleer of de box actief is, aan de winkel gekoppeld en minstens één productbron heeft.
Het raster is leeg
De bronnen moeten producten bevatten die in de huidige winkel actief en bestelbaar zijn. Als producten zonder voorraad worden verborgen, verschijnen ze niet. In een box op gewicht of met prijs op gewicht verschijnen ook producten zonder gewicht niet.
Een product verschijnt niet in een box op gewicht
Het heeft geen gewicht. Vul het in op de productpagina, tabblad Verzending, of in de gewichtsimpact van de combinaties. De waarschuwing bovenaan het boxformulier toont om hoeveel kiesbare producten het gaat.
Een box die zichtbaar is in een categorie toont 0,00
Werk de module bij naar 1.2.1 of hoger: de lijsten tonen dan de vanaf-prijs.
De box verschijnt niet voor een klant
Controleer de verkoopdata, de beperkte voorraad en de klantgroepen op het tabblad Beschikbaarheid.
De bewerklink verschijnt niet
Hij staat alleen in de winkelwagen en bij het afrekenen, voor een box die nog beschikbaar is. Open in het Classic-thema het personalisatievenster van de regel.
De voorraad van de onderdelen daalt niet
Die wordt afgeboekt bij het bevestigen van de bestelling, niet bij het toevoegen aan de winkelwagen, en alleen als voorraadbeheer aan staat. Een geannuleerde bestelling boekt de voorraad terug.