DataFirefly Live Shopping — Guida completa

Presentazione

Il modulo DataFirefly Live Shopping (dflive) trasforma il tuo negozio PrestaShop in una piattaforma di vendita video in diretta. Trasmetti una diretta, fissi i prodotti in tempo reale, lanci offerte flash, i tuoi clienti aggiungono al carrello senza lasciare la trasmissione e la sessione resta disponibile in replay. Tutto funziona sul tuo negozio: nessuna piattaforma di live shopping esterna, nessun abbonamento ricorrente.

Compatibilità

• PrestaShop da 1.7.0 a 1.7.8, 8.x e 9.x (dalla versione 1.1.0 del modulo)
• PHP da 5.6 a 8.3, secondo la versione di PrestaShop
• Temi Classic e Hummingbird e temi derivati
• Negozio singolo e multinegozio
• Multilingua (5 lingue incluse: FR, EN, ES, DE, IT)
• Nessuna dipendenza (né Composer né framework); hls.js è incluso nel modulo
• Compatibile con hosting condiviso (sincronizzazione tramite polling AJAX, senza WebSocket né SFU)

Prerequisiti

Il modulo gestisce la riproduzione del video e tutto il livello shopping, ma la sorgente video la fornisci tu. A seconda della modalità:

• HLS: un flusso .m3u8 servito dal tuo server HLS, da Mux o da Cloudflare Stream, alimentato da un encoder come OBS.
• MP4: un URL verso un file .mp4 accessibile pubblicamente.
• Embed: una diretta YouTube, Twitch o Vimeo (URL o codice <iframe>).

Per i promemoria «Avvisami», il negozio deve essere configurato per inviare e-mail (Parametri avanzati > E-mail).

Installazione

1. Nel back-office, apri Moduli > Gestione moduli.
2. Clicca su Carica un modulo e seleziona il file dflive.zip.
3. Dopo l’installazione, apri Vendi > Live Shopping > Dirette e replay.

Aggiornamento dalla versione 1.0.0

1. In Moduli > Gestione moduli, carica il nuovo dflive.zip (oppure sostituisci la cartella modules/dflive via FTP).
2. Clicca su Aggiorna sulla riga del modulo, se PrestaShop lo propone.

Lo script di aggiornamento 1.1.0 viene eseguito automaticamente, senza perdita di dati. Lo script:

• aggiunge le colonne necessarie (anti-flood degli ospiti, lingua e negozio dei promemoria);
• associa le dirette esistenti a tutti i tuoi negozi;
• sostituisce le date vuote salvate come 0000-00-00 con valori nulli;
• rimuove l’hook displayHeader, non più necessario.

Creare una diretta

Da Vendi > Live Shopping > Dirette e replay, clicca su Aggiungi. Il modulo è organizzato in schede:

Generale

• Titolo e descrizione della diretta (multilingua).
• Conduttore / host: nome mostrato come host nella chat e sotto il video.
• Data / ora programmata: attiva il conto alla rovescia per lo spettatore.
• Stato: programmata, in diretta o terminata. Lo stato si gestisce anche dallo Studio; una modifica fatta dal modulo ha gli stessi effetti (date, pulizia delle offerte, aggiornamento per gli spettatori).
• Immagine di copertina: JPG, PNG, GIF o WebP, mostrata prima della diretta e negli elenchi. Viene controllato il tipo reale del file: ogni altro file viene rifiutato.

Video

• Tipo di sorgente video: HLS, MP4 o embed.
• Sorgente video: l’URL .m3u8, l’URL .mp4, oppure l’URL / il codice <iframe> embed secondo il tipo. Con un codice embed, per lo spettatore viene usato solo l’indirizzo dell’iframe.
• URL del replay (VOD) (opzionale): ad esempio la registrazione del tuo server HLS, riprodotta automaticamente a fine diretta.

Prodotti

Associa i prodotti presentati durante la diretta con il selettore a ricerca AJAX (nome, riferimento o ID). Trascina e rilascia le righe per definire l’ordine della barra prodotti. Un prodotto disattivato resta nell’elenco ma non viene mostrato durante la diretta.

Opzioni

Attiva o meno chat, reazioni e replay per questa sessione, oltre alla sua visibilità in negozio. In multinegozio, scegli i negozi in cui la diretta è pubblicata.

SEO

Compila il meta titolo, la meta descrizione e, se vuoi, l’URL semplificato della pagina della diretta (se lasciato vuoto, viene generato dal titolo).

Trasmettere il flusso

Per una diretta HLS, il principio è il seguente:

1. Configura il tuo encoder (OBS, ad esempio) per trasmettere verso il tuo server HLS, Mux o Cloudflare Stream.
2. Copia l’URL .m3u8 di uscita e incollalo nel campo Sorgente video della sessione.
3. Avvia la trasmissione dall’encoder, poi apri lo Studio e clicca su Vai in diretta.

