# DataFirefly Product Video

> Guida all'uso del modulo DataFirefly Product Video: aggiungere video (MP4, YouTube, Vimeo) nella galleria prodotto di PrestaShop.

- Pagina: <https://www.datafirefly.com/it/documentation/dfproductvideo/>
- Lingua: it
- Aggiornato il: 2026-06-15
- Altre lingue: [fr](https://www.datafirefly.com/documentation/dfproductvideo/index.md), [en](https://www.datafirefly.com/en/documentation/dfproductvideo/index.md), [es](https://www.datafirefly.com/es/documentation/dfproductvideo/index.md), [de](https://www.datafirefly.com/de/documentation/dfproductvideo/index.md), [pl](https://www.datafirefly.com/pl/documentation/dfproductvideo/index.md), [pt](https://www.datafirefly.com/pt/documentation/dfproductvideo/index.md), [nl](https://www.datafirefly.com/nl/documentation/dfproductvideo/index.md)
- Indice: <https://www.datafirefly.com/it/documentation/llms.txt>

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