DataFirefly Product Video

Panoramica

DataFirefly Product Video aggiunge video direttamente nella galleria di miniature della scheda prodotto di PrestaShop, accanto alle immagini. Sono supportate tre fonti: file ospitati (MP4, WebM, OGG), YouTube e Vimeo. Ogni video dispone del proprio poster, delle proprie opzioni di riproduzione e di una posizione personalizzabile.

• Compatibilità: PrestaShop da 8.0 a 8.9
• Multistore: sì
• Multilingua: titolo e descrizione traducibili per lingua
• Versione: 1.0.0

Installazione

1. Nel back-office, vai su Moduli > Gestore moduli.
2. Clicca su Carica un modulo e seleziona il file dfproductvideo.zip.
3. Il modulo crea automaticamente le sue tabelle e le cartelle di upload (img/dfproductvideo/videos e img/dfproductvideo/posters).
4. Clicca su Configura per definire le impostazioni predefinite.

Configurazione globale

La pagina di configurazione definisce i valori applicati per impostazione predefinita a ogni nuovo video:

• Autoplay – riproduzione automatica (la modalità muta è richiesta da Chrome e Safari).
• Muto – obbligatorio se l’autoplay è attivo.
• Loop – riproduce il video in modo continuo.
• Mostra controlli – barra di riproduzione nativa.
• Caricamento differito (lazy load) – carica il video solo quando diventa visibile.
• Lightbox / Schermo intero – apre il video in sovrimpressione.
• Responsive – si adatta alla larghezza dello schermo.
• Analytics – conta il numero di riproduzioni per video.
• Dimensione max file (MB) – limite di upload, 50 MB per impostazione predefinita.
• Estensioni consentite – per impostazione predefinita mp4,webm,ogg.
• Colore e sfondo dell’icona Play – personalizzazione del pulsante di riproduzione.

Aggiungere un video a un prodotto

1. Apri una scheda prodotto nel back-office.
2. Vai alla scheda Video aggiunta dal modulo.
3. Scegli la fonte: file da caricare, link YouTube o link Vimeo.
4. Se necessario, indica un poster (immagine di copertina) e un titolo / descrizione per lingua.
5. Regola le opzioni di riproduzione (autoplay, muto, loop, controlli) se differiscono dai valori predefiniti.
6. Salva. Il video appare nella galleria del prodotto.

I video possono essere riordinati tramite trascinamento, attivati o disattivati, e uno di essi può essere designato come video di copertina (uno solo per prodotto e per negozio).

Poster automatici

Se non viene fornito alcun poster, il modulo genera automaticamente un’immagine di anteprima: la miniatura di YouTube (hqdefault) per i video YouTube e la miniatura di Vimeo per i video Vimeo. Per i file caricati, si consiglia di fornire un poster manualmente.

Visualizzazione nel front-office

I video vengono inseriti nella galleria di miniature della scheda prodotto, subito dopo le immagini. Al clic, il video viene riprodotto sul posto o si apre in un lightbox a seconda della configurazione. I video caricati utilizzano il player HTML5 nativo; YouTube e Vimeo sono integrati tramite il loro player ufficiale con i parametri corrispondenti alle opzioni scelte (autoplay, muto, loop, controlli).

Analytics

Quando l’opzione Analytics è attiva, ogni riproduzione incrementa un contatore (play_count) memorizzato nel database. Ciò consente di misurare il coinvolgimento video per prodotto.

Disinstallazione

La disinstallazione rimuove le tabelle del modulo e le sue impostazioni. Anche i file video e i poster associati ai prodotti vengono eliminati.

Dettagli tecnici

• Tabelle: dfproductvideo (video e opzioni) e dfproductvideo_lang (titolo / descrizione tradotti).
• Hook utilizzati: displayAdminProductsExtra, displayAfterProductThumbs, actionFrontControllerSetMedia, actionProductUpdate, actionProductDelete, displayBackOfficeHeader.
• Gestione dei video tramite un controller AJAX (salvataggio, eliminazione, riordino, attivazione).
• Tracciamento delle riproduzioni tramite un controller front dedicato.