Il flusso viene caricato dagli spettatori solo all’avvio della diretta. Se il flusso HLS non è momentaneamente disponibile (encoder avviato in ritardo, interruzione di rete), il player riprova automaticamente.

Lo Studio (regia)

Lo Studio è la regia integrata nel back-office. Aprilo dal pulsante Studio nell’elenco delle dirette.

• Vai in diretta / Termina: cambia lo stato della sessione. All’avvio, gli iscritti ad «Avvisami» ricevono la loro e-mail. Alla fine, le offerte flash in corso vengono rimosse e il prodotto fissato viene sganciato.
• Fissa un prodotto: la sua scheda appare subito sul video degli spettatori, anche di chi arriva più tardi. Fissare un prodotto sgancia automaticamente il precedente. Il momento della prima presentazione viene memorizzato per la timeline del replay.
• Offerta flash: inserisci uno sconto (ad esempio 20% o 10) e, se serve, una durata (da 5 a 60 minuti, o illimitata). Il modulo crea un SpecificPrice al volo e il prezzo ricalcolato appare subito agli spettatori. Il pulsante × interrompe l’offerta e ripristina il prezzo normale per tutti.
• Annuncio fissato: mostra un banner sul video degli spettatori e aggiunge il messaggio, fissato, nella chat.
• Messaggio come host: scrive nella chat a nome dell’host.
• Moderazione: nascondi, mostra o fissa qualsiasi messaggio. Un messaggio nascosto scompare anche per gli spettatori che lo avevano già ricevuto.
• Statistiche live: spettatori, reazioni e iscritti ai promemoria, in tempo reale.

Promemoria «Avvisami»

Su una sessione programmata, lo spettatore inserisce la sua e-mail (precompilata se ha effettuato l’accesso) e clicca su Avvisami. Il numero di iscritti è visibile sulla pagina della diretta e nello Studio.

Quando clicchi su Vai in diretta, parte subito un primo blocco di e-mail; le altre vengono inviate a blocchi di 20 finché lo Studio resta aperto. Ogni iscritto riceve l’e-mail nella lingua in cui si è iscritto (FR, EN, ES, DE o IT; inglese per le altre lingue), con un link diretto alla diretta. Ogni iscritto viene avvisato una sola volta.

Lato spettatore

La pagina di una diretta (/live/{id}-{slug}) mostra:

• Il player video con l’etichetta «IN DIRETTA» e il numero di spettatori. I browser consentono la riproduzione automatica solo senza audio: sul video appare un pulsante Attiva l’audio.
• La scheda del prodotto fissato sul video, con pulsante di aggiunta al carrello.
• La barra dei prodotti della diretta, ciascuno aggiungibile al carrello nativo di PrestaShop con un clic. Il blocco carrello del tema si aggiorna senza aprire finestre, per non interrompere la diretta. Stock, quantità minime e regole carrello sono rispettati; per un prodotto con combinazioni viene aggiunta la combinazione predefinita.
• La chat (clienti e, se attivato, ospiti) con anti-flood, messaggi dell’host e cuori animati.
• Gli annunci dell’host in banner sul video.
• Le notifiche di social proof «Qualcuno ha appena aggiunto…» quando si aggiunge al carrello.

Per una sessione programmata, lo spettatore vede un conto alla rovescia (basato sull’ora del server) e può iscriversi ai promemoria. All’avvio della diretta, la pagina passa automaticamente in diretta, senza ricaricare.

Replay e timeline dei prodotti

A fine diretta, la pagina passa automaticamente in modalità replay:

• se è indicato un URL di replay, il video registrato viene caricato con i suoi controlli di riproduzione;
• per una diretta embed, l’embed resta visibile (o l’URL di replay, se l’hai indicato);
• senza sorgente di replay, appare la schermata «Diretta terminata».

Durante il replay, ogni prodotto riappare sul video nel momento in cui è stato fissato per la prima volta in diretta. Il riferimento parte dall’avvio della diretta: per una sincronizzazione esatta, la registrazione deve iniziare quando clicchi su Vai in diretta.

Impostazioni del modulo

La pagina di configurazione (Moduli > Gestione moduli > DataFirefly Live Shopping > Configura) raccoglie le impostazioni globali. I valori fuori intervallo vengono riportati automaticamente nell’intervallo consentito.

