Cadeauverpakking & Bericht: volledige gids
Cadeauverpakking, persoonlijk kaartje en cadeaubon installeren, instellen en gebruiken in PrestaShop 1.7.8, 8 en 9.
Presentatie
De module Cadeauverpakking en boodschap (dfgiftwrap) voegt een echte cadeauservice toe aan het afrekenen: verpakking van de hele bestelling of per artikel, een persoonlijk kaartje met live voorbeeld en een cadeaubon zonder prijzen. De kosten lopen via de eigen mechanismen van PrestaShop (btw, valuta, facturen, creditnota’s) en de inpakafdeling krijgt een lijst met voor te bereiden cadeaus, met kaartjes en bonnen om als PDF af te drukken.

Nieuw in versie 2.0.0
- Compatibel met PrestaShop 1.7.8, 8 en 9 (PHP 7.4 tot 8.5), thema’s Classic en Hummingbird, module dfsimplecheckout.
- Inpakken per artikel, beschikbaarheidsperiode, voorraad verpakkingen, geschikte categorieën, opties per winkel.
- Kaartje met live voorbeeld, ideeën per gelegenheid, velden Voor / Van, cadeaubon zonder prijzen.
- Inpakafdeling: lijst met voor te bereiden cadeaus, kaartjes A6 en bonnen A5 als PDF, gemeten statistieken, optionele e-mail.
- Interface, e-mails en PDF’s in 8 talen.
- Belangrijke correcties ten opzichte van 1.0.0: de keuze van de klant werd niet opgeslagen, de bestelpagina gaf een fout in PrestaShop 9 en de boodschap werd afgekapt bij het eerste „<”.
Compatibiliteit
- PrestaShop 1.7.8 tot 9.x, enkele winkel of multistore
- PHP 7.4 tot 8.5
- Thema’s Classic en Hummingbird; module dfsimplecheckout
- Geen afhankelijkheden
Installatie en update
- Klik in Modules > Modulebeheer op Een module uploaden en kies
dfgiftwrap-2.0.0.zip. - Het menu Bestellingen > Cadeauverpakking verschijnt. Open Verpakkingsopties en klik op 4 voorbeeldopties aanmaken, of maak uw eigen opties.
- Kies in de Instellingen de btw-regel voor cadeaudiensten.
Bij de installatie maakt de module een verborgen product aan (referentie DF-GIFTWRAP-FEE) dat het bedrag van de cadeaudiensten draagt. Het is onzichtbaar, wordt niet geïndexeerd, de pagina ervan geeft een 404-fout en het wordt opnieuw aangemaakt als het verwijderd wordt. Wijzig het niet: met het paneel Status in de instellingen kunt u het controleren en herstellen.
Vanaf 1.0.0: upload gewoon de nieuwe zip. Opties, hun afbeeldingen, instellingen en boodschappen van eerdere bestellingen blijven behouden; de afbeeldingen worden gekopieerd naar /img/dfgiftwrap/.
Instellingen

- Verpakking: verpakking inschakelen, inpakken per artikel, het aanbod op de winkelwagenpagina en de vermelding op productpagina’s.
- Persoonlijk kaartje: prijs (0 = gratis), maximale lengte en aantal regels, velden Voor / Van, ideeën voor boodschappen, emoji (standaard verwijderd omdat ze niet afdrukbaar zijn; ♥ ★ ☺ worden altijd geaccepteerd).
- Prijzen, btw en documenten: btw-regel, kortingen van klantengroepen (standaard uitgeschakeld), cadeaubon, weergave op de pakbon, kopie van de boodschap naar het eigen cadeaubericht van PrestaShop.
- Inpakafdeling, privacy, uiterlijk: e-mail naar de inpakafdeling, automatisch wissen van boodschappen na N dagen, accentkleur.
Het paneel Status meldt ook of de eigen cadeauverpakking van PrestaShop actief is en biedt aan die met één klik uit te schakelen (ze wordt weer ingeschakeld als u de module verwijdert).
Verpakkingsopties

Elke optie heeft een naam en beschrijving in meerdere talen, een prijs excl. btw (standaardvaluta), een afbeelding (JPG, PNG, GIF of WebP, max. 3 MB, SVG geweigerd) en kan worden aangeboden voor de hele bestelling, per artikel of beide. U kunt een optie beperken tot een periode, een voorraad verpakkingen (daalt bij elke bestelling, wordt teruggezet als de bestelling geannuleerd wordt, bij 0 verdwijnt de optie), categorieën (voor de hele bestelling moet elk product geschikt zijn) of bepaalde winkels.

