# Productpersonalisatie (gravure, tekst, afbeelding): volledige gids > Overzicht Met de module Productpersonalisatie kunnen uw klanten een artikel rechtstreeks vanaf de productpagina personaliseren: invoer van een tekst / gravure (met lettertype en kleur) of upload van een afbeelding.… - Pagina: - Taal: nl - Bijgewerkt op: 2026-09-10 - Andere talen: [fr](https://www.datafirefly.com/documentation/dfcustomizer/index.md), [en](https://www.datafirefly.com/en/documentation/dfcustomizer/index.md), [es](https://www.datafirefly.com/es/documentation/dfcustomizer/index.md), [de](https://www.datafirefly.com/de/documentation/dfcustomizer/index.md), [it](https://www.datafirefly.com/it/documentation/dfcustomizer/index.md), [pl](https://www.datafirefly.com/pl/documentation/dfcustomizer/index.md), [pt](https://www.datafirefly.com/pt/documentation/dfcustomizer/index.md) - Index: ## Overzicht Met de module **Productpersonalisatie** kunnen uw klanten een artikel rechtstreeks vanaf de productpagina personaliseren: invoer van een **tekst / gravure** (met lettertype en kleur) of **upload van een afbeelding**. De personalisatie verschijnt als **live voorbeeld op de productfoto**: positionering via slepen, instelbare grootte en rotatie, en elke optie kan een **prijstoeslag** toepassen (vast bedrag of percentage) die automatisch aan de winkelwagen wordt toegevoegd. De module is compatibel met **PrestaShop 8.x en 9.x**. Ze maakt haar eigen tabellen aan en overschrijft de bestaande productpagina's niet: de personalisatie wordt aangestuurd door opties die u aanmaakt, gericht per categorie en verfijnbaar per product. ## Installatie 1. Zip de map `dfcustomizer` (of gebruik rechtstreeks het meegeleverde archief `dfcustomizer.zip`). 2. Open in de back-office **Modules > Modulebeheer**. 3. Klik op **Een module installeren** en sleep het ZIP-archief erin. 4. Klik na de installatie op **Configureren** om uw opties aan te maken. Bij de installatie maakt de module de nodige tabellen aan (`dfc_option` en gekoppelde tabellen, `dfc_product_override`, `dfc_customization`) en registreert ze de weergavehooks op de productpagina, de winkelwagen en de bestelling. ## Configuratie: een optie aanmaken Ga naar **Modules > dfcustomizer > Configureren** om uw personalisatieopties aan te maken en te beheren. Elke optie bepaalt een personalisatietype, de prijsimpact en het toepassingsgebied. ### Personalisatietype - **Tekst / gravure**: de klant voert een tekst in. U kunt een keuze van **lettertype** en **kleur** aanbieden (beide optioneel). - **Afbeeldingsupload**: de klant uploadt een bestand in het formaat **JPG, PNG of WEBP**. ### Prijsimpact Elke optie kan een toeslag op de productprijs toevoegen: - een **vast bedrag excl. btw**, of - een **percentage** van de productprijs. De toeslag wordt in realtime aan klantzijde getoond en doorgerekend in de winkelwagen (zie de sectie Winkelwagen en prijs). ### Targeting per categorie Vink de **categorieën** aan waarop de optie van toepassing moet zijn: de optie verschijnt alleen op de producten van die categorieën. Is **geen enkele categorie** aangevinkt, dan geldt de optie voor **de hele catalogus**. ### Productoverride Op de **productpagina** (tabblad **Modules**) heeft elk product een override-instelling. Het kan: - **erven** van de opties bepaald door de categorieën (standaardgedrag); - **eigen opties kiezen**, specifiek voor dit product; - de personalisatie voor dit product volledig **uitschakelen**. ## Aan klantzijde (front-office) Op de productpagina voert de klant zijn tekst in (lettertype, kleur) of uploadt hij zijn afbeelding. De personalisatie verschijnt onmiddellijk als **live voorbeeld op de productfoto**: - **positionering** via slepen op de afbeelding; - **schuifregelaars voor grootte en rotatie** om het resultaat bij te stellen. De prijstoeslag van de gekozen opties wordt live getoond. Bij het toevoegen aan de winkelwagen worden de personalisatie en een **afgeplat voorbeeld in PNG-formaat** opgeslagen, terug te vinden in de bestelling. ## Winkelwagen en prijs De toeslag wordt aan de artikelprijs in de winkelwagen toegevoegd via een prijsregel gekoppeld aan de winkelwagen (`SpecificPrice` gekoppeld aan de `id_cart`). Deze toeslag wordt **bij elke opslag van de winkelwagen herberekend** en **automatisch verwijderd** als het product uit de winkelwagen wordt gehaald. **Let op:** er is slechts één personalisatie mogelijk per combinatie _product / variant_ en per winkelwagen. ## Aan bestelzijde ### Back-office Op de pagina van een bestelling vat een blok **"Productpersonalisaties"** elke personalisatie samen: de ingevoerde tekst, het **downloadbare klantbestand** en het gegenereerde voorbeeld. U beschikt zo over alles wat nodig is voor de productie (gravure, druk, enzovoort). ### Front-office De klant vindt een herinnering aan zijn personalisaties terug op het **detail van zijn bestelling**. ## Technische aantekeningen - **Aangemaakte tabellen:** `dfc_option` (+ `dfc_option_lang` en `dfc_option_category`), `dfc_product_override`, `dfc_customization`. - **Prijstoeslag:** toegepast via `SpecificPrice` gekoppeld aan de winkelwagen (`id_cart`), herberekend bij elke opslag van de winkelwagen en verwijderd als het product wordt weggehaald. - **Klantbestanden:** opgeslagen in `modules/dfcustomizer/uploads/`, een map waarvan de PHP-uitvoering om veiligheidsredenen wordt geblokkeerd door een `.htaccess`-bestand. **Beperking:** één personalisatie per combinatie product/variant en per winkelwagen. ## Probleemoplossing ### De personalisatieoptie verschijnt niet op de productpagina Controleer of de optie actief is en of haar **categorieën** de categorie van het product omvatten (of dat geen enkele categorie is aangevinkt om de hele catalogus te bestrijken). Controleer vervolgens de **productoverride** (tabblad Modules van de fiche): de personalisatie mag voor dit product niet zijn uitgeschakeld. Leeg ten slotte de PrestaShop-cache. ### De prijstoeslag verschijnt niet in de winkelwagen De toeslag wordt herberekend bij de opslag van de winkelwagen. Controleer of de optie wel een prijsimpact heeft (vast bedrag of percentage) en herlaad de winkelwagen. Is het product verwijderd en opnieuw toegevoegd, dan moet de personalisatie opnieuw gebeuren. ### De afbeeldingsupload wordt geweigerd Alleen de formaten **JPG, PNG en WEBP** worden aanvaard. Controleer het bestandsformaat en de maximale uploadgrootte die uw hosting toestaat (`upload_max_filesize` / `post_max_size` in PHP). ## Verwijderen Bij het verwijderen worden de hooks en de configuratie van de module weggehaald. Maak vooraf een back-up van de klantbestanden in `modules/dfcustomizer/uploads/` en van de personalisatiegegevens van de bestellingen als u die wilt bewaren. ## FAQ ### Is de module compatibel met PrestaShop 9? Ja, de module is compatibel met PrestaShop 8.x en 9.x. ### Kan ik de personalisatie aanrekenen? Ja. Elke optie kan een toeslag toepassen, als vast bedrag excl. btw of als percentage van de productprijs, automatisch toegevoegd aan de winkelwagen. ### Kan een optie tot bepaalde producten worden beperkt? Ja, op twee manieren: via de **categorietargeting** van de optie, en via de **productoverride** waarmee elke fiche kan erven, eigen opties kan kiezen of de personalisatie kan uitschakelen. ### Kan de klant meerdere personalisaties op eenzelfde artikel toevoegen? Er wordt één personalisatie geregistreerd per combinatie product/variant en per winkelwagen.