PrestaShop productconfigurator: volledige handleiding (v2.0.1)
Installeren, een configurator in stappen opbouwen, prijzen instellen (formules, voorraad), een van de 14 branchesjablonen importeren en bestellingen volgen.
De DataFirefly productconfigurator maakt van een productpagina een begeleid traject: de klant kiest stap voor stap, ziet het product in het voorbeeld ontstaan en kent op elk moment de prijs die hij betaalt, berekend door PrestaShop. Deze handleiding behandelt versie 2.0.1, compatibel met PrestaShop 1.7.8, 8 en 9.

Installatie en update
Vereisten
- PrestaShop 1.7.8 t/m 9.x, thema Classic, Hummingbird of daarop gebaseerd
- PHP 7.2 t/m 8.5 met GD en fileinfo (standaardextensies)
- Geen cronjob, geen externe dienst
- Klik in Modules > Modulebeheer op Module uploaden en verstuur
datafireflyconfigurator-2.0.1.zip. - Het menu Modules > Productconfigurators verschijnt: maak een configurator of open de Sjablonenbibliotheek.
- Stel de gemeenschappelijke weergave in via Configureren (modus, accentkleur, mobiele balk, lettertypen).
Update vanaf 1.x of 2.0.0: installeer de zip 2.0.1 eroverheen. Configurators, velden, opties, winkelwagens en bestellingen blijven behouden; bestaande configurators houden de weergave met alle velden; bestanden van klanten gaan naar een privémap en de oude demoscripts worden verwijderd.
Een configurator maken
- Koppel een of meer producten en eventueel categorieën (inclusief subcategorieën).
- Kies de weergave: begeleide stappen (één tegelijk) of alle velden.
- Voeg stappen toe via het typepalet en daarna hun opties (label per taal, toeslag, gewicht, voorraad, referentie, kleur, miniatuur).
- Schakel het visuele voorbeeld in als je een live opgebouwde afbeelding wilt en sla op.

Veldtypes
- Keuzelijst, kaarten, kleurstalen, afbeeldingen: één keuze uit meerdere.
- Selectievakjes met minimaal en maximaal aantal keuzes.
- Tekst en tekstvak: gravure, bericht, referentie; lettertype, grootte en kleur naar keuze.
- Getal: maten, aantallen, met minimum, maximum, stap en variabelenaam voor formules.
- Bestandsupload: logo, foto, PDF- of DXF-tekening, recept.
- Datum met minimale termijn (productie, levering, afhalen).
Prijzen: wat de klant ziet, betaalt hij
Elke optie heeft een toeslag excl. btw in de standaardvaluta: vast bedrag, percentage van de basisprijs, per teken, per eenheid of een formule met getalvelden (breedte * hoogte / 10000 * 42). PrestaShop past daarna btw, acties, groepskortingen, staffelkortingen en de valuta van de klant toe. De productpagina toont precies deze berekening: de getoonde prijs is de prijs in de winkelwagen. De browser verstuurt alleen keuzes; er wordt nooit een prijs uit het verzoek gelezen.
Voorwaarden, voorraad en voorbeeld
- Alleen tonen als: een stap verschijnt pas als een van de gekozen opties geselecteerd is (accu bij de e-bike, recept bij correctieglazen).
- Voorraad van opties: leeg laten om niet bij te houden of een aantal invullen; het daalt bij elke bestelling en komt terug als de bestelling wordt geannuleerd. De klant ziet „Nog maar N” of „Niet beschikbaar”.
- Visueel voorbeeld: achtergrondafbeelding, lagen per optie (PNG of SVG), inkleuring van het silhouet, laag in de kleur van een ander veld, tekst en afbeelding van de klant in een met de muis getekende zone. Het eindbeeld wordt bij de bestelling bewaard.
Sjablonenbibliotheek
14 complete configurators, één per branche, geschreven in de 8 talen met hun voorbeeldbeelden. Klik op Importeren en kies: een demoproduct (verborgen of zichtbaar, met afbeelding, prijs, staffelkorting en voorraad), een van je producten of alleen de configurator. Alles blijft daarna aanpasbaar.

Voorbeelden per branche
Elk sjabloon zit in de bibliotheek. Eerst de klant op de productpagina, dan de instellingen in de backoffice.
Textiel · Gepersonaliseerd T-shirt
Kleur, maat, positie van de bedrukking, logo van de klant en tekst met lettertypekeuze. Staffelkorting voor teambestellingen.


Meubels · Massief houten tafel op maat
Lengte en breedte op de centimeter met prijs op basis van de oppervlakte, houtsoort, afwerking, poten en verlengstukken. Live voorbeeld.


Fietsen · Stadsfiets naar keuze
Maat, framevorm en -kleur, aandrijving met voorraad motoren, accu alleen bij de elektrische versie, accessoires zichtbaar in het voorbeeld.


