DataFirefly Product Video

Presentación

DataFirefly Product Video añade vídeos directamente en la galería de miniaturas de la ficha de producto de PrestaShop, junto a las imágenes. Se admiten tres fuentes: archivos alojados (MP4, WebM, OGG), YouTube y Vimeo. Cada vídeo dispone de su propio póster, de sus opciones de reproducción y de una posición personalizable.

• Compatibilidad: PrestaShop 8.0 a 8.9
• Multitienda: sí
• Multilingüe: título y descripción traducibles por idioma
• Versión: 1.0.0

Instalación

1. En el back-office, ve a Módulos > Gestor de módulos.
2. Haz clic en Subir un módulo y selecciona el archivo dfproductvideo.zip.
3. El módulo crea automáticamente sus tablas y las carpetas de subida (img/dfproductvideo/videos e img/dfproductvideo/posters).
4. Haz clic en Configurar para definir los ajustes por defecto.

Configuración global

La página de configuración define los valores aplicados por defecto a cada nuevo vídeo:

• Reproducción automática – reproducción automática (Chrome y Safari exigen el modo silenciado).
• Silenciado – obligatorio si la reproducción automática está activada.
• Bucle – reproduce el vídeo de forma continua.
• Mostrar controles – barra de reproducción nativa.
• Carga diferida (lazy load) – carga el vídeo solo cuando se hace visible.
• Lightbox / Pantalla completa – abre el vídeo en una superposición.
• Adaptable (responsive) – se adapta al ancho de la pantalla.
• Analítica – cuenta el número de reproducciones por vídeo.
• Tamaño máx. de archivo (MB) – límite de subida, 50 MB por defecto.
• Extensiones permitidas – por defecto mp4,webm,ogg.
• Color y fondo del icono de reproducción – personalización del botón de reproducción.

Añadir un vídeo a un producto

1. Abre una ficha de producto en el back-office.
2. Ve a la pestaña Vídeos añadida por el módulo.
3. Elige la fuente: archivo a subir, enlace de YouTube o enlace de Vimeo.
4. Si lo necesitas, indica un póster (imagen de portada) y un título / descripción por idioma.
5. Ajusta las opciones de reproducción (automática, silenciado, bucle, controles) si difieren de los valores por defecto.
6. Guarda. El vídeo aparece en la galería del producto.

Los vídeos se pueden reordenar arrastrando y soltando, activar o desactivar, y uno de ellos se puede designar como vídeo de portada (solo uno por producto y por tienda).

Pósteres automáticos

Si no se proporciona ningún póster, el módulo genera automáticamente una imagen de vista previa: la miniatura de YouTube (hqdefault) para los vídeos de YouTube, y la miniatura de Vimeo para los vídeos de Vimeo. Para los archivos subidos, se recomienda proporcionar un póster manualmente.

Visualización en el front-office

Los vídeos se insertan en la galería de miniaturas de la ficha de producto, justo después de las imágenes. Al hacer clic, el vídeo se reproduce en su lugar o se abre en un lightbox según la configuración. Los vídeos subidos utilizan el reproductor HTML5 nativo; YouTube y Vimeo se integran mediante su reproductor oficial con los parámetros correspondientes a las opciones elegidas (reproducción automática, silenciado, bucle, controles).

Analítica

Cuando la opción de analítica está activa, cada reproducción incrementa un contador (play_count) almacenado en la base de datos. Esto permite medir la interacción con el vídeo por producto.

Desinstalación

La desinstalación elimina las tablas del módulo y sus ajustes. Los archivos de vídeo y los pósteres asociados a los productos también se eliminan.

Detalles técnicos

• Tablas: dfproductvideo (vídeos y opciones) y dfproductvideo_lang (título / descripción traducidos).
• Hooks utilizados: displayAdminProductsExtra, displayAfterProductThumbs, actionFrontControllerSetMedia, actionProductUpdate, actionProductDelete, displayBackOfficeHeader.
• Gestión de los vídeos mediante un controlador AJAX (guardar, eliminar, reordenar, activar).
• Seguimiento de reproducciones mediante un controlador front dedicado.