• Intervallo di polling (3.000 ms di default, da 1.000 a 60.000): frequenza di aggiornamento di chat ed eventi durante una diretta. Prima della diretta e in replay il ritmo viene rallentato automaticamente.
• Chat in diretta e chat degli ospiti: consentono la chat e, se serve, la partecipazione dei visitatori non registrati.
• Reazioni e social proof: attivano i cuori e le notifiche di aggiunta al carrello.
• Timeout spettatore (30 s di default, da 10 a 600): tempo dopo il quale uno spettatore inattivo non viene più contato.
• Lunghezza max. messaggio (300 di default, da 20 a 500) e anti-flood (3 s di default, 0 per disattivarlo): regolano la chat. Per gli ospiti, l’anti-flood si applica per indirizzo IP (salvato come impronta, mai in chiaro).
• Widget home page e dirette mostrate (4 di default, da 1 a 24): gestiscono il blocco in home page.

Pagina elenco e widget home

La pagina /live elenca le dirette in corso, quelle in arrivo (le più vicine prima) e i replay (i più recenti prima). Il widget della home page mette in evidenza queste sessioni entro il limite configurato. In multinegozio, ogni negozio mostra solo le dirette associate.

Sicurezza

• Chat, aggiunta al carrello e iscrizione ai promemoria sono protette dal token anti-CSRF standard di PrestaShop.
• I messaggi della chat vengono ripuliti da qualsiasi HTML prima della visualizzazione.
• Come copertina sono accettate solo immagini reali, e la cartella di upload blocca l’esecuzione di script.
• Per un codice embed viene usato solo l’indirizzo dell’iframe: nessun attributo né script viene iniettato nella pagina.

FAQ e risoluzione dei problemi

Il video non parte

Verifica il tipo di video e la sorgente. Per un flusso HLS, assicurati che l’URL .m3u8 sia pubblico e che l’encoder stia trasmettendo; il player riprova automaticamente per circa 90 secondi. Per un embed, verifica che l’URL YouTube, Twitch o Vimeo sia valido. Prima dell’avvio della diretta non viene caricato alcun video: è normale.

La diretta è senza audio

È una regola dei browser: la riproduzione automatica è consentita solo senza audio. Lo spettatore clicca su Attiva l’audio sul video.

Il prezzo dell’offerta flash non cambia per gli spettatori

L’offerta viene applicata tramite un SpecificPrice creato al volo e propagata al ciclo di polling successivo. Verifica l’intervallo di polling, che l’offerta non sia già stata interrotta e che la sua durata non sia scaduta. Uno sconto in importo maggiore o uguale al prezzo del prodotto viene rifiutato.

La chat non appare o rifiuta i miei messaggi

Verifica che la chat sia attiva per la sessione e a livello globale. La chat degli ospiti deve essere attiva per i visitatori non registrati. L’anti-flood impone un intervallo minimo tra due messaggi. Se appare «Ricarica la pagina per continuare», la sessione del visitatore è cambiata (accesso da un’altra scheda, ad esempio): basta ricaricare.

Gli iscritti non hanno ricevuto l’e-mail di promemoria

Verifica la configurazione e-mail del negozio (Parametri avanzati > E-mail, con un’e-mail di prova) e consulta i log (Parametri avanzati > Log). Le e-mail partono all’avvio della diretta e poi a blocchi finché lo Studio è aperto: lascia lo Studio aperto fino al completamento dell’invio.

Il conto alla rovescia non appare

Il conto alla rovescia appare solo per le sessioni programmate con una data indicata. Senza data viene mostrato «La diretta sta per iniziare».

Il contatore del carrello non si aggiorna

Il prodotto viene aggiunto al carrello; l’aggiornamento del blocco carrello dipende dal modulo carrello del tema (ps_shoppingcart). Se usi CCC, svuota la cache dopo aver aggiornato il modulo.

Il modulo funziona su hosting condiviso?

Sì. La sincronizzazione in tempo reale usa il polling AJAX, senza server WebSocket né SFU, il che garantisce la compatibilità con i comuni hosting condivisi.

Cronologia delle versioni

1.1.0 — 26 ottobre 2026

• Compatibilità con PrestaShop da 1.7.0 a 1.7.8 (PHP da 5.6 a 8.3), oltre a 8 e 9.
• Promemoria «Avvisami» inviati via e-mail all’avvio della diretta (5 lingue).
• Replay: passaggio automatico, video non più coperto, timeline dei prodotti.
• Pulsante «Attiva l’audio», ripresa automatica HLS, prodotto fissato visibile anche a chi arriva dopo.
• Offerte flash con durata, prezzo normale ripristinato alla fine dell’offerta.
• Multinegozio: scelta dei negozi per diretta.
• Sicurezza: token anti-CSRF, controllo degli upload, anti-flood ospiti per IP, embed filtrato.
• URL pulite, meta SEO, breadcrumb, drag & drop dei prodotti, annunci in banner.

1.0.0 — 6 giugno 2026

• Versione iniziale per PrestaShop 8 e 9.