# Lista Nascita, Matrimonio e Regali — Guida completa > Presentazione e prerequisiti Il modulo Lista Nascita, Matrimonio e Regali aggiunge al tuo negozio un sistema completo di liste regali condivise. I tuoi clienti creano la loro lista dal proprio… - Pagina: - Lingua: it - Aggiornato il: 2026-06-18 - Altre lingue: [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), [pl](https://www.datafirefly.com/pl/documentation/dfgiftregistry/index.md), [pt](https://www.datafirefly.com/pt/documentation/dfgiftregistry/index.md), [nl](https://www.datafirefly.com/nl/documentation/dfgiftregistry/index.md) - Indice: ## Presentazione e prerequisiti Il modulo Lista Nascita, Matrimonio e Regali aggiunge al tuo negozio un sistema completo di liste regali condivise. I tuoi clienti creano la loro lista dal proprio account, aggiungono prodotti dal tuo catalogo e condividono un link pubblico. I loro parenti prenotano i regali, che vengono aggiunti al carrello e poi confermati alla convalida dell'ordine. Il proprietario della lista riceve quindi una notifica via email. - Compatibile con PrestaShop 8.0 a 9.x. - PHP 7.4 a 8.3, MySQL 5.7+ / MariaDB 10.3+. - Multi-negozio e multilingua (FR/EN/ES/DE/IT). - Architettura ObjectModel e controller front legacy, senza dipendenza da Symfony, senza override del core. Il modulo crea tre tabelle dedicate (`df_giftregistry`, `df_giftregistry_item`, `df_giftregistry_reservation`) e non altera alcun file del core. La disinstallazione rimuove queste tabelle, la scheda di amministrazione e le impostazioni. ## Installazione 1. Scarica l'archivio `dfgiftregistry.zip` dal tuo account cliente. 2. Nel back-office, vai su **Moduli > Gestione moduli**. 3. Fai clic su **Carica un modulo** e rilascia l'archivio. 4. L'installazione crea le tabelle, registra gli hook (`displayCustomerAccount`, `displayProductAdditionalInfo`, `actionFrontControllerSetMedia`, `actionValidateOrder`) e aggiunge la scheda di amministrazione in **Clienti**. Una volta installato, il modulo è immediatamente attivo: il blocco delle liste appare nell'account cliente e il pulsante di aggiunta nella scheda prodotto. ## Impostazioni del modulo Fai clic su **Configura** dalla Gestione moduli per accedere alla pagina delle impostazioni: - **Pulsante nella scheda prodotto**: mostra o nasconde il pulsante «Aggiungi a una lista regali» nelle pagine prodotto. - **Regalo degli ospiti**: consente ai visitatori non connessi di offrire un regalo indicando il proprio nome e un'email facoltativa. - **Notifica al proprietario**: invia un'email al proprietario per ogni regalo confermato. - **Rivelazione dei nomi**: mostra al proprietario il nome del donatore, salvo che il donatore abbia scelto di restare anonimo. - **Intervallo di conservazione** (`DFGR_HOLD_MINUTES`, 180 min per impostazione predefinita): il tempo dopo il quale una prenotazione in sospeso non finalizzata viene rilasciata automaticamente. - **Numero massimo di liste per cliente** (`DFGR_MAX_PER_CUSTOMER`, 5 per impostazione predefinita). ## Lato cliente: creare e gestire una lista ### Creare una lista Dal proprio account, il cliente apre la sezione delle liste regali e crea una nuova lista. Sceglie un tipo (nascita, matrimonio, compleanno, inaugurazione casa, altro), inserisce un titolo, e può indicare una data dell'evento, un messaggio di benvenuto, una descrizione e un indirizzo di consegna. La lista è pubblica per impostazione predefinita, ma può essere resa privata. ### Aggiungere prodotti Due possibilità: - Dalla **scheda prodotto**: il cliente seleziona una delle sue liste, sceglie la quantità desiderata e fa clic su «Aggiungi». La combinazione selezionata nella scheda viene presa in considerazione. - Dall'**area di gestione** della lista: regola la quantità desiderata e la priorità di ogni prodotto. Se un prodotto è già presente nella lista, l'aggiunta dalla scheda prodotto incrementa semplicemente la quantità desiderata. ### Condividere la lista Ogni lista dispone di un link pubblico univoco. Un pulsante «Copia» colloca questo link negli appunti, pronto per essere inviato ai parenti via email o messaggistica. ### Monitorare i regali ricevuti Nell'area di gestione, il proprietario visualizza per ogni prodotto una barra di avanzamento prenotato / rimanente, nonché l'elenco dei regali ricevuti, con il nome del donatore in base all'impostazione di rivelazione dei nomi. ## Lato visitatore: offrire un regalo Aprendo il link pubblico, un parente scopre la lista: tipo, nome del proprietario, data dell'evento, messaggio di benvenuto e griglia dei prodotti. Ogni prodotto mostra il suo avanzamento prenotato / rimanente. 1. Il visitatore fa clic su **Offri questo regalo** sotto il prodotto scelto. 2. Indica la quantità (limitata al rimanente), un breve messaggio facoltativo, e — se non è connesso — il proprio nome e un'email facoltativa. 3. Può spuntare «Resta anonimo» se l'impostazione di rivelazione dei nomi è attivata. 4. Alla conferma, il prodotto viene prenotato e aggiunto al suo carrello; viene reindirizzato al carrello per finalizzare l'ordine. Se il regalo degli ospiti è disattivato, solo i clienti connessi possono offrire un regalo. ## Il ciclo di prenotazione Una prenotazione attraversa i seguenti stati: - **In sospeso**: creata non appena il visitatore fa clic su «Offri questo regalo» e il prodotto viene aggiunto al carrello. - **Confermata**: alla convalida dell'ordine (hook `actionValidateOrder`), la prenotazione legata al carrello viene confermata e associata all'ordine. - **Rilasciata**: una prenotazione in sospeso non finalizzata, legata a un carrello abbandonato, viene rimossa automaticamente dopo l'intervallo di conservazione. Il rimanente di un prodotto è uguale alla quantità desiderata meno la somma delle prenotazioni in sospeso e confermate. Quando un prodotto è completamente prenotato, viene bloccato e non può più essere offerto, il che evita i doppioni. ## Lato commerciante: back-office La scheda **Liste regali** (in Clienti) elenca tutte le liste del negozio: cliente, tipo, numero di prodotti, numero di regali, stato attivo/inattivo e data di creazione. La vista dettagliata di una lista mostra: - le informazioni della lista e del cliente; - i prodotti con quantità desiderata, prenotata e rimanente; - le prenotazioni con il donatore, la quantità, il messaggio, lo stato e un link diretto all'ordine associato. Le liste sono create dai clienti: l'azione di creazione non è disponibile nel back-office. Il commerciante può consultare ed eliminare. ## Email di notifica Quando la notifica al proprietario è attivata, viene inviata un'email al proprietario della lista per ogni regalo confermato. Include il titolo della lista, il prodotto offerto, la quantità, il nome del donatore (in base all'impostazione di rivelazione e alla scelta di anonimato) e l'eventuale messaggio. I modelli di email sono forniti in francese e inglese, e sono personalizzabili. ## Multilingua e multi-negozio Le etichette del modulo sono traducibili tramite il sistema di traduzione dei moduli PrestaShop. La visualizzazione rispetta il contesto del negozio corrente: una lista creata su un negozio resta associata a quel negozio. ## FAQ e risoluzione dei problemi ### Il pulsante «Aggiungi a una lista» non appare nella scheda prodotto Verifica che l'opzione **Pulsante nella scheda prodotto** sia attivata nelle impostazioni, e che l'hook `displayProductAdditionalInfo` sia posizionato correttamente nel tuo tema. ### La pagina pubblica mostra «lista non trovata» La lista potrebbe essere privata, inattiva, o associata a un altro negozio. Verifica il suo stato nell'account cliente o nel back-office. ### Un prodotto resta bloccato anche se l'ordine non è stato effettuato Si tratta di una prenotazione in sospeso. Viene rilasciata automaticamente dopo l'intervallo di conservazione definito nelle impostazioni. Puoi ridurre questo intervallo se necessario. ### Il proprietario non riceve email Verifica che la notifica al proprietario sia attivata e che l'invio di email sia configurato correttamente in **Parametri avanzati > E-mail**. ### Cosa succede alla disinstallazione? La disinstallazione rimuove le tre tabelle del modulo, la scheda di amministrazione e le impostazioni. Non rimane alcun dato residuo.