Confezione Regalo e Messaggio — Guida completa
Installare, configurare e gestire la confezione regalo a pagamento e il biglietto messaggio personalizzato al checkout per PrestaShop 8 e 9.
Panoramica
Il modulo Confezione Regalo e Messaggio (dfgiftwrap) aggiunge, all’interno del checkout, la scelta di una confezione regalo a pagamento e di un biglietto messaggio personalizzato. Il cliente seleziona un’opzione di confezione illustrata, può aggiungere un messaggio libero, e il costo corrispondente si integra in modo pulito nel totale dell’ordine — con IVA, valuta e multinegozio gestiti dal core di PrestaShop, fino alla fattura.
Il costo non è una semplice visualizzazione: è gestito da un prodotto-costo dedicato e da un prezzo specifico limitato al carrello del cliente. L’importo appare quindi naturalmente nei totali, nell’ordine e in fattura, con l’IVA corretta.
Compatibilità
- PrestaShop 8.0 a 9.x
- Negozio singolo e multinegozio
- PHP 7.4 a 8.3
- Tema Classic e temi personalizzati
- Interfaccia fornita in francese e completamente traducibile
- Senza dipendenze (senza Composer né framework)
Installazione
- Nel back office, apri Moduli > Gestore dei moduli.
- Clicca su Carica un modulo e seleziona il file
dfgiftwrap.zip. - Una volta installato, clicca su Configura.
All’installazione, il modulo crea le sue tabelle, registra i suoi hook (risorse del front, blocco al checkout, validazione dell’ordine, scheda ordine nel BO, conferma) e genera un prodotto-costo nascosto (riferimento DF-GIFTWRAP-FEE): virtuale, non visibile nel negozio, prezzo non mostrato. È quello che gestisce l’importo di confezione + biglietto nel carrello. Non eliminarlo manualmente.
Configurazione
Impostazioni generali
- Attivare la confezione regalo: mostra o nasconde il blocco delle opzioni di confezione al checkout.
- Attivare il biglietto messaggio: mostra o nasconde l’opzione biglietto + messaggio.
- Prezzo del biglietto: importo (IVA esclusa) addebitato quando il cliente aggiunge un biglietto messaggio.
- Lunghezza massima del messaggio: numero di caratteri consentiti (200 per impostazione predefinita). Un contatore accompagna il cliente durante la scrittura.
- Gruppo di regole fiscali: gruppo IVA applicato ai costi di confezione e di biglietto.
Gestire le opzioni di confezione
Dalla pagina di configurazione, clicca su «Gestire le opzioni» per aprire la schermata dedicata (controller AdminDfGiftWrapOptions). Lì crei tutte le opzioni che desideri, ognuna con:
- Nome: etichetta multilingue dell’opzione (es. «Carta kraft elegante», «Scatola regalo premium»).
- Prezzo: importo IVA esclusa dell’opzione di confezione.
- Immagine: visual che illustra l’opzione (normalizzato automaticamente in JPG).
- Posizione: ordine di visualizzazione, modificabile tramite trascinamento.
- Attivo: mostra o nasconde l’opzione nel negozio senza eliminarla.
Il nome è un campo multilingue: seleziona ogni lingua nel selettore del campo per tradurre il titolo dell’opzione.
Funzionamento
Al checkout
Il blocco confezione e biglietto è inserito in cima al riepilogo dell’ordine tramite l’hook displayCheckoutSummaryTop. Il cliente sceglie un’opzione di confezione, attiva eventualmente il biglietto e scrive il suo messaggio. La selezione è salvata via AJAX. Poiché la scelta modifica l’importo, il totale viene aggiornato per riflettere il costo; il messaggio, invece, viene salvato senza ricaricamento superfluo.
Meccanismo dei costi
A ogni selezione, il modulo calcola l’importo totale (opzione di confezione + biglietto) e crea un prezzo specifico (SpecificPrice) limitato al carrello corrente, applicato al prodotto-costo nascosto. Questo prodotto viene aggiunto al carrello quando l’importo è superiore a zero, altrimenti viene rimosso. PrestaShop applica quindi l’IVA, la valuta e il contesto multinegozio, e il costo appare come una riga normale nei totali, nell’ordine e in fattura.
Dove appare il messaggio
Alla validazione dell’ordine (actionValidateOrder), la selezione viene fissata. Il messaggio scritto dal cliente è visibile in tre punti:
- nella scheda ordine del back office (blocco dedicato tramite
displayAdminOrderMain); - nella pagina di conferma mostrata al cliente dopo l’acquisto;
- nel campo regalo nativo dell’ordine (
gift_message, congift = 1), il che lo fa apparire nelle email standard di PrestaShop.
Poiché il messaggio è salvato anche nel campo regalo nativo, i tuoi modelli di email e i tuoi strumenti di preparazione che già usano questo campo mostrano la nota del cliente senza configurazione aggiuntiva.
FAQ e risoluzione dei problemi
È una carta regalo o un buono?
No. Il modulo offre un servizio di confezione regalo e un biglietto messaggio da regalare, non un mezzo di pagamento né un buono. Il cliente paga una confezione e può aggiungere una dedica.
Il costo non appare nel totale
Verifica che il prodotto-costo nascosto (DF-GIFTWRAP-FEE) esista ancora e che almeno un’opzione di confezione sia attiva. Svuota la cache di PrestaShop, poi ricarica la pagina dell’ordine. Il costo si applica solo quando l’importo calcolato è superiore a zero.
La home page o il negozio diventa bianco dopo l’installazione
Assicurati di usare l’ultima versione del modulo e svuota la cache. Il prodotto-costo è volutamente non visibile nel negozio; non renderlo visibile e non eliminarlo manualmente.
Il messaggio viene troncato
Il messaggio è limitato dall’impostazione Lunghezza massima del messaggio. Aumenta questo valore nella configurazione se i tuoi clienti hanno bisogno di testi più lunghi.
Come aggiungo inglese, spagnolo, tedesco o italiano?
L’interfaccia è fornita in francese ed è completamente traducibile. Vai su Parametri avanzati > Traduzioni > Traduzioni dei moduli installati, scegli dfgiftwrap e la lingua, poi traduci le stringhe. I nomi delle opzioni di confezione si traducono direttamente nel loro campo multilingue.
È compatibile con PrestaShop 9?
Sì. Il modulo è progettato e testato da PrestaShop 8.0 a 9.x, con un controller di amministrazione legacy, sia in negozio singolo sia in multinegozio.