Lista Nascita, Matrimonio e Regali — Guida completa
Installare, configurare e gestire le liste nascita, matrimonio e regali condivise: creazione cliente, link pubblico, prenotazione nel carrello, monitoraggio e back-office, per PrestaShop 8 e 9.
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
- Scarica l’archivio
dfgiftregistry.zipdal tuo account cliente. - Nel back-office, vai su Moduli > Gestione moduli.
- Fai clic su Carica un modulo e rilascia l’archivio.
- 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.
- Il visitatore fa clic su Offri questo regalo sotto il prodotto scelto.
- Indica la quantità (limitata al rimanente), un breve messaggio facoltativo, e — se non è connesso — il proprio nome e un’email facoltativa.
- Può spuntare «Resta anonimo» se l’impostazione di rivelazione dei nomi è attivata.
- 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.