Modulo concorso a premi per PrestaShop 8 e 9: documentazione

Presentazione

Il modulo dfcontest aggiunge concorsi a premi al tuo negozio PrestaShop 8 o 9. I clienti partecipano automaticamente quando ordinano, oppure gratis tramite un modulo. L’estrazione è verificabile: qualsiasi visitatore può rifare il calcolo e ottenere gli stessi vincitori. Il modulo genera il regolamento, invia le email ai vincitori e raccoglie il loro indirizzo di consegna.

Installazione

1. Nel back office, apri Moduli > Gestione moduli e fai clic su Carica un modulo.
2. Carica il file dfcontest-x.y.z.zip, poi fai clic su Installa.
3. Compare il menu Clienti > Concorsi. Le impostazioni generali si trovano nella pagina di configurazione del modulo.

Per aggiornare, carica semplicemente la nuova versione: gli script di aggiornamento aggiungono le colonne e le impostazioni mancanti senza toccare i tuoi concorsi né le partecipazioni.

Configurazione del modulo

Promotore

Inserisci la ragione sociale, la sede legale, il numero di registrazione della società (partita IVA, SIRET, CIF, KvK…) e l’email di contatto per i partecipanti. Questi dati compaiono nel regolamento generato e nelle email.

Visualizzazione

• Nome dei vincitori nelle pagine pubbliche: solo iniziali (M. R.) o nome e iniziale (Mario R.).
• Mostra il concorso nelle schede dei prodotti validi e mostra le partecipazioni ottenute nel carrello, con l’importo che manca alla partecipazione successiva.
• Colore di accento: colore del conto alla rovescia, dei riquadri e dei bordi. Lascia vuoto per il verde predefinito; i pulsanti mantengono i colori del tuo tema.
• Ricevuta di partecipazione via email: codice di partecipazione e link da condividere, inviati appena una partecipazione con modulo è valida.
• Metti in evidenza il concorso in corso nella home page (hook displayHome).

Protezione antifrode

L’opzione Rifiuta gli indirizzi email usa e getta blocca i principali servizi di email temporanee (Yopmail, Mailinator, 10 Minute Mail, Guerrilla Mail e altri). Il campo Altri domini bloccati accetta un dominio per riga; vengono bloccati anche i sottodomini.

Attività automatiche (cron)

La pagina di configurazione mostra un URL cron firmato. Serve solo per il pilota automatico (vedi sotto). Chiamalo ogni 5-15 minuti, ad esempio:

*/10 * * * * curl -s "https://tuo-negozio.it/module/dfcontest/cron?token=TUO_TOKEN" > /dev/null

La data dell’ultima esecuzione è indicata sotto l’URL.

Creare un concorso

Apri Clienti > Concorsi, poi Nuovo concorso. Il modulo è diviso in schede.

Generale

• Nome, URL semplificato, descrizione e premio (descrivi ogni premio e il suo valore commerciale: questo testo è inserito nel regolamento).
• Immagine: JPG, PNG o WebP, massimo 4 MB, larghezza consigliata 1600 px.
• Inizio, fine e data di estrazione annunciata.
• In evidenza nella home page: se sono in corso più concorsi, viene mostrato quello che termina per primo.

Come partecipare

Attiva la partecipazione con acquisto, tramite modulo o entrambe. Il massimo di partecipazioni per partecipante conta insieme acquisti, modulo e bonus degli inviti, per indirizzo email.

Partecipazioni con acquisto

• 1 partecipazione per ordine o 1 partecipazione per fascia di importo (IVA inclusa, nella valuta predefinita).
• Importo minimo dell’ordine e partecipazioni massime per ordine.
• ID dei prodotti validi e categorie valide: se impostati, conta solo l’importo di questi prodotti, con gli sconti ripartiti in proporzione. Lascia vuoto per tutto il catalogo.

La partecipazione viene creata quando l’ordine passa a uno stato pagato durante il periodo del concorso. Viene rimossa se l’ordine è annullato, rimborsato o in errore di pagamento, finché le partecipazioni non sono sigillate. Un ordine suddiviso in più spedizioni conta come un solo ordine.

Partecipazioni con modulo

• Account cliente obbligatorio: riserva il modulo ai clienti connessi.
• Conferma via email (consigliata): gli ospiti ricevono un link e la loro partecipazione conta solo dopo la conferma.
• Numero di telefono: nascosto, facoltativo o obbligatorio.
• Domanda: domanda libera la cui risposta viene salvata ed esportata.
• Casella di iscrizione alla newsletter: non spuntata per impostazione predefinita.
• Partecipazioni bonus per amico invitato e partecipazioni bonus massime per partecipante: attiva gli inviti (0 li disattiva).

Estrazione

• Numero di vincitori e numero di riserve (estratte in ordine dopo i vincitori).
• Un premio per persona: un partecipante estratto una seconda volta viene saltato.
• Pilota automatico: sigillatura alla data di fine, estrazione alla data annunciata, email ai vincitori (serve l’URL cron).
• Sostituisci i vincitori che non richiedono il premio in tempo: allo scadere del termine, il vincitore viene segnato come rinunciatario e la riserva successiva riceve l’email (serve l’URL cron).
• Giorni per richiedere il premio.

L’impronta dell’estrazione viene creata al primo salvataggio del concorso e non può più cambiare. Dopo la sigillatura, date, impostazioni di partecipazione e numero di vincitori sono bloccati.

