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 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.

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.

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.

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.