Passa al contenuto principale

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.

Importante

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

🎥 Provider Predefinito

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
...
Opzione Privacy

Il modulo ha l'opzione di utilizzare la modalità privacy migliorata di YouTube (youtube-nocookie.com)


Vimeo

🎬 Provider Predefinito

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)

💾 Controllo completo

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
Risorse del Server

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

🔧 Soluzione universale

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
Oltre i Video

I provider personalizzati non sono limitati ai video - usali per modelli 3D interattivi, mappe o qualsiasi contenuto incorporabile!

Avviso di Sicurezza

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.

Nota

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:

Per piattaforme con URL video (come Dailymotion):

  1. Vai a Moduli → Product Video → Configura
  2. Clicca sulla scheda Provider
  3. Clicca su Aggiungi Nuovo Provider
  4. Compila il modulo:
    • Nome: Nome del provider (es., "Dailymotion")
    • Tipo: Seleziona "Schema URL"
    • Dominio URL: Inserisci il dominio URL (es., dailymotion.com)
  5. Clicca su Salva

Esempio Schema URL:

Dominio: dailymotion.com
Il percorso contiene: /video/

Aggiunta di Video ai Prodotti

Processo Passo dopo Passo

Utilizzo dei provider configurati:

  1. Vai a Catalogo → Prodotti
  2. Modifica il tuo prodotto
  3. Vai alla scheda Video
  4. Clicca su Aggiungi Video
  5. Incolla l'URL del tuo video
  6. Controlla lo stato dell'URL:
    • Verde: Provider riconosciuto, pronto per salvare
    • Rosso: Provider non configurato
URL Rifiutato?

Se l'URL diventa rosso, significa che quel provider non è ancora stato aggiunto. Devi:

  1. Aggiungere prima il provider nella configurazione del modulo
  2. Tornare e riprovare

Prossimamente: Link diretto per aggiungere provider da questa schermata!

  1. Configura le opzioni di visualizzazione (opzionale)
  2. 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:

Prossimamente

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:

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


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:

  1. Nota da quale piattaforma proviene il tuo video (es., Dailymotion)
  2. Vai a Moduli → Product Video → Configura → Provider
  3. Aggiungi quel provider (vedi Aggiunta di Provider Personalizzati)
  4. Torna al tuo prodotto
  5. 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.

attenzione

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:

  1. Identifica la piattaforma video (YouTube, Vimeo, Dailymotion, ecc.)
  2. Verifica se quel provider è abilitato in Moduli → Product Video → Provider
  3. Se non è elencato, aggiungi il provider
  4. 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:

  1. Copia il dominio dal tuo iframe src (es., player.example.com)
  2. Vai a Provider → Il Tuo Provider Personalizzato
  3. Aggiungi quel dominio ai Domini Consentiti
  4. Salva e riprova

Esempio:

<iframe src="https://player.example.com/video/123">

Aggiungi player.example.com ai domini consentiti.


Migliori Pratiche

Raccomandazioni
  1. Abilita solo i provider necessari - Mantieni la tua lista pulita e gestibile
  2. Usa prima i provider predefiniti - YouTube/Vimeo sono testati e ottimizzati
  3. Documenta i provider personalizzati - Annota perché hai aggiunto ogni provider personalizzato
  4. Rivedi i domini consentiti - Controlla periodicamente le impostazioni di sicurezza iframe
  5. 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


Hai Bisogno di Aiuto?

Se hai domande sull'aggiunta di provider o riscontri problemi, consulta la nostra pagina di Supporto o contattaci.