Integración YouTube Feed: configuración y ayuda

En versiones anteriores de PrestaShop, usa la página equivalente de instalación de módulos. Abre este módulo mediante "Configure" cuando necesites volver a su configuración.

El enlace al perfil/canal de la cabecera está dentro del bloque del título de sección. Configura Título de sección para que aparezca ese enlace. El botón independiente para seguir/suscribirse tiene su propio interruptor.

Los controles de columnas y espaciado se aplican al diseño del feed. Revisa el carrusel con las anchuras de tu tienda en escritorio y móvil.

Para vídeos manuales, usa estos formatos de URL con un ID de vídeo real de YouTube de 11 caracteres:

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

El ID de ejemplo es un marcador. Sustitúyelo por un vídeo disponible. El analizador extrae el ID y construye las URL de visualización, inserción y miniatura de img.youtube.com. Solicita el título y autor a YouTube oEmbed. Un ID válido genera una tarjeta aunque falle oEmbed, pero el título/autor pueden estar vacíos y la miniatura/reproductor pueden fallar.

Para un origen automático, introduce Clave API de YouTube junto con ID de la lista de reproducción o ID del canal. Con una lista configurada, el módulo usa el endpoint playlistItems. En caso contrario usa search para los vídeos del canal ordenados por fecha. Después solicita detalles de videos para duraciones y estadísticas. El resultado se limita a 25 por solicitud de API. Si la API no devuelve vídeos, recurre a las URL manuales. No reintenta con ID del canal tras fallar una solicitud de lista.

El modo manual no tiene duración, recuento de visualizaciones ni fecha de publicación. La fecha de la API usa la proporcionada por el origen seleccionado. Muestras un solo feed configurado; el módulo no asigna vídeos por producto. Una página de producto puede mostrar el mismo feed si su tema renderiza el hook seleccionado.

En Modo de reproductor embed, JavaScript del módulo intercepta el enlace de la miniatura y abre una lightbox. Completa una URL de iframe de YouTube con autoplay=1&rel=0. Usa el botón de cierre, haz clic en el fondo o pulsa Escape para cerrarla. Al cerrar se vacía el origen del iframe y se detiene la reproducción.

En modo newtab, el enlace abre la página de visualización de YouTube en una pestaña nueva. Sin JavaScript, el enlace de la miniatura también lleva a YouTube, aunque las miniaturas con carga diferida por JavaScript pueden no cargarse. El módulo no controla la disponibilidad del reproductor remoto, los anuncios ni las restricciones de cuenta/vídeo. Prueba los vídeos concretos que quieras usar.

La caché del feed usa este archivo local:

modules/mpryoutubeintegration/mpryoutube_feed_cache.json

Los datos del feed se guardan en un archivo JSON local por instalación del módulo. Las tiendas que usan el mismo directorio comparten ese archivo. Una solicitud a la tienda obtiene los vídeos cuando la caché no existe o ha caducado. Ninguna tarea programada en segundo plano actualiza este feed.

Usa Clear Cache para eliminar el archivo de caché. Guardar los ajustes principales también lo vacía. La siguiente solicitud a la tienda obtiene vídeos nuevos; el contenido anterior no se mantiene visible durante esa solicitud.

Solo se guardan resultados que contengan vídeos. Si la obtención falla o no devuelve vídeos, esa solicitud no muestra el feed y las siguientes vuelven a intentarlo. Un archivo caducado puede permanecer en el servidor, pero sus vídeos antiguos no se muestran. Los recuentos de la API y las fechas relativas reflejan la respuesta en caché.

Los ejemplos siguientes describen valores para los formularios del back office. No son comandos de shell. Sustituye los nombres de cuenta, ID de pines/vídeos y credenciales por valores reales. El hook del tema debe coincidir con Hook de visualización.

Cuadrícula manual de demostraciones de producto sin clave 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 de lista de reproducción con obtención de API en caché:

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

Formatos de URL manuales aceptados:

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

Si tu tema no muestra el hook seleccionado, añade la llamada al hook correspondiente de PrestaShop en la plantilla Smarty pertinente:

{hook h='displayFooterBefore'}

El CSS del tema puede aplicar estilos a las clases del módulo en la tienda:

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

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

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

La caché del feed usa este archivo local:

modules/mpryoutubeintegration/mpryoutube_feed_cache.json

Mantén los cambios de CSS y plantillas en tu tema.

• Si falta la sección, comprueba Activar módulo, los campos de origen, Mostrar en móvil y el hook seleccionado. El módulo no devuelve ninguna sección cuando no hay elementos disponibles.
• Comprueba que tu tema llame a displayHeader para cargar la hoja de estilos y JavaScript, y renderice el hook de visualización seleccionado.
• Si las imágenes siguen vacías, revisa los errores de red del navegador. Prueba a desactivar la carga diferida y comprueba las URL de las imágenes.
• Si el diseño es incorrecto, prueba primero la cuadrícula y después verifica el carrusel con anchuras de escritorio y móvil.
• Si MPR Social Revolution tiene activado el ajuste YOUTUBE_ACTIVE, este feed independiente se oculta. La comprobación lee la bandera guardada; no requiere que Social Revolution esté actualmente activado como módulo.

Abre la página "Integrity" del módulo para comprobar la configuración y los hooks. Licencia, Soporte y Actualizar son páginas de mantenimiento. Prueba los destinos reales tras cambiar los identificadores de cuenta o las fuentes del feed.

Establece Activar módulo en No y guarda para ocultar el feed conservando su configuración. Desinstala desde el gestor de módulos para eliminar la configuración, caché local y entradas del menú de administración de este módulo.