# Geboortelijst, Huwelijkslijst & Cadeaus: volledige gids

> Overzicht en vereisten De module Geboortelijst, Huwelijkslijst & Cadeaus voegt aan uw winkel een volwaardig systeem van gedeelde cadeaulijsten toe. Uw klanten maken hun lijst vanuit hun account aan, zetten…

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

## Overzicht en vereisten

De module Geboortelijst, Huwelijkslijst & Cadeaus voegt aan uw winkel een volwaardig systeem van gedeelde cadeaulijsten toe. Uw klanten maken hun lijst vanuit hun account aan, zetten er producten uit uw catalogus in en delen een openbare link. Hun naasten reserveren de cadeaus, die in de winkelwagen belanden en bij de validatie van de bestelling worden bevestigd. De eigenaar van de lijst krijgt dan een e-mail.

- Geschikt voor PrestaShop 8.0 tot 9.x.
- PHP 7.4 tot 8.3, MySQL 5.7+ of MariaDB 10.3+.
- Multistore en meertalig (FR/EN/ES/DE/IT).
- Architectuur met ObjectModel en legacy frontcontrollers, zonder Symfony-afhankelijkheid en zonder override van de kern.

De module maakt drie eigen tabellen aan (`df_giftregistry`, `df_giftregistry_item` en `df_giftregistry_reservation`) en raakt geen enkel bestand van de kern aan. Bij het verwijderen verdwijnen die tabellen, het beheertabblad en de instellingen.

## Installatie

1. Download het archief `dfgiftregistry.zip` vanuit uw klantaccount.
2. Ga in de backoffice naar **Modules > Modulebeheer**.
3. Klik op **Een module installeren** en plaats het archief.
4. De installatie maakt de tabellen aan, registreert de hooks (`displayCustomerAccount`, `displayProductAdditionalInfo`, `actionFrontControllerSetMedia` en `actionValidateOrder`) en voegt het beheertabblad toe onder **Klanten**.

Na de installatie is de module meteen actief: het lijstblok verschijnt in de klantenzone en de toevoegknop op de productfiche.

## Instellingen van de module

Klik in het Modulebeheer op **Configureren** om bij de instellingenpagina te komen:

- **Knop op de productfiche**: toont of verbergt de knop « Toevoegen aan een cadeaulijst » op de productpagina's.
- **Geven door gasten**: laat bezoekers die niet zijn ingelogd toch een cadeau geven, met hun naam en een optioneel e-mailadres.
- **Melding aan de eigenaar**: stuurt de eigenaar bij elk bevestigd cadeau een e-mail.
- **Namen tonen**: toont de naam van de gever aan de eigenaar, tenzij de gever anoniem wil blijven.
- **Bewaartermijn** (`DFGR_HOLD_MINUTES`, standaard 180 minuten): de termijn waarna een wachtende, niet afgeronde reservering automatisch wordt vrijgegeven.
- **Maximaal aantal lijsten per klant** (`DFGR_MAX_PER_CUSTOMER`, standaard 5).

## Aan klantzijde: een lijst maken en beheren

### Een lijst maken

Vanuit zijn account opent de klant het onderdeel met de cadeaulijsten en maakt hij een nieuwe lijst aan. Hij kiest een type (geboorte, huwelijk, verjaardag, housewarming, andere), geeft een titel op, en kan een datum voor de gebeurtenis, een welkomstboodschap, een beschrijving en een leveradres invullen. De lijst is standaard openbaar, maar kan privé worden gezet.

### Producten toevoegen

Dat kan op twee manieren:

- Vanaf de **productfiche**: de klant kiest een van zijn lijsten, geeft het gewenste aantal op en klikt op « Toevoegen ». De variant die op de fiche is gekozen, wordt meegenomen.
- Vanuit het **beheerscherm** van de lijst: daar past hij het gewenste aantal en de voorrang van elk product aan.

Staat een product al in de lijst, dan verhoogt het toevoegen vanaf de productfiche eenvoudigweg het gewenste aantal.

### De lijst delen

Elke lijst heeft een unieke openbare link. Een knop « Kopiëren » zet die link op het klembord, klaar om per e-mail of bericht naar de naasten te sturen.

### De ontvangen cadeaus volgen

