# Cadeauverpakking & Bericht: volledige gids

> Overzicht De module Cadeauverpakking & Bericht (dfgiftwrap) voegt in het bestelproces de keuze toe voor een betalende cadeauverpakking en een persoonlijk kaartje met bericht. De klant kiest een geïllustreerde verpakkingsoptie,…

- Pagina: <https://www.datafirefly.com/nl/documentation/dfgiftwrap/>
- Taal: nl
- Bijgewerkt op: 2026-09-09
- Andere talen: [fr](https://www.datafirefly.com/documentation/dfgiftwrap/index.md), [en](https://www.datafirefly.com/en/documentation/dfgiftwrap/index.md), [es](https://www.datafirefly.com/es/documentation/dfgiftwrap/index.md), [de](https://www.datafirefly.com/de/documentation/dfgiftwrap/index.md), [it](https://www.datafirefly.com/it/documentation/dfgiftwrap/index.md), [pl](https://www.datafirefly.com/pl/documentation/dfgiftwrap/index.md), [pt](https://www.datafirefly.com/pt/documentation/dfgiftwrap/index.md)
- Index: <https://www.datafirefly.com/nl/documentation/llms.txt>

## Overzicht

De module **Cadeauverpakking & Bericht** (`dfgiftwrap`) voegt in het bestelproces de keuze toe voor een **betalende cadeauverpakking** en een **persoonlijk kaartje met bericht**. De klant kiest een geïllustreerde verpakkingsoptie, kan daar een vrij bericht bij voegen, en de bijbehorende kosten worden netjes in het besteltotaal opgenomen: btw, valuta en multistore worden door de kern van PrestaShop afgehandeld, tot op de factuur.

De kosten zijn niet louter een weergave: zij hangen aan een eigen kostenproduct met een specifieke prijs die tot de winkelwagen van de klant beperkt blijft. Het bedrag komt dus vanzelf in de totalen, de bestelling en de factuur terecht, met de juiste btw.

## Compatibiliteit

- PrestaShop 8.0 tot 9.x
- Eén winkel en multistore
- PHP 7.4 tot 8.3
- Classic-thema en eigen thema's
- Interface geleverd in het Frans en volledig vertaalbaar
- Geen enkele afhankelijkheid (geen Composer, geen framework)

## Installatie

1. Open in de backoffice **Modules > Modulebeheer**.
2. Klik op **Een module installeren** en kies het bestand `dfgiftwrap.zip`.
3. Klik na de installatie op **Configureren**.

Bij de installatie maakt de module zijn tabellen aan, registreert hij zijn hooks (bestanden aan de frontzijde, blok bij het afrekenen, validatie van de bestelling, bestelfiche in de backoffice, bevestiging) en maakt hij een **verborgen kostenproduct** aan (referentie `DF-GIFTWRAP-FEE`): virtueel, niet zichtbaar in de winkel en zonder getoonde prijs. Dat product draagt het bedrag voor de verpakking en het kaartje in de winkelwagen. Verwijder het niet handmatig.

## Configuratie

### Algemene instellingen

- **Cadeauverpakking inschakelen**: toont of verbergt het blok met de verpakkingsopties bij het afrekenen.
- **Kaartje met bericht inschakelen**: toont of verbergt de optie met kaartje en bericht.
- **Prijs van het kaartje**: het bedrag (exclusief btw) dat wordt aangerekend wanneer de klant een kaartje toevoegt.
- **Maximale lengte van het bericht**: het toegelaten aantal tekens (standaard 200). Tijdens het typen ziet de klant een teller.
- **Groep belastingregels**: de btw-groep die op de verpakkings- en kaartkosten wordt toegepast.

### De verpakkingsopties beheren

Klik op de configuratiepagina op **« De opties beheren »** om het aparte scherm te openen (controller `AdminDfGiftWrapOptions`). Daar maakt u zoveel opties aan als u wilt, elk met:

- **Naam**: het meertalige opschrift van de optie (bijvoorbeeld « Elegant kraftpapier » of « Premium geschenkdoos »).
- **Prijs**: het bedrag exclusief btw van de verpakkingsoptie.
- **Afbeelding**: het beeld dat de optie illustreert (automatisch naar JPG genormaliseerd).
- **Positie**: de weergavevolgorde, aan te passen door slepen en neerzetten.
- **Actief**: toont of verbergt de optie aan winkelzijde zonder die te verwijderen.

De naam is een meertalig veld: kies elke taal in de taalkiezer van het veld om het opschrift van de optie te vertalen.

## Werking

### Bij het afrekenen

Het blok met de verpakking en het kaartje wordt boven aan het besteloverzicht geïnjecteerd via de hook `displayCheckoutSummaryTop`. De klant kiest een verpakkingsoptie, schakelt eventueel het kaartje in en typt zijn bericht. De keuze wordt via AJAX bewaard. Omdat de keuze het bedrag wijzigt, wordt het totaal ververst zodat de kosten kloppen; het bericht wordt bewaard zonder overbodig herladen.

### Het mechanisme achter de kosten

Bij elke keuze berekent de module het totale bedrag (verpakkingsoptie plus kaartje) en maakt hij een **specifieke prijs** (`SpecificPrice`) aan die tot de lopende winkelwagen beperkt blijft en op het verborgen kostenproduct wordt toegepast. Dat product komt in de winkelwagen zodra het bedrag hoger is dan nul, en verdwijnt er anders uit. PrestaShop past daarna de btw, de valuta en de multistorecontext toe, en de kosten verschijnen als een gewone regel in de totalen, de bestelling en de factuur.

### Waar het bericht verschijnt

Bij de validatie van de bestelling (`actionValidateOrder`) wordt de keuze vastgezet. Het bericht dat de klant typte, is op drie plaatsen zichtbaar:

- op de **bestelfiche in de backoffice** (een eigen blok via `displayAdminOrderMain`);
- op de **bevestigingspagina** die de klant na de aankoop ziet;
- in het **native cadeauveld** van de bestelling (`gift_message`, met `gift = 1`), waardoor het in de standaardmails van PrestaShop verschijnt.

Omdat het bericht ook in het native cadeauveld wordt weggeschreven, tonen uw e-mailsjablonen en uw voorbereidingstools die dat veld al gebruiken het woordje van de klant zonder extra configuratie.

## FAQ en probleemoplossing

### Gaat het om een cadeaubon of een waardebon?

Nee. De module regelt een dienst voor cadeauverpakking en een kaartje om weg te geven, geen betaalmiddel en geen waardebon. De klant betaalt voor een verpakking en kan er een opdracht bij zetten.

### De kosten verschijnen niet in het totaal

Controleer of het verborgen kostenproduct (`DF-GIFTWRAP-FEE`) nog bestaat en of er minstens één verpakkingsoptie actief is. Leeg de cache van PrestaShop en herlaad de bestelpagina. De kosten gelden alleen wanneer het berekende bedrag hoger is dan nul.

### De startpagina of de winkel wordt wit na de installatie

Zorg dat u de recentste versie van de module gebruikt en leeg de cache. Het kostenproduct is bewust niet zichtbaar in de winkel; maak het niet zichtbaar en verwijder het niet handmatig.

### Het bericht wordt afgekapt

Het bericht wordt begrensd door de instelling **Maximale lengte van het bericht**. Verhoog die waarde in de configuratie als uw klanten langere teksten nodig hebben.

### Hoe voeg ik Engels, Spaans, Duits of Italiaans toe?

De interface wordt in het Frans geleverd en is volledig vertaalbaar. Ga naar **Geavanceerde parameters > Vertalingen > Vertalingen van de geïnstalleerde modules**, kies `dfgiftwrap` en de taal, en vertaal de teksten. De namen van de verpakkingsopties vertaalt u rechtstreeks in hun meertalige veld.

### Werkt de module met PrestaShop 9?

Ja. De module is ontworpen en getest van PrestaShop 8.0 tot 9.x, met een legacy beheercontroller, zowel met één winkel als in multistore.