Regolamento

Se lasciato vuoto, viene generato un regolamento in 9 articoli dalle impostazioni del concorso e dai dati del promotore. Puoi scrivere un tuo testo con le variabili {organizer}, {contest_name}, {date_start}, {date_end}, {draw_date}, {nb_winners}, {prize}, {claim_days}, {verify_url}, {commitment} e le altre elencate nella scheda.

Nel negozio

• /contests: elenco dei concorsi in corso, in arrivo e terminati.
• Pagina del concorso: conto alla rovescia, premi, modalità di partecipazione, modulo e, dopo l’iscrizione, codice di partecipazione, numero di partecipazioni e link da condividere. Dopo l’estrazione: elenco dei vincitori e avviso «Hai vinto» per il visitatore interessato.
• /rules: regolamento stampabile. /draw: pagina di verifica.
• Scheda prodotto e carrello: avviso sui prodotti validi e messaggio di avanzamento.
• Conferma d’ordine: partecipazioni ottenute con il relativo codice.
• Il mio account > Le mie partecipazioni ai concorsi: storico, stato e pulsante per richiedere il premio per i vincitori.
• Widget: nella home page, oppure ovunque con {widget name="dfcontest"} o {widget name="dfcontest" id_contest=3}.

Svolgimento dell’estrazione

La dashboard del concorso (pulsante Visualizza nell’elenco) presenta l’estrazione in 4 passaggi.

1. Impronta pubblicata: l’impronta SHA-256 della chiave segreta è pubblica dalla creazione del concorso.
2. Sigillare le partecipazioni: disponibile dopo la data di fine. L’elenco delle partecipazioni valide viene congelato e la sua impronta pubblicata. Nello stesso momento, il modulo si impegna su un round futuro di drand, la casualità pubblica della League of Entropy, pubblicato circa due minuti dopo, oppure dopo la data di estrazione annunciata.
3. Eseguire l’estrazione: appena il valore del round è pubblicato, il modulo lo recupera ed estrae i vincitori e poi le riserve. Se il tuo server non raggiunge drand, apri il link drand indicato, copia il valore randomness e incollalo nel campo previsto.
4. Avvisare i vincitori: ogni vincitore riceve un’email nella lingua della sua partecipazione, con un link per accettare il premio e indicare il proprio indirizzo prima della scadenza.

Seguire la consegna dei premi

La tabella dei vincitori indica per ciascuno: richiesto (con l’indirizzo di consegna), in attesa di risposta o termine scaduto. Il pulsante Invia di nuovo reinvia l’email e fa ripartire il termine. Segna come rinunciatario toglie il premio al vincitore e lo assegna alla prima riserva disponibile; poi reinvia le email per avvisarla. Quando un vincitore richiede il premio, l’email di contatto del promotore riceve i suoi dati.

Pagina di verifica

La pagina /draw pubblica l’impronta della chiave, l’impronta dell’elenco, il round drand e poi la chiave, il valore pubblico, il seme e i vincitori. Un partecipante può cercare il proprio codice nell’elenco sigillato e avviare la verifica nel browser, che controlla ogni passaggio senza inviare nulla al negozio. Il file di prova JSON si scarica dalla pagina e dalla dashboard.

Pilota automatico

Per un concorso con l’opzione Pilota automatico, ogni esecuzione del cron:

• sigilla le partecipazioni una volta superata la data di fine;
• esegue l’estrazione quando si raggiunge la data annunciata e il valore drand è pubblicato, poi invia le email ai vincitori;
• se l’opzione di sostituzione è attiva, segna come rinunciatari i vincitori il cui termine è scaduto senza richiesta e avvisa la riserva successiva.

Il cron non ha effetto sui concorsi senza pilota automatico. Può essere eseguito con la frequenza che preferisci.

Esportazioni e dati personali

• Esporta vincitori (CSV): posizione, codice, dati di contatto, origine, biglietto estratto, risposta, data dell’avviso, stato della richiesta e indirizzo di consegna.
• Esporta partecipazioni (CSV): tutte le partecipazioni con stato, origine e consenso alla newsletter.
• Con il modulo ufficiale psgdpr, la cancellazione di un cliente anonimizza le sue partecipazioni e ritira quelle dei concorsi non sigillati; l’esportazione GDPR include le sue partecipazioni e la richiesta del premio.

Risoluzione dei problemi

Un ordine pagato non ha creato alcuna partecipazione

PrestaShop salta gli hook di un modulo quando il profilo del dipendente che cambia lo stato non ha il permesso di vedere quel modulo. Nella dashboard del concorso, il pulsante Controlla gli ordini scorre gli ordini pagati del periodo e crea le partecipazioni mancanti.

Un ospite non riceve l’email di conferma

Nella pagina del concorso compare il pulsante Invia di nuovo il link per una partecipazione in attesa (al massimo un invio ogni due minuti). Controlla anche le impostazioni email del negozio.

L’estrazione non parte

Il valore del round drand viene pubblicato solo all’ora indicata nella dashboard. Dopo quell’ora, se drand resta irraggiungibile dal server, incolla il valore randomness copiato dal link drand.

Il cron non fa nulla

Verifica che il concorso abbia l’opzione Pilota automatico e che il negozio non sia in modalità manutenzione, che blocca anche l’URL cron. In multinegozio, chiama l’URL cron di ogni negozio.