Integrazione YouTube Feed: configurazione e aiuto

Nelle versioni precedenti di PrestaShop, usa la pagina di installazione dei moduli equivalente. Apri questo modulo tramite "Configure" ogni volta che vuoi tornare alle sue impostazioni.

Il link al profilo/canale nell’intestazione è annidato nel blocco del titolo della sezione. Imposta Titolo sezione per mostrarlo. Il pulsante separato per seguire/iscriversi ha un proprio interruttore.

I controlli di colonne e spaziatura si applicano al layout del feed. Controlla il carosello alle larghezze del tuo negozio su desktop e dispositivi mobili.

Per i video manuali, usa questi formati URL con un ID video YouTube reale di 11 caratteri:

https://www.youtube.com/watch?v=ABCDEFGHIJK
https://youtu.be/ABCDEFGHIJK
https://www.youtube.com/embed/ABCDEFGHIJK
https://www.youtube.com/shorts/ABCDEFGHIJK

L’ID di esempio è un segnaposto. Sostituiscilo con un video disponibile. Il parser estrae l’ID e crea l’URL di visione, incorporamento e miniatura img.youtube.com. Richiede titolo e autore a YouTube oEmbed. Un ID valido genera comunque una scheda se oEmbed fallisce, ma titolo/autore possono essere vuoti e miniatura/player possono non funzionare.

Per una fonte automatica, inserisci Chiave API YouTube più ID playlist o ID canale. Con una playlist impostata, il modulo usa l’endpoint playlistItems. Altrimenti usa search per i video del canale ordinati per data. Poi richiede i dettagli videos per durate e statistiche. Il risultato è limitato a 25 per richiesta API. Se l’API non restituisce video, usa gli URL manuali come ripiego. Non riprova con ID canale dopo una richiesta playlist non riuscita.

La modalità manuale non ha durata, visualizzazioni né data di pubblicazione. La data API usa quella fornita dalla fonte selezionata. Visualizzi un solo feed configurato; il modulo non assegna video ai singoli prodotti. Una pagina prodotto può mostrare lo stesso feed se il tema renderizza l’hook selezionato.

In Modalità player embed, JavaScript del modulo intercetta il link della miniatura e apre una lightbox. Compila un URL iframe YouTube con autoplay=1&rel=0. Usa il pulsante di chiusura, fai clic sullo sfondo o premi Escape per chiuderla. La chiusura svuota la fonte dell’iframe e interrompe la riproduzione.

In modalità newtab, il link apre la pagina di visione YouTube in una nuova scheda. Senza JavaScript, il link della miniatura porta comunque a YouTube, ma le miniature a caricamento differito JavaScript possono restare non caricate. Il modulo non controlla disponibilità, pubblicità o restrizioni di account/video del player remoto. Prova i video specifici che intendi usare.

La cache del feed usa questo file locale:

modules/mpryoutubeintegration/mpryoutube_feed_cache.json

I dati del feed vengono salvati in un file JSON locale per installazione del modulo. I negozi che usano la stessa directory condividono il file. Una richiesta al negozio recupera i video quando la cache manca o è scaduta. Nessuna attività pianificata in background aggiorna questo feed.

Usa Clear Cache per eliminare il file di cache. Anche il salvataggio delle impostazioni principali lo svuota. La successiva richiesta al negozio recupera nuovi video; i contenuti precedenti non restano visibili durante la richiesta.

Vengono salvati solo risultati non vuoti. Se il recupero fallisce o non restituisce video, quella richiesta non mostra il feed e le richieste successive riprovano. Un file scaduto può restare sul server, ma i suoi vecchi video non vengono mostrati. Conteggi API e date relative riflettono la risposta in cache.

Gli esempi seguenti descrivono i valori da inserire nei moduli del back office. Non sono comandi shell. Sostituisci nomi degli account, ID di pin/video e credenziali con valori reali. L’hook del tema deve corrispondere a Hook di visualizzazione.

Griglia manuale di demo prodotto senza chiave API:

MPRYOUTUBE_ENABLED=1
MPRYOUTUBE_VIDEO_URLS=https://www.youtube.com/watch?v=ABCDEFGHIJK
https://youtu.be/LMNOPQRSTUV
https://www.youtube.com/shorts/WXYZabcdefg
MPRYOUTUBE_DISPLAY_HOOK=displayHome
MPRYOUTUBE_LAYOUT=grid
MPRYOUTUBE_POST_COUNT=3
MPRYOUTUBE_COLUMNS=3
MPRYOUTUBE_PLAYER_MODE=embed

Slider playlist con recupero API in cache:

MPRYOUTUBE_ENABLED=1
MPRYOUTUBE_API_KEY=AIza...
MPRYOUTUBE_PLAYLIST_ID=PL...
MPRYOUTUBE_DISPLAY_HOOK=displayFooterBefore
MPRYOUTUBE_LAYOUT=slider
MPRYOUTUBE_POST_COUNT=6
MPRYOUTUBE_AUTO_SCROLL=1
MPRYOUTUBE_SCROLL_SPEED=4000
MPRYOUTUBE_CACHE_DURATION=3600

Formati URL manuali accettati:

https://www.youtube.com/watch?v=ABCDEFGHIJK
https://youtu.be/ABCDEFGHIJK
https://www.youtube.com/embed/ABCDEFGHIJK
https://www.youtube.com/shorts/ABCDEFGHIJK

Se il tema non mostra l’hook selezionato, aggiungi la chiamata all’hook PrestaShop corrispondente nel template Smarty pertinente:

{hook h='displayFooterBefore'}

Il CSS del tema può usare le classi del modulo nel negozio:

.mprfeed-youtube .mprfeed-title {
  font-size: 20px;
}

.mprfeed-youtube .mprfeed-follow-youtube {
  background: #cc0000;
}

.mprfeed-youtube .mprfeed-caption {
  min-height: 2.8em;
}

La cache del feed usa questo file locale:

modules/mpryoutubeintegration/mpryoutube_feed_cache.json

Mantieni le modifiche CSS e ai template nel tema.

• Se la sezione non compare, controlla Attiva modulo, i campi delle fonti, Mostra su mobile e l’hook selezionato. Il modulo non restituisce alcuna sezione quando non ci sono elementi disponibili.
• Verifica che il tema chiami displayHeader per caricare il foglio di stile e JavaScript e renderizzi l’hook di visualizzazione selezionato.
• Se le immagini restano vuote, controlla gli errori di rete del browser. Prova a disattivare il caricamento differito e verifica gli URL delle immagini.
• Se il layout è errato, prova prima la griglia, poi verifica il carosello alle larghezze desktop e mobile.
• Se MPR Social Revolution ha l’impostazione YOUTUBE_ACTIVE attiva, questo feed autonomo viene soppresso. Il controllo legge il flag salvato; non richiede che Social Revolution sia attualmente attivo come modulo.

Apri la pagina "Integrity" del modulo per i controlli di configurazione e hook. Licenza, Assistenza e Aggiorna sono pagine di manutenzione. Prova le destinazioni effettive dopo aver modificato gli identificativi degli account o le fonti del feed.

Imposta Attiva modulo su No e salva per nascondere il feed mantenendo la configurazione. Disinstalla dal gestore moduli per rimuovere configurazione, cache locale e voci del menu amministrativo del modulo.