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
Se hai domande sull'aggiunta di provider o riscontri problemi, consulta la nostra pagina di Supporto o contattaci.