DataFirefly Advent Calendar: calendario dell’Avvento per PrestaShop
Installazione e aggiornamento, impostazioni e cron dei promemoria, modelli pronti, caselle e codici sconto, vincita immediata, anteprima, e-mail, estrazione, statistiche e risoluzione dei problemi.
Installazione e aggiornamento
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. Lo stesso ZIP funziona da PrestaShop 1.7.8 a 9.x.
L’installazione crea le tabelle del modulo, registra i suoi hook, crea la pagina del calendario (un indirizzo per lingua) e aggiunge la scheda Catalogo > Sconti > Calendario dell’Avvento. Le immagini delle caselle sono salvate in /img/dfadventcalendar/, fuori dalla cartella del modulo.
Aggiornamento dalla 1.0.0: carica il nuovo ZIP e PrestaShop esegue la migrazione. Calendari, caselle, partecipanti e codici vengono conservati. Il vecchio indirizzo della pagina resta valido in tutte le lingue, così i link già inviati per e-mail continuano a funzionare.
Impostazioni del modulo
La pagina di configurazione del modulo (pulsante Configura) raccoglie le impostazioni comuni a tutti i calendari.
- Indirizzo della pagina del calendario: un indirizzo per lingua, ad esempio
/calendario-avventoin italiano e/advent-calendarin inglese. Il modulo rifiuta un indirizzo già usato da un’altra pagina. Il titolo SEO della pagina si imposta in Parametri negozio > Traffico & SEO. - Fuso orario e ora del negozio: le caselle si aprono in questo fuso orario, qualunque sia quello del visitatore o del server.
- Promemoria per esecuzione del cron: numero massimo di e-mail inviate a ogni chiamata (150 per impostazione predefinita).
- Conserva i dati alla disinstallazione: calendari, caselle, partecipanti e immagini restano nel database, pronti per una reinstallazione.
- Orologio di prova (solo in modalità debug): tutto il calendario si comporta come se fosse la data e l’ora inserite. Il back office mostra un avviso finché è impostato. Non lasciarlo mai attivo su un negozio online.
Promemoria giornaliero: attività cron
Copia l’indirizzo cron mostrato e programmalo ogni 15 minuti nel pannello del tuo hosting:
*/15 * * * * curl -s "https://www.il-tuo-negozio.it/module/dfadventcalendar/cron?token=IL_TUO_TOKEN" > /dev/null
Il calendario funziona anche senza cron: solo le e-mail di promemoria ne dipendono. L’ultima esecuzione è indicata, e la checklist di lancio del pannello segnala un cron fermo.

Creare un calendario
Apri Catalogo > Sconti > Calendario dell’Avvento. Il modo più rapido è partire da un modello: date, numero di caselle, tema e titolo in tutte le tue lingue sono già pronti. Resta solo da compilare le caselle.
- Calendario dell’Avvento, 24 caselle o 25 caselle con il giorno di Natale, dal 1° dicembre;
- I 12 giorni di Natale, dal 13 al 24 dicembre;
- Settimana del Black Friday, 7 caselle fino all’ultimo venerdì di novembre;
- Conto alla rovescia per un evento, 10 caselle prima di un lancio o di una vendita privata.
Il pulsante Calendario vuoto o Nuovo calendario ti lascia scegliere ogni impostazione.

Date e apertura
- Data della prima casella e numero di caselle (da 1 a 60): una casella al giorno a partire da quella data.
- Orario di apertura delle caselle: 00:00 per mezzanotte, oppure un orario di appuntamento come 08:00. Prima di quell’ora, la casella del giorno precedente resta la casella del giorno.
Aspetto
Sono disponibili nove temi: Bosco di abeti, Carta kraft, Brina, Notte d’inverno, Bastoncino di zucchero e quattro temi fuori dal Natale (Nero e oro, Black Friday, Pastello di primavera, Laguna d’estate). L’opzione Colori personalizzati attiva quattro colori. Sono disponibili tre stili delle caselle: porte che si aprono, pacchi regalo con nastro e tessere minimaliste. La decorazione anima lo sfondo: neve, stelle, coriandoli o nessuna. Un’anteprima dal vivo mostra il risultato mentre imposti il calendario.
Con le dimensioni variate, la griglia si riempie senza buchi su 6 o 4 colonne. Su mobile passa a 4 colonne regolari. Le animazioni si fermano per i visitatori che chiedono al proprio dispositivo di ridurre il movimento.

