Ubicación en la galería de imágenes
Muestra miniaturas de vídeo junto a las imágenes del producto para que los clientes puedan ver un vídeo del mismo modo que hojean las fotos del producto.
Disponible desde v3.0.0
Descripción general
La ubicación en la galería de imágenes inserta cada vídeo del producto como miniatura directamente dentro de la galería de imágenes del producto, junto a las fotos habituales. Al hacer clic (o pasar el cursor) sobre una miniatura de vídeo, la imagen principal del producto se sustituye por un reproductor de vídeo integrado. Cuando el cliente hace clic en la miniatura de una foto normal, el reproductor se cierra y la imagen seleccionada ocupa su lugar.
Este es el punto de integración más natural para la mayoría de los temas. Los clientes no necesitan desplazarse hacia abajo ni buscar una sección aparte: el vídeo está directamente en la tira de imágenes. Combinado con la opción Vídeo como portada, puedes hacer que el vídeo se reproduzca automáticamente en el momento en que alguien llega a la página del producto.
Todos los ajustes de esta sección son independientes de las demás ubicaciones de visualización (Panel lateral, Pestañas, Listados de productos). Puedes activar cualquier combinación de ubicaciones simultáneamente.
Configuración
- Ve a Módulos > Gestor de módulos, busca Product Video y haz clic en Configurar.
- Abre la pestaña Galería de imágenes.
Visualización
| Ajuste | Valores | Por defecto | Descripción |
|---|---|---|---|
| Mostrar vídeo junto a las imágenes | Activado / Desactivado | Activado | Interruptor principal para esta ubicación. Cuando está desactivado, no aparece ninguna miniatura de vídeo en la galería de imágenes, independientemente de los demás ajustes. |
| Mostrar en | Todos los dispositivos / Solo escritorio / Solo móvil y tableta | Todos los dispositivos | Limita esta ubicación a un tipo de dispositivo concreto. Útil si tu tema se renderiza de forma diferente en móvil y la galería se rompe en pantallas pequeñas. |
Vídeo como portada
| Ajuste | Valores | Por defecto | Descripción |
|---|---|---|---|
Usar vídeo como imagen por defecto (Vídeo como portada) (PV_DEFAULT) | Activado / Desactivado | Activado | Activa automáticamente el primer vídeo cuando se carga la página del producto, sustituyendo la foto principal del producto por el reproductor de vídeo. El cliente no necesita hacer ningún clic. |
Establecer el vídeo por defecto solo una vez (PV_DEFAULT_ONCE) | Activado / Desactivado | Desactivado | Cuando está activado, el vídeo de portada se establece únicamente en la primera carga. Cambiar una combinación o actualizar la página no vuelve a activar la portada de vídeo. Útil cuando quieres que la primera impresión sea el vídeo, pero no deseas que se reinicie cada vez que el cliente cambia una talla o un color. |
Activar Vídeo como portada junto con Reproducción automática (configurada por proveedor en las secciones de YouTube, Vimeo o HTML5) crea una página de producto estilo cine: el vídeo empieza a reproducirse automáticamente en el momento en que se abre la página.
Posición de las miniaturas
| Ajuste | Valores | Por defecto | Descripción |
|---|---|---|---|
Posición de las miniaturas (PV_THUMB_POS) | Antes / Después / Personalizada | Antes | Dónde se insertan las miniaturas de vídeo en la tira de imágenes. Antes las coloca delante de todas las fotos del producto; Después las añade al final; Personalizada permite especificar un número de posición exacto. |
Posición personalizada de miniaturas (PV_THUMB_POS_CUSTOM) | 1, 2, 3… | 1 | Solo visible cuando se selecciona Personalizada arriba. 1 = primera posición, 2 = segunda posición, etc. Si el producto tiene menos imágenes que el número introducido, el vídeo se coloca al final. |
Número máximo de vídeos a mostrar (PV_LIMIT) | 0 (todos), o un entero positivo | 0 | Limita cuántas miniaturas de vídeo aparecen en la galería. Establécelo en 0 para mostrar todos los vídeos. Establécelo en 1 o 2 para evitar que la galería se desborde cuando un producto tiene muchos vídeos. |
Permitir repetición de vídeo (PV_IMG_REPEAT) | Activado / Desactivado | Activado | Cuando hay un límite de vídeos activo, controla si la misma URL de vídeo puede aparecer también en otras ubicaciones (Panel lateral, Pestañas). Desactívalo para asegurarte de que el mismo vídeo no aparezca en dos lugares de la misma página. |
Apariencia de las miniaturas
| Ajuste | Valores | Por defecto | Descripción |
|---|---|---|---|
Tamaño personalizado de miniaturas (PV_CUST_THUMB_TYPE) | Cualquier tipo de imagen definido en tu tema (p. ej. cart, small_default) | cart | El preset de tamaño de imagen que usa el módulo para los fotogramas de las miniaturas de vídeo. Hazlo coincidir con el que usa tu tema para las miniaturas de la galería y así garantizar un tamaño uniforme. |
Usar JS para forzar el tamaño de las miniaturas (PV_FORCE_THUMB_SIZE) | Activado / Desactivado | Desactivado | Fuerza que todas las miniaturas de vídeo coincidan con las dimensiones exactas en píxeles de las miniaturas de imagen adyacentes mediante JavaScript. Actívalo si las miniaturas de vídeo aparecen más grandes o más pequeñas que las de las imágenes del producto. |
Tamaño de imagen del producto (PV_IMG_SIZE) | Cualquier tipo de imagen del tema, o en blanco para el valor por defecto del tema | En blanco (valor por defecto del tema) | El preset de tamaño de imagen utilizado para el área de imagen principal del producto donde el vídeo sustituye a la portada. Hazlo coincidir con el tamaño de imagen principal del producto en tu tema. Déjalo en blanco salvo que tengas problemas de tamaño. |
Activación de las miniaturas
| Ajuste | Valores | Por defecto | Descripción |
|---|---|---|---|
Comportamiento de las miniaturas — Escritorio (PV_DESKT_BV) | Al pasar el cursor / Al hacer clic | Al pasar el cursor (PS 1.7+), Al hacer clic (PS 1.6) | Si el vídeo se carga cuando el cliente pasa el cursor sobre la miniatura o solo cuando hace clic. Establécelo en Al pasar el cursor si tu tema activa las imágenes del producto al pasar el cursor; establécelo en Al hacer clic si tu tema requiere un clic. |
Comportamiento de las miniaturas — Móvil / Tableta (PV_MOBILE_BV) | Al pasar el cursor / Al hacer clic | Al hacer clic | Igual que el anterior, pero para pantallas táctiles. En dispositivos táctiles, los eventos de hover no son fiables, por lo que Al hacer clic es casi siempre la opción correcta. |
Cómo funciona
Cuando un cliente abre una página de producto:
- El módulo inserta las miniaturas de vídeo en la tira de la galería junto a las fotos existentes del producto.
- Cada miniatura muestra un fotograma fijo extraído de YouTube o Vimeo (o una miniatura personalizada para vídeos HTML5) con un icono de reproducción superpuesto.
- Cuando el cliente pasa el cursor o hace clic sobre una miniatura de vídeo —según el ajuste de Comportamiento de las miniaturas— la imagen principal del producto se sustituye por un reproductor de vídeo integrado.
- Si Vídeo como portada está activado, el primer vídeo se carga automáticamente sin ninguna interacción.
- Cuando el cliente hace clic en una miniatura de imagen diferente, el reproductor se elimina y la imagen seleccionada se muestra con normalidad.
El flujo de la galería resulta idéntico al de cambiar entre fotos del producto: el vídeo es simplemente otra miniatura en la tira.
Cambios de combinación
Cuando un cliente cambia la combinación de un producto (por ejemplo, seleccionando un color o una talla diferente), PrestaShop recarga la galería de imágenes mediante AJAX. El módulo detecta esta actualización y vuelve a insertar las miniaturas de vídeo correctas para la combinación recién seleccionada. Si los vídeos están asignados por combinación, solo aparecen los vídeos de esa combinación.
Si las miniaturas de vídeo desaparecen después de que un cliente cambie una combinación, aumenta el Tiempo de espera de actualización por AJAX / cambio de combinación en la sección de Compatibilidad con el tema de la configuración del módulo.
Vídeo como portada con combinaciones
Si Vídeo como portada está activado y Establecer el vídeo por defecto solo una vez está desactivado, el primer vídeo de la combinación recién seleccionada se activa automáticamente después de cada cambio de combinación. Activa Establecer el vídeo por defecto solo una vez para evitar este reactivado cuando quieras que el vídeo se reproduzca únicamente en la carga inicial de la página.
Ejemplos de uso
Ejemplo: Página de producto que empieza con vídeo
Vendes un electrodoméstico de cocina y quieres que el vídeo de demostración sea lo primero que vean los clientes. Activa Vídeo como portada y establece la Reproducción automática en activo en la configuración de YouTube. El vídeo empieza a reproducirse en silencio (o con sonido, según tu configuración de reproducción automática) en el momento en que se carga la página: sin desplazamiento, sin clic.
Ejemplo: Varios vídeos sin saturar la galería
Un producto tiene cinco vídeos (unboxing, tutorial, tres variantes de color). Establece Número máximo de vídeos a mostrar en 2 para que solo aparezcan los dos vídeos más importantes en la galería. Los tres restantes siguen siendo accesibles a través del Panel lateral o las Pestañas si esas ubicaciones están activadas.
Ejemplo: Galería solo con clic para adaptarse a un tema boutique
Tu tema activa las imágenes del producto solo al hacer clic (habitual en temas de moda y lujo). Establece Comportamiento de las miniaturas — Escritorio en Al hacer clic en la miniatura. Las miniaturas de vídeo se comportan entonces exactamente igual que las miniaturas de imagen normales, manteniendo una experiencia coherente.
Notas importantes
- Multishop: todos los ajustes de Galería de imágenes son por tienda. Configura cada tienda por separado mediante el selector de tienda en el encabezado del Back Office antes de abrir la configuración del módulo.
- La posición Personalizada de las miniaturas depende de que el marcado de la galería coincida con lo que el módulo espera. Si tu tema utiliza una estructura de galería no estándar, Antes o Después son opciones más fiables.
- La función Vídeo como portada requiere que el área de imagen principal de tu tema sea identificable mediante los selectores CSS definidos en Compatibilidad con el tema. Si el vídeo de portada no se carga automáticamente, comprueba primero esos selectores.
- Los presets de tamaño de imagen (p. ej.
cart,small_default) están definidos por PrestaShop y tu tema. Puedes ver los tamaños disponibles en Diseño > Ajustes de imagen en el Back Office. - En PS 1.6, Comportamiento de las miniaturas — Escritorio tiene como valor por defecto Al hacer clic porque los scripts de galería de PS 1.6 gestionan los eventos del ratón de forma diferente.
Solución de problemas
| Problema | Solución |
|---|---|
| La miniatura de vídeo aparece mucho más grande o más pequeña que las fotos del producto | Cambia Tamaño personalizado de miniaturas al tipo de imagen que tu tema usa realmente para las miniaturas de la galería (a menudo small_default en temas PS 1.7+). Activa Usar JS para forzar el tamaño de las miniaturas como alternativa. |
| El vídeo no se carga automáticamente al abrir la página | Verifica que Usar vídeo como imagen por defecto está activado. Luego comprueba Compatibilidad con el tema para confirmar que el selector CSS del contenedor de la imagen principal del producto es correcto. |
| El vídeo se reinicia cada vez que el cliente cambia una combinación | Activa Establecer el vídeo por defecto solo una vez para evitar que el vídeo de portada se reactive en cada cambio de combinación. |
| La miniatura de vídeo aparece en la posición incorrecta | Establece Posición de las miniaturas en Personalizada e introduce el número de posición exacto. Si la posición sigue siendo incorrecta, es posible que tu tema no admita posicionamiento personalizado: cambia a Antes o Después. |
| Demasiadas miniaturas en la galería | Establece Número máximo de vídeos a mostrar en 1 o 2 para limitar cuántas aparecen. |
| El vídeo desaparece después de un cambio de combinación | Aumenta el Tiempo de espera de actualización por AJAX / cambio de combinación en la sección de Compatibilidad con el tema para que el módulo espere más antes de volver a insertar las miniaturas tras la recarga de la galería. |
| El mismo vídeo aparece tanto en la galería como en el panel lateral | Desactiva Permitir repetición de vídeo para evitar que la misma URL aparezca en varias ubicaciones simultáneamente. |
Preguntas frecuentes
Si activo Vídeo como portada, ¿se reproducirá automáticamente el vídeo para todos los visitantes, incluidos los de móvil?
Vídeo como portada carga el reproductor y activa el primer vídeo, pero que el vídeo se reproduzca automáticamente (sin hacer clic) depende del ajuste de Reproducción automática en las secciones de YouTube, Vimeo o HTML5, y del navegador del visitante. La mayoría de navegadores bloquean la reproducción automática con sonido en móvil; la reproducción automática silenciada suele funcionar.
¿Puedo mostrar una miniatura de vídeo diferente según la combinación de producto seleccionada?
Sí. Asigna vídeos a combinaciones específicas en la página de edición del producto. Cuando un cliente selecciona esa combinación, el módulo sustituye los vídeos por los asignados a ella. La miniatura de la galería de la combinación anterior se elimina y aparece la nueva.
¿El límite de vídeos configurado aquí también limita los vídeos que se muestran en el Panel lateral o las Pestañas?
No. El límite de Número máximo de vídeos a mostrar se aplica únicamente a la ubicación de Galería de imágenes. El Panel lateral y las Pestañas tienen sus propios ajustes de visualización. El selector Permitir repetición de vídeo controla si la misma URL de vídeo puede aparecer en varias ubicaciones, no cuántos vídeos muestra cada ubicación.
¿Qué ocurre si establezco la Posición personalizada de miniaturas en 3 pero el producto solo tiene una imagen?
La miniatura de vídeo se coloca al final de la galería (después de la única imagen del producto), ya que no hay suficientes imágenes para llegar a la posición 3.
¿Funciona esta ubicación en las páginas de listado de productos (páginas de categoría)?
No. La ubicación en Galería de imágenes es solo para la página de detalle del producto. Para las páginas de categoría, utiliza la función independiente de Listados de productos.
Mi tema muestra las miniaturas debajo de la imagen principal. ¿Aparecerán los vídeos ahí o en otro lugar?
El módulo inyecta las miniaturas en el contenedor de miniaturas que usa tu tema. Si los vídeos aparecen en la ubicación incorrecta, ajusta el selector del contenedor de miniaturas en la sección de Compatibilidad con el tema para que el módulo apunte al elemento correcto.
Funciones relacionadas
- Panel lateral — Muestra los vídeos en una columna junto a la descripción del producto en lugar de en la galería de imágenes
- Pestañas y descripción — Muestra un reproductor de vídeo a pantalla completa bajo los detalles del producto en una pestaña dedicada
- Listados de productos — Añade iconos de vídeo o reproductores en línea en las páginas de categoría y resultados de búsqueda
- Compatibilidad con el tema — Configura los selectores CSS para el contenedor de la imagen, el contenedor de miniaturas y el tiempo de espera por cambio de combinaci ón