Configuración de Reel
La página Reel requiere la capacidad manage_woocommerce. Los ajustes se guardan en reel_settings, se validan antes de persistirlos y parten con zoom, lightbox y vídeo activados.
enable_zoom, activa la ampliación sobre las imágenes de producto.zoom_scale, escala entre 1,0 y 3,0, en pasos de 0,05. El valor inicial es 1,45.disable_zoom_on_touch, desactiva el zoom en dispositivos táctiles. Está activo de forma predeterminada para no competir con el desplazamiento y los gestos de la galería.
El script se carga cuando el zoom o el lightbox están activos. Si ambos están desactivados y no hay otra función interactiva que lo necesite, Reel no envía código innecesario.
Lightbox
Section titled “Lightbox”enable_lightbox, activa la apertura ampliada.show_backdrop_close, permite cerrar al pulsar el fondo. Está activo inicialmente.lightbox_caption, muestra el pie de foto. Está desactivado inicialmente.trigger_label, define la etiqueta accesible del control que abre el diálogo.
Escape, la trampa de foco y la devolución del foco no dependen del cierre por fondo. Son parte fija del comportamiento accesible.
Vídeo destacado
Section titled “Vídeo destacado”enable_video, activa la salida de vídeo.video_position, aceptaafter_galleryobefore_summary.video_autoplay, solicita reproducción automática. Está inactivo inicialmente.video_show_title, muestra el título resuelto. Está activo inicialmente.video_title, título global de respaldo.video_intro, texto introductorio global.
after_gallery usa woocommerce_product_thumbnails. before_summary usa woocommerce_before_single_product_summary. El marco reserva una proporción 16:9.
En una URL oEmbed, Reel añade el parámetro de autoplay cuando la opción está activa. El proveedor y el navegador pueden ignorarlo, especialmente si el vídeo intenta reproducir sonido.
Campos de producto
Section titled “Campos de producto”_reel_video_url, fuente del vídeo._reel_video_title, título opcional específico del producto.
El título específico tiene prioridad sobre el título global. Si ninguno contiene texto útil, Reel evita imprimir un encabezado vacío. Sin una URL válida, no genera el reproductor.
Archivos directos y oEmbed
Section titled “Archivos directos y oEmbed”Las extensiones directas admitidas son .mp4, .m4v, .webm y .ogv. Reel usa el reproductor de medios apropiado para esos archivos. Las demás URL pasan por el mecanismo oEmbed de WordPress, por lo que deben pertenecer a un proveedor compatible y ser públicamente accesibles.
Caché de la salida
Section titled “Caché de la salida”Reel guarda temporalmente el resultado del vídeo:
- una resolución correcta durante una hora;
- un resultado vacío durante cinco minutos.
La clave incluye el ID del producto, la URL y el estado de autoplay. Un cambio sólo en el encabezado o en la posición puede conservar el embed hasta que caduque el transitorio. Consulta las opciones de actualización en Uso.
Temas y CSS
Section titled “Temas y CSS”Reel no sustituye plantillas de WooCommerce. Usa los hooks de la galería y variables CSS, lo que reduce conflictos con actualizaciones. Un tema que elimine esos hooks puede colocar el vídeo mediante shortcode o bloque.
La edición gratuita no expone filtros o acciones públicos para reestructurar la salida. Para cambios visuales, usa CSS del tema hijo.
Desinstalación
Section titled “Desinstalación”La desinstalación elimina reel_settings y reel_db_version. Conserva _reel_video_url y _reel_video_title en los productos para no destruir contenido editorial. No modifica pedidos, clientes ni otros datos de WooCommerce.