# Confezione Regalo e Messaggio — Guida completa
> 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…
- Pagina:
- Lingua: it
- Aggiornato il: 2026-06-18
- Altre lingue: [fr](https://www.datafirefly.com/documentation/dfgiftwrap/index.md), [en](https://www.datafirefly.com/en/documentation/dfgiftwrap/index.md), [es](https://www.datafirefly.com/es/documentation/dfgiftwrap/index.md), [de](https://www.datafirefly.com/de/documentation/dfgiftwrap/index.md), [pl](https://www.datafirefly.com/pl/documentation/dfgiftwrap/index.md), [pt](https://www.datafirefly.com/pt/documentation/dfgiftwrap/index.md), [nl](https://www.datafirefly.com/nl/documentation/dfgiftwrap/index.md)
- Indice:
## 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
1. Nel back office, apri **Moduli > Gestore dei moduli**.
2. Clicca su **Carica un modulo** e seleziona il file `dfgiftwrap.zip`.
3. 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`, con `gift = 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.