Partecipazione
- E-mail obbligatoria per aprire le caselle: se disattivata, i visitatori aprono liberamente, ma i codici personali e i giochi restano riservati ai partecipanti.
- Riservato agli account cliente: partecipano solo i clienti connessi, e i loro codici sono collegati al loro account. È la protezione migliore contro la raccolta di codici con indirizzi usa e getta.
- Conferma l’indirizzo e-mail (double opt-in) e una casella newsletter facoltativa, non selezionata.
- Consenti di aprire le caselle passate: i codici condivisi restano allora validi fino alla fine del calendario.
- Testo del consenso: aggiungi il link alla tua informativa sulla privacy.
Configurare le caselle
Il pannello del calendario mostra le caselle come schede: data, tipo, premio, codice, aperture, codici svelati e ordini. I filtri Da configurare, Con un codice, Vincita immediata, Oggi e in arrivo e Passate e la ricerca trovano subito una casella. Ogni scheda permette di modificare la casella, di aprirla in anteprima o di attivarla.

Tipi di casella
- Messaggio: testo, immagine e pulsante facoltativo.
- Codice sconto: il codice è protagonista, su un biglietto da copiare o aggiungere al carrello.
- Prodotto svelato: scheda prodotto con prezzo e pulsante di aggiunta al carrello.
- Vincita immediata: il partecipante tenta la fortuna e vince il premio con la probabilità che imposti.
Premio e codice
Sconto in percentuale, sconto in importo, spedizione gratuita, prodotto in regalo, oppure una regola carrello esistente del negozio con le sue condizioni. Per i premi creati dal modulo:
- Codice personale: una regola carrello monouso viene generata quando il partecipante apre la casella. È collegata all’account cliente se noto ed è valida fino a mezzanotte, più la validità aggiuntiva che scegli.
- Stesso codice per tutti: una regola carrello per casella, sincronizzata automaticamente. Lascia il campo vuoto per un codice automatico (prefisso, anno e numero, ad esempio
ADVENT26-07). - Importo minimo d’ordine e limitazione al prodotto svelato facoltativi.
I pulsanti Casella precedente e Casella successiva permettono di compilare il calendario di seguito. Poco tempo? Compila le caselle vuote applica un piano pronto all’uso tradotto in tutte le tue lingue.
Vincita immediata
Imposta la probabilità di vincita (da 1 a 100%), il numero di premi (0 per illimitato) e il messaggio quando il partecipante non vince. L’estrazione avviene sul server all’apertura della casella, una sola volta per partecipante. Riaprire la casella dà lo stesso risultato. Quando tutti i premi sono stati vinti, i partecipanti successivi vedono il messaggio di sconfitta.

Anteprima e lancio
Il pannello raccoglie tutto ciò che serve per lanciare il calendario:
- Anteprima al: scegli una data e apri il calendario come apparirà quel giorno. I codici mostrati sono esempi e nulla viene salvato. I link di anteprima scadono dopo 7 giorni.
- Checklist di lancio: calendario attivo, caselle configurate, cron dei promemoria ed e-mail del negozio.
- Altro > Inviami le e-mail di prova: le quattro e-mail (promemoria, benvenuto, conferma, link di accesso) partono verso il dipendente connesso, nella sua lingua.

Cosa vede il cliente
La pagina del calendario si apre su un conto alla rovescia fino alla prossima casella, con la casella del giorno in evidenza. Una volta iscritto, il partecipante vede il suo anello di avanzamento, la sua serie di giorni consecutivi e l’interruttore del promemoria giornaliero.

Le caselle hanno cinque stati: oggi (alone animato), da recuperare, aperta (contenuto visibile), in arrivo (lucchetto e data) e mancata. Una stella segnala le caselle di gioco.

All’apertura, una finestra presenta la sorpresa: prodotto con il suo prezzo, codice su un biglietto, pulsanti Aggiungi al mio carrello e Copia. Se il carrello è vuoto, il codice viene conservato 14 giorni e applicato al primo prodotto aggiunto.

Il riepilogo I tuoi codici elenca i codici ottenuti, con la loro validità e il loro stato (usato, scaduto).

Su mobile, la griglia passa a 4 colonne regolari e i pannelli si impilano.

Gioco a vincita immediata
Una casella di gioco permette al partecipante di tentare la fortuna. Se vince, riceve il codice come per una casella classica. Altrimenti vede il messaggio di sconfitta e potrà giocare alla prossima casella di gioco. Un visitatore non iscritto è invitato a lasciare la sua e-mail: una sola possibilità per partecipante.

Banner della home page e pulsante fluttuante
Il banner appare sulla home page durante il calendario e, se lo desideri, qualche giorno prima dell’inizio. Il pulsante fluttuante, da attivare nelle impostazioni del calendario, ricorda la casella del giorno su tutte le pagine. Il visitatore può nasconderlo fino al giorno dopo. Per mostrare il banner altrove, aggiungi {hook h='displayDfAdventCalendar'} in un template del tuo tema.

