Provider di Video
Cosa sono i Provider di Video?
I provider di video sono le piattaforme o fonti da cui provengono i tuoi video di prodotto. Il modulo Product Video supporta più provider, rendendo facile aggiungere video da diverse fonti ai tuoi prodotti.
Il modulo viene fornito con due provider preconfigurati: YouTube e Vimeo. Altri provider devono essere configurati prima nelle impostazioni del modulo prima di poterli utilizzare.
Provider Supportati
YouTube
La piattaforma video più grande al mondo - perfetta per demo di prodotti, tutorial e recensioni.
Perché usare YouTube?
- ✅ Hosting illimitato gratuito
- ✅ Regolazione automatica della qualità
- ✅ Caricamento veloce in tutto il mondo
- ✅ Controlli del player integrati
- ✅ Riproduzione ottimizzata per mobile
Formati URL supportati: Video Regolari e Shorts
https://www.youtube.com/watch?v=VIDEO_ID
https://youtu.be/VIDEO_ID
https://youtube.com/shorts/VIDEO_ID
...
Il modulo ha l'opzione di utilizzare la modalità privacy migliorata di YouTube (youtube-nocookie.com)
Vimeo
Piattaforma professionale di hosting video senza pubblicità, ideale per presentazioni di prodotti di alta qualità.
Perché usare Vimeo?
- ✅ Riproduzione pulita senza pubblicità
- ✅ Aspetto professionale
- ✅ Streaming di alta qualità
- ✅ Colori del player personalizzabili
- ✅ Controlli della privacy
Formati URL supportati:
https://vimeo.com/VIDEO_ID
https://player.vimeo.com/video/VIDEO_ID
HTML5 (Auto-ospitato)
Ospita i tuoi file video direttamente sul tuo server per il controllo completo.
Perché usare HTML5?
- ✅ Controllo completo sui tuoi contenuti
- ✅ Nessuna dipendenza da terze parti
- ✅ Nessun marchio o pubblicità
- ✅ Funziona offline/intranet
- ✅ Stile del player personalizzato
Requisiti:
- Formato consigliato: MP4 (codec H.264)
- Dimensione massima file: Dipende dal tuo server (tipicamente 50-100MB)
- Altri formati supportati: WebM, OGG
I video auto-ospitati utilizzano la larghezza di banda del tuo server. Per negozi ad alto traffico, considera YouTube o Vimeo.
Tecnico: Impostazioni video ottimali
Per prestazioni e compatibilità ottimali:
Formato: MP4
Codec: H.264
Risoluzione: (dipende dalla finalità, se è supportato lo schermo intero)
Rapporto d'Aspetto: Lo stesso delle immagini del prodotto, se verrà utilizzata la posizione dell'immagine
Bitrate: 5-8 Mbps
Frame rate: 30 fps
Audio: AAC, 128 kbps
iFrame Personalizzato
Incorpora contenuti da qualsiasi piattaforma utilizzando il codice iframe - non solo video!
Cosa puoi incorporare?
- 📹 Video da qualsiasi piattaforma (Dailymotion, Wistia, Facebook, ecc.)
- 🗺️ Mappe interattive
- 🎨 Visualizzatori di modelli 3D
- 📊 Presentazioni interattive
- 🎮 Configuratori di prodotti
- ...qualsiasi cosa che fornisca codice di incorporamento iframe!
Perché usare Provider Personalizzati?
- ✅ Funziona con QUALSIASI piattaforma
- ✅ Supporto per contenuti specializzati
- ✅ Massima flessibilità
- ✅ Facile aggiungere nuove piattaforme
I provider personalizzati non sono limitati ai video - usali per modelli 3D interattivi, mappe o qualsiasi contenuto incorporabile!
Per motivi di sicurezza, verranno accettate solo URL da provider configurati. Se incolli un URL da una piattaforma non configurata, dovrai prima aggiungere quel provider.
Come Aggiungere/Abilitare Provider
Utilizzo dei Provider Predefiniti (YouTube/Vimeo)
YouTube e Vimeo sono preconfigurati e non possono essere rimossi. Gli script relativi all'uso di questi provider verranno caricati solo se il prodotto ha un video da essi, altrimenti non verranno caricati script.
I provider predefiniti non possono essere disabilitati né eliminati per prevenire malfunzionamenti del modulo.
Aggiunta di Provider Personalizzati
Per altre piattaforme (Dailymotion, Wistia, Facebook, ecc.), devi prima aggiungerle:
- Provider basato su URL
- Provider iFrame
Per piattaforme con URL video (come Dailymotion):
- Vai a Moduli → Product Video → Configura
- Clicca sulla scheda Provider
- Clicca su Aggiungi Nuovo Provider
- Compila il modulo:
- Nome: Nome del provider (es., "Dailymotion")
- Tipo: Seleziona "Schema URL"
- Dominio URL: Inserisci il dominio URL (es.,
dailymotion.com)
- Clicca su Salva
Esempio Schema URL:
Dominio: dailymotion.com
Il percorso contiene: /video/
Per qualsiasi piattaforma con codice di incorporamento iframe:
- Vai a Moduli → Product Video → Configura
- Clicca sulla scheda Provider
- Clicca su Aggiungi Nuovo Provider
- Compila il modulo:
- Nome: Nome del provider (es., "Sketchfab 3D")
- Tipo: Seleziona "iFrame Personalizzato"
- Domini Consentiti: Inserisci domini fidati (sicurezza)
- Clicca su Salva
Quando usi questo provider: Gli utenti incolleranno il codice iframe completo, non solo un URL.
Aggiungi solo domini fidati per prevenire l'incorporamento di contenuti dannosi.
Aggiunta di Video ai Prodotti
Processo Passo dopo Passo
- YouTube / Vimeo / URLs
- HTML5 (Carica)
- iFrame Personalizzato
Utilizzo dei provider configurati:
- Vai a Catalogo → Prodotti
- Modifica il tuo prodotto
- Vai alla scheda Video
- Clicca su Aggiungi Video
- Incolla l'URL del tuo video
- Controlla lo stato dell'URL:
- ✅ Verde: Provider riconosciuto, pronto per salvare
- ❌ Rosso: Provider non configurato
Se l'URL diventa rosso, significa che quel provider non è ancora stato aggiunto. Devi:
- Aggiungere prima il provider nella configurazione del modulo
- Tornare e riprovare
Prossimamente: Link diretto per aggiungere provider da questa schermata!
- Configura le opzioni di visualizzazione (opzionale)
- Clicca su Salva
Carica il tuo file video:
- Vai a Catalogo → Prodotti
- Modifica il tuo prodotto
- Vai alla scheda Video
- Clicca su Aggiungi Video
- Seleziona l'opzione Carica file
- Scegli il tuo file video dal tuo computer
- Attendi il completamento del caricamento
- Configura le opzioni di visualizzazione (opzionale)
- Clicca su Salva
Consigli:
- Comprimi il tuo video prima di caricarlo
- Usa il formato MP4 per la migliore compatibilità
- Mantieni la dimensione del file sotto i 50MB quando possibile
Utilizzo di provider iframe personalizzati:
- Assicurati di aver aggiunto un provider iframe prima
- Ottieni il tuo codice iframe dalla piattaforma
- Vai a Catalogo → Prodotti
- Modifica il tuo prodotto
- Vai alla scheda Video
- Clicca su Aggiungi Video
- Seleziona il tuo provider iFrame Personalizzato
- Incolla il codice iframe completo
- Controlla lo stato del codice:
- ✅ Verde: Dominio consentito, pronto per salvare
- ❌ Rosso: Dominio non nella lista consentita
Solo i domini aggiunti alla lista consentita del provider funzioneranno. Questo previene l'incorporamento di contenuti dannosi.
- Configura le opzioni di visualizzazione (opzionale)
- Clicca su Salva
Sicurezza del Provider
Perché la Validazione URL?
Il modulo convalida tutti gli URL video per motivi di sicurezza:
Vantaggi:
- 🔒 Previene l'iniezione di contenuti dannosi
- ✅ Garantisce che vengano utilizzate solo piattaforme configurate
- 🛡️ Protegge il tuo negozio da attacchi XSS
- 📋 Mantiene il controllo sulle fonti di contenuto
Come funziona:
Nei futuri aggiornamenti, potrai aggiungere provider direttamente dalla schermata "Aggiungi Video" senza lasciare la pagina!
Scegliere il Provider Giusto
Guida Decisionale Rapida
Usa YouTube quando:
- Il tuo video è già su YouTube
- Vuoi hosting gratuito e veloce
- Hai bisogno di disponibilità globale
- Sei d'accordo con il marchio YouTube
Usa Vimeo quando:
- Vuoi un'esperienza senza pubblicità
- Hai bisogno di un aspetto professionale
- Vuoi controlli avanzati della privacy
- Hai un account Vimeo
Usa HTML5 quando:
- Hai bisogno di controllo completo
- Hai pochi video (larghezza di banda del server)
- Non vuoi marchi di terze parti
- Sei in un ambiente intranet/offline
Usa Provider Personalizzato quando:
- Il tuo video è su un'altra piattaforma
- Hai bisogno di contenuti interattivi (mappe, 3D)
- I provider standard non supportano la tua piattaforma
- Hai requisiti di incorporamento specializzati
Impostazioni Provider
Configurazione dei Provider Abilitati
Ogni provider ha impostazioni specifiche che puoi personalizzare:
- YouTube
- Vimeo
- HTML5
- Provider Personalizzati
Opzioni Disponibili:
- ✓ Abilita/Disabilita provider
- Riproduzione automatica (on/off)
- Mostra/nascondi controlli
- Video in loop
- Modalità privacy (youtube-nocookie.com)
- Marchio discreto
Accesso: Moduli → Product Video → Configura → Provider → YouTube
Opzioni Disponibili:
- ✓ Abilita/Disabilita provider
- Riproduzione automatica (on/off)
- Mostra/nascondi controlli
- Video in loop
- Personalizzazione del colore del player
- Mostra/nascondi titolo del video
Accesso: Moduli → Product Video → Configura → Provider → Vimeo
Opzioni Disponibili:
- Mostra/nascondi controlli
- Video in loop
- Impostazioni di precaricamento
- Immagine poster personalizzata
- Formati di file consentiti
Accesso: Moduli → Product Video → Configura → Impostazioni HTML5
Opzioni Disponibili:
- ✓ Abilita/Disabilita provider
- Nome provider
- Domini consentiti (sicurezza)
- Wrapper responsive
- Consenti schermo intero
- Impostazioni sandbox
Accesso: Moduli → Product Video → Configura → Provider → [Il Tuo Provider]
Domande Comuni
Perché non posso incollare qualsiasi URL voglio?
Per motivi di sicurezza, il modulo accetta solo URL da provider configurati. Questo previene:
- Iniezione di contenuti dannosi
- Incorporamento iframe non autorizzato
- Attacchi XSS sul tuo negozio
- Fonti di contenuto sconosciute/non affidabili
Soluzione: Aggiungi prima il provider nella configurazione del modulo, poi usa l'URL.
Il mio URL è diventato rosso - cosa devo fare?
Un URL rosso significa che il provider non è ancora configurato. Segui questi passaggi:
- Nota da quale piattaforma proviene il tuo video (es., Dailymotion)
- Vai a Moduli → Product Video → Configura → Provider
- Aggiungi quel provider (vedi Aggiunta di Provider Personalizzati)
- Torna al tuo prodotto
- Incolla di nuovo l'URL - ora dovrebbe diventare verde!
Posso usare più provider sullo stesso prodotto?
Sì! Puoi mescolare diversi provider su un singolo prodotto:
- Video demo YouTube
- Testimonianza Vimeo
- Primo piano prodotto HTML5
- Visualizzatore 3D iframe personalizzato
Finché ogni provider è configurato, funzionano tutti insieme.
Devo aggiungere YouTube e Vimeo?
No! YouTube e Vimeo sono preconfigurati. Devi solo abilitarli nelle impostazioni Provider. Non è necessario aggiungere schemi o configurazioni.
Posso disabilitare temporaneamente un provider?
Sì! Vai alle impostazioni Provider e clicca su Disabilita su qualsiasi provider. I video di quel provider smetteranno di essere visualizzati (ma non verranno eliminati).
Riabilita in qualsiasi momento per ripristinare la funzionalità.
Cosa succede ai video se rimuovo un provider?
I video rimangono nel tuo database ma non verranno visualizzati sul front-end. Se aggiungi nuovamente il provider, funzioneranno automaticamente di nuovo.
Fai attenzione quando elimini provider - assicurati che nessun prodotto stia usando video da quella fonte!
Risoluzione dei Problemi
Problemi Comuni
L'URL diventa rosso immediatamente quando incollato
Causa: Il provider per quell'URL non è ancora configurato.
Soluzione:
- Identifica la piattaforma video (YouTube, Vimeo, Dailymotion, ecc.)
- Verifica se quel provider è abilitato in Moduli → Product Video → Provider
- Se non è elencato, aggiungi il provider
- Prova a incollare di nuovo l'URL
Provider abilitato ma URL ancora rifiutato
Controlla questi punti:
✓ Il formato URL è corretto - Copia direttamente dalla pagina video ✓ Il provider è effettivamente abilitato - Verifica che l'interruttore sia su ON ✓ L'URL corrisponde allo schema - Per i provider personalizzati, verifica che il tuo schema sia corretto ✓ Svuota la cache - Sia la cache di PrestaShop che del browser
Ancora non funziona? Lo schema URL per il tuo provider personalizzato potrebbe essere errato. Ricontrolla il dominio e lo schema del percorso.
Codice iframe rifiutato (rosso)
Causa: Il dominio nell'iframe non è nella lista dei domini consentiti.
Soluzione:
- Copia il dominio dal tuo iframe src (es.,
player.example.com) - Vai a Provider → Il Tuo Provider Personalizzato
- Aggiungi quel dominio ai Domini Consentiti
- Salva e riprova
Esempio:
<iframe src="https://player.example.com/video/123">
Aggiungi player.example.com ai domini consentiti.
Migliori Pratiche
- Abilita solo i provider necessari - Mantieni la tua lista pulita e gestibile
- Usa prima i provider predefiniti - YouTube/Vimeo sono testati e ottimizzati
- Documenta i provider personalizzati - Annota perché hai aggiunto ogni provider personalizzato
- Rivedi i domini consentiti - Controlla periodicamente le impostazioni di sicurezza iframe
- Testa dopo l'aggiunta - Testa sempre un provider con un vero URL video
Consigli di Sicurezza:
- Aggiungi solo provider da piattaforme affidabili
- Mantieni la lista dei domini consentiti al minimo
- Rivedi regolarmente le fonti iframe personalizzate
- Disabilita i provider inutilizzati invece di eliminarli
Prossimi Passi
📍 Posizioni Video
Scopri dove i video possono essere visualizzati sulle tue pagine prodotto
⚙️ Configurazione
Configura le impostazioni del modulo e personalizza il comportamento
Quali provider video funzionano senza alcuna configurazione?
YouTube e Vimeo sono preconfigurati e pronti all'uso immediatamente dopo l'installazione del modulo. Tutti gli altri provider devono essere aggiunti manualmente nella configurazione del modulo prima di poterli utilizzare.
Perché l'URL del mio video diventa rossa quando la incollo?
Un URL rosso significa che il provider per quella piattaforma non è ancora configurato. Vai in Moduli, poi Product Video, poi Configura, poi Provider, aggiungi il provider per quella piattaforma e incolla nuovamente l'URL.
Posso aggiungere video da piattaforme diverse da YouTube e Vimeo?
Sì. Qualsiasi piattaforma che fornisce un URL o un codice iframe può essere aggiunta come provider personalizzato. Vai nella sezione Provider della configurazione del modulo e aggiungi il dominio della piattaforma come provider di tipo Schema URL o iFrame Personalizzato.
Cosa succede ai miei video se rimuovo un provider?
I video rimangono memorizzati nel database ma non vengono visualizzati in vetrina finché il provider non viene riaggiunto. Nessun dato video viene eliminato quando si rimuove un provider.
Se hai domande sull'aggiunta di provider o riscontri problemi, consulta la nostra pagina di Supporto o contattaci.