In het beheerscherm ziet de eigenaar per product een voortgangsbalk met wat gereserveerd is en wat rest, plus de lijst met ontvangen cadeaus, met de naam van de gever volgens de instelling voor het tonen van namen.

## Aan bezoekerszijde: een cadeau geven

Wie de openbare link opent, ziet de lijst: het type, de naam van de eigenaar, de datum van de gebeurtenis, de welkomstboodschap en het productraster. Elk product toont zijn voortgang met gereserveerd en resterend.

1. De bezoeker klikt onder het gekozen product op **Dit cadeau geven**.
2. Hij geeft het aantal op (begrensd tot wat rest), een optioneel woordje, en, als hij niet is ingelogd, zijn naam en een optioneel e-mailadres.
3. Hij kan « Anoniem blijven » aanvinken als de instelling voor het tonen van namen aanstaat.
4. Bij het bevestigen wordt het product gereserveerd en aan zijn winkelwagen toegevoegd; hij gaat naar de winkelwagen om de bestelling af te ronden.

Staat het geven door gasten uit, dan kunnen alleen ingelogde klanten een cadeau geven.

## De reserveringscyclus

Een reservering doorloopt de volgende toestanden:

- **In afwachting**: aangemaakt zodra de bezoeker op « Dit cadeau geven » klikt en het product in de winkelwagen belandt.
- **Bevestigd**: bij de validatie van de bestelling (hook `actionValidateOrder`) wordt de reservering die aan de winkelwagen hangt bevestigd en aan de bestelling gekoppeld.
- **Vrijgegeven**: een wachtende reservering die niet is afgerond en aan een verlaten winkelwagen hangt, verdwijnt automatisch na de bewaartermijn.

Wat van een product rest, is het gewenste aantal min de som van de wachtende en de bevestigde reserveringen. Is een product volledig gereserveerd, dan wordt het vergrendeld en kan het niet meer worden gegeven, wat dubbels voorkomt.

## Aan handelaarszijde: de backoffice

Het tabblad **Cadeaulijsten** (onder Klanten) toont alle lijsten van de winkel: de klant, het type, het aantal producten, het aantal cadeaus, de status actief of inactief en de aanmaakdatum.

De detailweergave van een lijst toont:

- de gegevens van de lijst en van de klant;
- de producten met het gewenste, gereserveerde en resterende aantal;
- de reserveringen met de gever, het aantal, het bericht, de status en een rechtstreekse link naar de bijbehorende bestelling.

De lijsten worden door de klanten aangemaakt: aanmaken kan niet vanuit de backoffice. De handelaar kan raadplegen en verwijderen.

## Meldingsmails

Staat de melding aan de eigenaar aan, dan gaat er bij elk bevestigd cadeau een e-mail naar de eigenaar van de lijst. Die vermeldt de titel van de lijst, het gegeven product, het aantal, de naam van de gever (volgens de instelling en de keuze om anoniem te blijven) en het eventuele bericht. De e-mailsjablonen worden in het Frans en het Engels geleverd en zijn aan te passen.

## Meertaligheid en multistore

De opschriften van de module zijn te vertalen via het vertaalsysteem voor modules van PrestaShop. De weergave volgt de huidige winkelcontext: een lijst die in een winkel is aangemaakt, blijft aan die winkel hangen.

## FAQ en probleemoplossing

### De knop « Toevoegen aan een lijst » verschijnt niet op de productfiche

Controleer of de optie **Knop op de productfiche** in de instellingen aanstaat, en of de hook `displayProductAdditionalInfo` wel in uw thema is geplaatst.

### De openbare pagina meldt « lijst niet gevonden »

De lijst is misschien privé, inactief, of aan een andere winkel gekoppeld. Controleer haar status in de klantenzone of in de backoffice.

### Een product blijft geblokkeerd hoewel er geen bestelling is geplaatst

Dat is een wachtende reservering. Die wordt automatisch vrijgegeven na de bewaartermijn uit de instellingen. U kunt die termijn zo nodig verlagen.

### De eigenaar krijgt geen e-mail

Controleer of de melding aan de eigenaar aanstaat en of het versturen van e-mails goed is ingesteld in **Geavanceerde parameters > E-mail**.

### Wat gebeurt er bij het verwijderen?

Bij het verwijderen verdwijnen de drie tabellen van de module, het beheertabblad en de instellingen. Er blijven geen restgegevens achter.