Conti alla rovescia fuori dal Natale
Lo stesso modulo anima qualsiasi momento forte: settimana del Black Friday, lancio di una collezione, saldi, anniversario del negozio. Scegli un modello di conto alla rovescia, un tema come Nero e oro, tessere minimaliste e un orario di apertura. Prima dell’inizio, la pagina mostra il conto alla rovescia fino alla prima casella.

Promemoria ed e-mail
Ogni giorno, dall’orario scelto (mai prima dell’apertura delle caselle), una breve e-mail annuncia la casella del giorno ai partecipanti confermati che non l’hanno ancora aperta. Un partecipante riceve al massimo un promemoria al giorno, e nessuno il giorno dell’iscrizione: basta l’e-mail di benvenuto. Le e-mail riprendono i colori del tema del calendario.

Quattro modelli sono forniti in otto lingue in mails/: dfadvent_reminder (promemoria), dfadvent_welcome (benvenuto), dfadvent_confirm (conferma dell’indirizzo) e dfadvent_access (link di accesso). Un partecipante che reinserisce il suo indirizzo riceve un link di accesso: il modulo non connette mai nessuno sulla sola base di un indirizzo digitato, e lo stesso indirizzo non riceve più di un’e-mail ogni 2 minuti. Per personalizzare i modelli, copiali in themes/il-tuo-tema/modules/dfadventcalendar/mails/.

Partecipanti
L’elenco dei partecipanti si filtra con un clic: confermati, in attesa di conferma, promemoria attivi, newsletter, account cliente, vincitori dell’estrazione. Indica le caselle aperte e i codici ottenuti da ciascuno, e si esporta in CSV.

Estrazione finale
Nelle impostazioni del calendario, fissa il numero minimo di caselle aperte per partecipare (0 disattiva l’estrazione) e descrivi il premio. Il pannello indica quanti partecipanti sono idonei. Il pulsante Estrai un vincitore sceglie a caso tra i partecipanti confermati idonei, escludendo i vincitori precedenti. Ogni estrazione viene registrata.
Un’estrazione a premi e un gioco a vincita immediata sono soggetti alla normativa sui concorsi e le operazioni a premio. Pubblica un regolamento sul tuo negozio prima del lancio.
Statistiche
Il pannello mostra i partecipanti (confermati, con un account cliente), le caselle aperte e la media per partecipante, i codici svelati e la quota di codici personali utilizzati, gli ordini validi effettuati con un codice, il fatturato al netto delle imposte di questi ordini e i promemoria attivi. Il grafico di attività mostra, casella per casella, aperture e iscrizioni.
Se Google Tag Manager è presente, il modulo invia questi eventi nel dataLayer: dfadv_join, dfadv_door_open, dfadv_code_copy, dfadv_code_apply e dfadv_share.
Il menu Altro > Duplica per l’anno prossimo copia il calendario e le sue caselle con un anno di scarto, inattivo, senza partecipanti né codici.
Dati personali
- La casella del consenso è obbligatoria, la casella newsletter è separata e non selezionata.
- Ogni e-mail di promemoria contiene un link di disiscrizione con 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 (codici inclusi) e di cancellazione dei dati personali di PrestaShop.
Risoluzione dei problemi
I promemoria non partono
Controlla la checklist di lancio del pannello: cron eseguito nelle ultime 24 ore, e-mail del negozio attivate. I promemoria partono dall’orario scelto, e solo ai partecipanti confermati che non hanno ancora aperto la casella del giorno.
La pagina del calendario restituisce un errore 404
Verifica che gli URL semplificati siano attivi, poi svuota la cache. Se l’indirizzo è in conflitto con un’altra pagina, cambialo nelle impostazioni del modulo.
Una casella resta chiusa nel suo giorno
Controlla l’orario di apertura del calendario e il fuso orario del negozio (Internazionale > Localizzazione). Una casella non configurata o inattiva resta chiusa.
Il codice non viene aggiunto al carrello
Il messaggio mostrato è quello di PrestaShop: importo minimo non raggiunto, codice scaduto o codice collegato a un altro account cliente. Se il carrello è vuoto, il codice resta in attesa e si applica al primo prodotto.
Compatibilità
- PrestaShop da 1.7.8 a 9.x, lo stesso ZIP per tutte le versioni.
- Temi Classic, Hummingbird e temi derivati.
- Multinegozio (un calendario per negozio) e multivaluta (importi convertiti nella valuta del visitatore).
- Architettura ModuleAdminController, senza dipendenze Composer.
- Modulo tradotto in inglese, francese, spagnolo, tedesco, italiano, olandese, polacco e portoghese.