Boodschappen voor het kaartje
Er worden zes gelegenheden in 8 talen aangemaakt (verjaardag, Kerstmis, bedankt, gefeliciteerd, met liefde, Moederdag). De klant klikt op een gelegenheid om het kaartje in te vullen en past de tekst daarna vrij aan. U kunt ze wijzigen, herschikken of aanvullen.

Klantervaring
In het besteloverzicht (en op de winkelwagenpagina indien ingeschakeld) opent het aanbod een venster met drie keuzes: geen verpakking, de hele bestelling of per artikel.


Het kaartje wordt geschreven met een teller voor tekens en regels (voorgelezen door schermlezers) en een live voorbeeld. De cadeaubon zonder prijzen voegt u toe met één klik.

Bij het opslaan wordt de keuze vastgelegd zonder de pagina te herladen en worden de totalen bijgewerkt: de cadeaudiensten verschijnen als subtotaal „Cadeauverpakking & kaartje”. De keuze blijft bewaard als de klant teruggaat of de pagina herlaadt.


Na de aankoop vindt de klant de cadeauopties terug op de bevestigingspagina en in de besteldetails in zijn account. Een discrete vermelding kan ook op productpagina’s verschijnen.


Kosten, btw en facturen
- Het bedrag staat op één regel (het verborgen product) waarvan de prijs aan de winkelwagen gekoppeld is en op de server wordt herberekend op basis van de gekozen opties.
- De btw-regel is die uit de instellingen; de prijs wordt omgerekend naar de valuta van de klant; groepskortingen gelden niet, tenzij u ze inschakelt.
- De regel blijft nooit alleen in de winkelwagen achter: als de klant alle artikelen verwijdert, verdwijnt hij samen met de keuze.
- In de bestelling krijgt de regel een naam in de taal van de klant (bijvoorbeeld „Cadeauverpakking & kaartje – Feestelijk rood · Kaartje”): hij staat op de factuur en kan worden terugbetaald met een gedeeltelijke creditnota.
Controleer met uw boekhouder welk btw-tarief op de cadeaudiensten van toepassing is. Modules die een drempel berekenen op het winkelwagentotaal (minimumbestelling, gratis cadeau) tellen dit bedrag ook mee.
Inpakafdeling en statistieken
Het menu Bestellingen > Cadeauverpakking toont de voor te bereiden cadeaus, de al ingepakte cadeaus of alle cadeaubestellingen van een periode, met wat er ingepakt moet worden en de boodschap. Druk een kaartje, alle kaartjes van de lijst of de cadeaubon af en klik daarna op Markeren als ingepakt. De cijfers worden gemeten op de bestellingen van de periode (geannuleerde bestellingen niet meegerekend).

Op de bestelpagina toont een blok de verpakking, de artikelen, het kaartje en afdrukknoppen; daar kan de tekst van het kaartje worden gecorrigeerd. Ook de pakbon van PrestaShop toont de verpakking en de boodschap.


De rechten van PrestaShop zijn van toepassing: een medewerker met alleen leesrechten kan raadplegen en afdrukken, maar geen cadeau als ingepakt markeren of opties wijzigen.
Beveiliging en persoonsgegevens
- AJAX-verzoeken beperkt tot de winkelwagen van de bezoeker, met een token gekoppeld aan de winkelwagen, alleen via POST, in beperkt aantal en geweigerd zodra de bestelling geplaatst is.
- De boodschap wordt opgeslagen zoals ze geschreven is en overal veilig weergegeven (winkel, back-office, PDF, e-mails).
- Boodschappen worden gewist wanneer een klant verwijderd wordt en kunnen na een periode automatisch worden gewist; ze zitten in de export van de klantgegevens.
Problemen oplossen
Het aanbod verschijnt niet
Controleer of de module ingeschakeld is en of minstens één optie actief is voor de winkel en vandaag beschikbaar is, of dat het kaartje ingeschakeld is. Een sterk aangepast thema moet de hook displayCheckoutSummaryTop aanroepen.
Het bedrag wordt niet toegevoegd
Open de instellingen en gebruik Controleren en herstellen in het paneel Status. Gratis opties en een gratis kaartje voegen geen regel toe.
Verwijderen
Opties, voorbeeldboodschappen en cadeaugegevens van bestellingen worden verwijderd; bestellingen, facturen en creditnota’s worden niet gewijzigd. Het verborgen product wordt verwijderd als het in geen enkele bestelling voorkomt, anders wordt het alleen gedeactiveerd.