Sieraden · Gegraveerde hanger
Metaal, vorm, ketting, gravure per letter met lettertypekeuze, datum op de achterkant en etui. Beperkte voorraad roségoud.


Computers · Pc op maat
Gebruik, behuizing, processor, geheugen, opslag, videokaart alleen voor creatief werk en gaming, met voorraad van onderdelen, systeem en garantie.


Signalisatie · Bedrukt bord of spandoek
Materiaal per m² (pvc, aluminium sandwich, spandoek, plexiglas), vrij formaat, afwerking per materiaal, drukbestand en staffelkorting.


Cadeaus · Stel je eigen cadeaubox samen
Formaat van de box, 3 tot 8 producten met voorraad per product, lint, kaartje en leverdatum: elk gekozen product verschijnt in de box.


Ramen en rolgordijnen · Rolgordijn op maat
Doek per m², kleur, montage op de muur of in de dag, maten op de centimeter, bediening met afstandsbediening alleen bij de motor, aluminium cassette per meter.


Keuken · Werkblad op maat
Materiaal per m², lengte en diepte, dikte en kant per meter, uitsparingen in het voorbeeld, maatschets van de klant, plaatsing.


Banketbakkerij en catering · Gepersonaliseerde verjaardagstaart
Aantal porties, smaak, glazuur en kleur, decoratie, tekst op de taart, eetbare foto, allergieën en afhaaldatum met minimale termijn.


Industrie B2B · Lasergesneden plaatwerkdeel
Vorm, materiaal, maten en dikte in mm met prijs op gewicht, gaten per stuk, behandeling, tolerantie in %, DXF-tekening verplicht bij vrije vorm, klantreferentie en korting vanaf 10 stuks.


Optiek · Stel je bril samen
Vorm en kleur van het montuur, soort glazen, recept verplicht bij correctieglazen, pupilafstand, coatings en etui.


Bloemist · Seizoensboeket naar keuze
Stijl, hoofdkleur, formaat, vaas met voorraad, kaartje in het voorbeeld, extra's, leverdatum en tijdvak.


Gepersonaliseerde cadeaus · Fotomok
Foto van de klant op de mok, tekst met lettertypekeuze, kleur van oor en binnenkant, inhoud en korting vanaf 6 mokken.


Op de productpagina
- Begeleide stappen met „Vorige / Volgende”, voortgangsbalk en controle voor de volgende stap.
- Overzicht van alle keuzes met toeslag en een link „Wijzigen” naar elke stap.
- Op mobiel blijft het voorbeeld bovenaan staan en houdt een vaste prijsbalk de knop binnen bereik.
- Met het toetsenbord te bedienen: kleurstalen als keuzerondjes, pijltjestoetsen om tekst en afbeelding te verplaatsen, zichtbare focus, prijs voorgelezen door schermlezers.
- Drie modi: geïntegreerd in de pagina, venster op volledig scherm of vervanging van de productpagina.
- Na het toevoegen worden de teller en het voorbeeld van de winkelwagen in het thema meteen bijgewerkt, zonder de pagina te herladen, met het venster van de module of van het thema.




Bestellingen, e-mails en facturen
Elke configuratie wordt een PrestaShop-personalisatie: zichtbaar in de winkelwagen, de bevestigingsmail, de factuur en de pakbon. In de bestelling toont het blok Personalisaties de details, het eindbeeld en de bestanden van de klant, alleen te downloaden door medewerkers.



Instellingen
Weergavemodus en plaatsing (automatisch of de hook displayDfProductConfigurator voor pagebuilders), accentkleur, verborgen standaard winkelwagenknop, mobiele prijsbalk, naam en stappenbalk, gedrag na het toevoegen, Google-lettertypen (standaard uit, vier vrije lettertypen meegeleverd) en bewaartermijn van niet-bestelde bestanden.

Beveiliging en privacy
- Bestanden van klanten buiten de module onder een willekeurige naam, nooit via een URL bereikbaar; echte inhoud gecontroleerd (een afbeelding moet een afbeelding zijn, geen PHP-code).
- Een bestand kan alleen door de uploader worden gebruikt; upload en winkelwagen zijn beveiligd met een token per bezoeker; maximaal 30 uploads per uur.
- Nooit bestelde bestanden worden na de gekozen termijn verwijderd (standaard 60 dagen), zonder cronjob; bestanden van bestellingen blijven.
Goed om te weten
- Een formule met
qtywordt berekend op de hoeveelheid bij het toevoegen; de staffelkortingen van het product volgen altijd de hoeveelheid in de winkelwagen. - Het voorbeeld is indicatief: de lagen schalen niet mee met de ingevoerde maten.