# DataFirefly Advent Calendar: calendario dell'Avvento per PrestaShop > Installazione Installa il modulo da Moduli > Gestione moduli > Carica un modulo inviando il file ZIP, oppure copia la cartella dfadventcalendar nella directory /modules/ del negozio e clicca su… - Pagina: - Lingua: it - Aggiornato il: 2026-09-30 - Altre lingue: [fr](https://www.datafirefly.com/documentation/dfadventcalendar/index.md), [en](https://www.datafirefly.com/en/documentation/dfadventcalendar/index.md), [es](https://www.datafirefly.com/es/documentation/dfadventcalendar/index.md), [de](https://www.datafirefly.com/de/documentation/dfadventcalendar/index.md), [pl](https://www.datafirefly.com/pl/documentation/dfadventcalendar/index.md), [nl](https://www.datafirefly.com/nl/documentation/dfadventcalendar/index.md), [pt](https://www.datafirefly.com/pt/documentation/dfadventcalendar/index.md) - Indice: ## Installazione Installa il modulo da **Moduli > Gestione moduli > Carica un modulo** inviando il file ZIP, oppure copia la cartella `dfadventcalendar` nella directory `/modules/` del negozio e clicca su Installa. L'installazione crea le tabelle del modulo, registra i suoi hook e aggiunge la scheda **Catalogo > Sconti > Calendario dell'Avvento**. Le immagini caricate per le caselle sono salvate in `/img/dfadventcalendar/`, fuori dalla cartella del modulo, per non andare perse con un aggiornamento. ## Impostazioni del modulo e attività cron La pagina di configurazione del modulo (pulsante Configura in Gestione moduli) contiene tre impostazioni e l'URL cron. ### Indirizzo della pagina Ultima parte dell'URL del calendario, comune a tutte le lingue (PrestaShop aggiunge il prefisso della lingua, ad esempio /en/). Il valore predefinito dipende dalla lingua principale del negozio: `/calendario-avvento` in italiano, `/advent-calendar` in inglese, `/calendrier-de-l-avent` in francese. Gli URL semplificati devono essere attivi in PrestaShop. ### Promemoria giornaliero: attività cron Le e-mail di promemoria partono tramite un'attività cron. Copia l'URL mostrato e programmalo ogni 15 minuti nel pannello del tuo hosting, ad esempio: ``` */15 * * * * curl -s "https://www.tuo-negozio.it/module/dfadventcalendar/cron?token=IL_TUO_TOKEN" > /dev/null ``` A ogni chiamata, il modulo invia i promemoria del giorno a partire dall'ora impostata sul calendario, a lotti (150 per impostazione predefinita, modificabile in «Promemoria per esecuzione del cron»). Ogni partecipante riceve al massimo un promemoria al giorno, e solo se non ha ancora aperto la casella del giorno. La data dell'ultima esecuzione è indicata sotto l'URL; «Genera un nuovo token cron» rende inutilizzabile l'URL precedente. Il calendario funziona anche senza cron. Solo le e-mail di promemoria dipendono da esso. La dashboard mostra un avviso se il cron non è stato eseguito nelle ultime 24 ore. ## Creare un calendario Apri **Catalogo > Sconti > Calendario dell'Avvento** e clicca su **Nuovo calendario**. ### Date e caselle - **Data della prima casella**: la casella 1 si apre a mezzanotte di quel giorno, nel fuso orario del negozio, poi una casella al giorno. - **Numero di caselle**: 24 per un calendario classico, 25 per includere Natale, da 1 a 31. - **Consenti di aprire le caselle passate**: un partecipante che ha saltato un giorno può recuperare la casella fino alla fine del calendario. Al salvataggio, il modulo crea le caselle vuote. Restano chiuse finché non le configuri e le attivi. ### Aspetto Sono disponibili cinque stili: Bosco di abeti, Carta kraft, Brina, Notte d'inverno e Bastoncino di zucchero. L'opzione **Colori personalizzati** attiva quattro colori (sfondo, testo, caselle, accento). Puoi aggiungere un'immagine di sfondo (JPG, PNG o WebP, max 5 MB), la neve che cade, le caselle mescolate e le dimensioni variate. Con le dimensioni variate, il modulo sceglie da solo quali caselle sono larghe o grandi in modo che la griglia si riempia senza buchi su 6, 4 o 3 colonne a seconda dello schermo. L'ultima casella è sempre la più grande. ### Partecipazione - **E-mail obbligatoria per aprire le caselle**: se disattivata, i visitatori aprono liberamente, ma i codici personali restano riservati agli iscritti. - **Conferma l'indirizzo e-mail** (doppio opt-in): il partecipante clicca su un link ricevuto via e-mail prima di aprire le caselle. Consigliato contro gli indirizzi falsi. - **Casella newsletter**: aggiunge una casella facoltativa, non spuntata. L'iscrizione passa dalla newsletter nativa del cliente o dal modulo ps_emailsubscription se installato. - **Testo del consenso**: mostrato accanto alla casella obbligatoria. Inserisci il link alla tua informativa sulla privacy. ### Promemoria Attiva l'**E-mail di promemoria giornaliero** e scegli l'**Ora del promemoria**. Il partecipante può disattivare i promemoria dalla pagina del calendario o dal link presente in ogni e-mail. ### Banner in homepage Il banner compare in homepage durante il calendario e, se vuoi, qualche giorno prima con un conto alla rovescia. Per mostrarlo altrove nel tema, aggiungi `{hook h='displayDfAdventCalendar'}` in un template. ## Configurare le caselle Dalla dashboard del calendario, clicca su **Caselle** e poi su Modifica per ogni casella. ### Tipi di casella - **Messaggio**: testo e immagine. - **Codice sconto**: il codice è in primo piano nella finestra di apertura. - **Prodotto svelato**: scheda prodotto con prezzo e pulsante di aggiunta al carrello. Cerca il prodotto per nome o riferimento. Il campo **Anteprima per l'e-mail di promemoria** è la frase inviata nel promemoria del giorno: incuriosisci senza svelare la sorpresa. ### Premio Sconto in percentuale, sconto in importo (IVA inclusa, valuta predefinita), spedizione gratuita o prodotto in omaggio, con importo minimo d'ordine facoltativo. Per una casella prodotto, l'opzione «Applica lo sconto solo al prodotto svelato» limita il codice a quel prodotto. ### Tipo di codice - **Codice personale**: una regola carrello monouso viene generata quando il partecipante apre la casella. È collegata al suo account cliente se noto, ed è valida fino a mezzanotte del giorno di apertura più la validità aggiuntiva scelta. - **Stesso codice per tutti**: una sola regola carrello per casella, creata e sincronizzata dal modulo. Lascia il campo vuoto per un codice automatico (prefisso, anno e numero della casella, ad esempio `ADVENT26-07`) oppure inserisci il tuo. La validità parte dalla data della casella. Non hai tempo di configurare 24 caselle? Nella dashboard, **Compila le caselle vuote** applica un piano pronto all'uso: dal 10 al 20 per cento di sconto e spedizione gratuita alternati, 25 per cento sull'ultima casella, codici personali validi un giorno in più. I testi sono scritti in tutte le lingue del negozio. Le caselle già configurate non vengono modificate. ## Anteprima prima del lancio Il pulsante **Anteprima** della dashboard apre il calendario come sarà in un determinato giorno, e l'icona a forma di occhio di ogni riga apre direttamente la casella di quel giorno. In anteprima i codici sono esempi e nulla viene salvato. La pagina non viene indicizzata. **Altro > Inviami le e-mail di prova** invia le tre e-mail (promemoria, benvenuto, conferma) al dipendente connesso, nella sua lingua. ## Cosa vede il cliente - Un conto alla rovescia fino alla prossima casella e, per i partecipanti, una barra di avanzamento. - La casella del giorno in evidenza. Le caselle si aprono in 3D, con coriandoli la prima volta. Le animazioni sono disattivate per i visitatori che chiedono meno movimento. - Un pulsante **Aggiungi al mio carrello** sotto ogni codice. Se il carrello è vuoto, il codice viene conservato 14 giorni e applicato con il primo prodotto aggiunto. - Il riepilogo **I tuoi codici** sotto la griglia, con la validità di ogni codice e il suo stato (utilizzato, scaduto). - Un pulsante di condivisione del calendario e un link nell'account cliente. Un partecipante già iscritto che reinserisce il suo indirizzo riceve un link di accesso via e-mail: il modulo non collega mai nessuno solo perché ha digitato un indirizzo. ## Estrazione finale Nelle impostazioni del calendario, il campo **Estrazione finale** fissa il numero minimo di caselle aperte per partecipare (0 disattiva l'estrazione), e **Premio dell'estrazione finale** descrive il premio mostrato sul calendario. Il pannello Estrazione finale della dashboard indica quanti partecipanti sono idonei. **Estrai un vincitore** sceglie a caso tra i partecipanti confermati idonei, escludendo i vincitori precedenti. Ogni estrazione viene registrata con l'e-mail, le caselle aperte, il numero di idonei e la data. Un'estrazione a premi è soggetta alla normativa sui concorsi. Pubblica un regolamento sul tuo negozio prima del lancio. ## Dashboard e statistiche La dashboard mostra partecipanti, confermati, promemoria attivi, iscrizioni alla newsletter, ordini effettuati con un codice e fatturato IVA esclusa. Per ogni casella: aperture, ordini e fatturato. I partecipanti si esportano in CSV dall'elenco Partecipanti. **Altro > Duplica per l'anno prossimo** copia il calendario con caselle, testi e immagini, sposta la data di un anno e lo lascia inattivo, senza partecipanti né codici. Se Google Tag Manager è presente, il modulo invia questi eventi al `dataLayer`: `dfadv_join`, `dfadv_door_open`, `dfadv_code_copy`, `dfadv_code_apply` e `dfadv_share`. ## E-mail Tre modelli sono forniti in otto lingue in `mails/`: `dfadvent_reminder` (promemoria), `dfadvent_confirm` (conferma e link di accesso) e `dfadvent_welcome` (benvenuto). Per personalizzarli senza perdere le modifiche con gli aggiornamenti, copiali in `themes/tuo-tema/modules/dfadventcalendar/mails/`. ## Dati personali - La casella di consenso è obbligatoria; quella della newsletter è separata e non spuntata. - Ogni e-mail di promemoria contiene un link di disiscrizione in un clic. - L'indirizzo IP è conservato solo in forma hash, per limitare le iscrizioni a 5 all'ora per connessione. - Il modulo risponde alle richieste di esportazione e cancellazione dei dati personali di PrestaShop. ## Risoluzione dei problemi ### I promemoria non partono Controlla la data dell'ultima esecuzione del cron nella configurazione del modulo, che i promemoria siano attivi sul calendario e che l'ora del promemoria sia già passata. Ricevono il promemoria solo i partecipanti confermati che non hanno ancora aperto la casella del giorno. Prova l'invio con «Inviami le e-mail di prova». ### La pagina del calendario restituisce un errore 404 Verifica che gli URL semplificati siano attivi, poi svuota la cache di PrestaShop. Se l'indirizzo coincide con una pagina CMS o una categoria, cambialo nella configurazione del modulo. ### Il codice non viene aggiunto al carrello Il messaggio mostrato è quello di PrestaShop: importo minimo non raggiunto, codice scaduto, oppure codice personale collegato a un account cliente mentre il cliente non è connesso. In quest'ultimo caso il codice resta in attesa e si applica al carrello successivo dopo l'accesso. ### Una casella resta chiusa nel suo giorno Le caselle si aprono a mezzanotte nel fuso orario del negozio (Internazionale > Localizzazione > Configurazione). Verifica anche che la casella sia attiva: una casella non configurata resta chiusa. ## Compatibilità - PrestaShop da 8.0 a 9.x, lo stesso ZIP per entrambe le versioni. - Temi Classic, Hummingbird e temi figli. - Multinegozio e multilingua. - Architettura ModuleAdminController, senza dipendenze Composer. - Modulo tradotto in inglese, francese, spagnolo, tedesco, italiano, olandese, polacco e portoghese.