DataFirefly Live Shopping — Guida completa
Installare, configurare e animare vendite in diretta: video nativo (HLS / MP4 / embed), Studio in tempo reale, offerte flash, chat e carrello nativo per PrestaShop 8 e 9.
Panoramica
Il modulo DataFirefly Live Shopping (dflive) trasforma il tuo negozio PrestaShop in una piattaforma di vendita video in diretta. Trasmetti una diretta, fissi prodotti in tempo reale, lanci offerte flash, i tuoi clienti aggiungono al carrello senza lasciare la trasmissione, e la sessione resta accessibile come replay. Tutto funziona nel tuo negozio: nessuna piattaforma di live shopping di terze parti, nessun abbonamento ricorrente.
Tre pilastri: un video nativo (HLS, MP4 o embed), uno Studio in tempo reale integrato nel back office per gestire la diretta, e un livello di shopping (fissaggio prodotti, offerte flash, carrello nativo, chat, reazioni, riprova sociale).
Compatibilità
- PrestaShop da 8.0 a 9.x
- PHP da 7.4 a 8.3
- Mono-negozio e multistore
- 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 in tempo reale tramite polling AJAX, senza WebSocket né SFU)
Requisiti
Il modulo gestisce la riproduzione del video e tutto il livello di shopping, ma sei tu a fornire la sorgente video. A seconda della modalità scelta:
- HLS: un flusso
.m3u8servito dal tuo server HLS, da Mux o da Cloudflare Stream, alimentato da un encoder come OBS. - MP4: un URL che punta a un file
.mp4accessibile pubblicamente. - Embed: una diretta YouTube, Twitch o Vimeo (URL o codice di integrazione).
Si consiglia HTTPS: la riproduzione automatica e lo schermo intero funzionano meglio su un negozio servito in HTTPS, di cui dispongono già la quasi totalità dei negozi in produzione.
Installazione
- Nel back office, apri Moduli > Gestore dei moduli.
- Clicca su Carica un modulo e seleziona il file
dflive.zip. - Una volta installato, apri il menu Vendi > Live Shopping.
All’installazione, il modulo crea le sue tabelle (sessioni, prodotti di sessione, messaggi, eventi, presenza, promemoria), registra le schede sotto Vendi, aggiunge le rotte /live e /live/{id}-{slug} e attiva il widget della homepage.
Creare una diretta
Da Vendi > Live Shopping, clicca su Aggiungi. Il modulo è organizzato in schede:
Generale
- Titolo e descrizione della diretta (multilingua).
- Presentatore: nome mostrato come host nella chat e sotto il video.
- Data programmata: attiva il conto alla rovescia lato spettatore.
- Stato: programmata, in diretta o terminata.
- Immagine di copertina: mostrata prima della diretta e negli elenchi.
Video
- Tipo di video: HLS, MP4 o embed.
- Sorgente video: l’URL
.m3u8, l’URL.mp4o l’URL / codice embed secondo il tipo. - URL di replay (opzionale): per esempio la registrazione VOD del tuo server HLS, servita dopo la diretta.
Prodotti
Associa i prodotti che saranno presentati durante la diretta tramite il selettore con ricerca AJAX. Questi prodotti alimentano il carosello lato spettatore e diventano fissabili dallo Studio.
Opzioni e SEO
Attiva o disattiva la chat, la chat ospiti, le reazioni e la riprova sociale per questa sessione, e indica il titolo e la descrizione SEO della pagina della diretta.
Trasmettere il flusso
Per una diretta in HLS, il principio è il seguente:
- Configura il tuo encoder (OBS, per esempio) per trasmettere verso il tuo server HLS, Mux o Cloudflare Stream.
- Recupera l’URL
.m3u8in uscita e incollalo nel campo Sorgente video della sessione. - Avvia la trasmissione dal tuo encoder, poi apri lo Studio e clicca su Vai in diretta.
Il modulo non ti vincola ad alcuna infrastruttura: scegli la tua catena di trasmissione (auto-ospitata o cloud) e incolli semplicemente l’URL. Per un test rapido, basta un file MP4 o un embed YouTube / Twitch.
Lo Studio (regia)
Lo Studio è la sala di controllo integrata nel back office. Aprilo dal pulsante Studio dell’elenco delle dirette.
- Vai in diretta / Termina: cambia lo stato della sessione. Al termine, le offerte flash attive vengono ripulite automaticamente.
- Fissare un prodotto: la sua scheda appare immediatamente in sovrimpressione agli spettatori. Fissare un prodotto sfissa automaticamente il precedente.
- Offerta flash: inserisci uno sconto (per esempio
20%o10€). Il modulo crea unSpecificPriceal volo e il prezzo ricalcolato appare all’istante agli spettatori. Un pulsante dedicato interrompe l’offerta. - Annuncio: diffonde un messaggio host fissato nella chat.
- Moderazione: nascondere, mostrare o fissare qualsiasi messaggio della chat.
- Statistiche in diretta: numero di spettatori e di reazioni in tempo reale.
Lo Studio invia eventi (fissaggio, offerta, annuncio, cambio di stato) che gli spettatori raccolgono al ciclo di polling successivo. L’intervallo è configurabile nelle impostazioni del modulo.
Lato spettatore
La pagina di una diretta (/live/{id}-{slug}) presenta:
- Il lettore video con un banner «IN DIRETTA» e il numero di spettatori.
- La scheda del prodotto fissato in sovrimpressione, con pulsante di aggiunta al carrello.
- Il carosello di prodotti della diretta, ciascuno aggiungibile al carrello nativo di PrestaShop con un clic.
- La chat (clienti e, se attivata, ospiti) con anti-flood, messaggi host e reazioni a cuori animate.
- Gli avvisi di riprova sociale «Qualcuno ha appena aggiunto…» alle azioni di aggiunta al carrello.
Per una sessione programmata, lo spettatore vede un conto alla rovescia e può iscriversi via e-mail per essere avvisato all’avvio. Dopo la diretta, la sessione passa al replay e resta accessibile.
Impostazioni del modulo
La pagina di configurazione raccoglie le impostazioni globali, in particolare:
- Intervallo di polling (3000 ms di default): frequenza di aggiornamento della chat e degli eventi.
- Chat attivata e chat ospiti: consente la chat e, se del caso, la partecipazione dei visitatori non connessi.
- Reazioni e riprova sociale: attiva i cuori e gli avvisi di aggiunta al carrello.
- Timeout di presenza: durata oltre la quale uno spettatore inattivo non viene più conteggiato.
- Lunghezza massima di un messaggio e anti-flood: inquadrano la chat.
- Widget homepage e numero di dirette mostrate: gestiscono il blocco della homepage.
Pagina elenco e widget homepage
La pagina /live elenca le dirette in corso, in arrivo e i replay. Il widget della homepage mette in evidenza le sessioni attive e programmate, fino al limite configurato.
FAQ e risoluzione dei problemi
Il video non si avvia
Verifica il tipo di video e la sorgente. Per un flusso HLS, assicurati che l’URL .m3u8 sia accessibile pubblicamente e che il tuo encoder stia effettivamente trasmettendo. Per un embed, verifica che l’URL di YouTube, Twitch o Vimeo sia valido.
Il prezzo dell’offerta flash non cambia per gli spettatori
L’offerta è applicata tramite un SpecificPrice creato al volo e propagata al ciclo di polling successivo. Verifica l’intervallo di polling e che l’offerta non sia già stata interrotta. Le offerte attive vengono ripulite automaticamente al termine della diretta.
La chat non appare o rifiuta i miei messaggi
Controlla che la chat sia attivata per la sessione e globalmente. La chat ospiti deve essere attivata per consentire i visitatori non connessi. L’anti-flood impone un ritardo minimo tra due messaggi.
Il conto alla rovescia non viene mostrato
Il conto alla rovescia appare solo per le sessioni con stato programmata la cui data è nel futuro. Verifica lo stato e la data programmata.
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 l’hosting condiviso comune.