Estilo mediante parámetros de URL
Los parámetros de URL permiten personalizar el aspecto y el comportamiento de Viewer sin modificar el código.
Puedes configurarlos directamente en la aplicación (por ejemplo, en la pestaña «Compartir» o dentro de Viewer) para controlar el modo de fondo, los efectos del fondo de imagen, la iluminación del entorno 3D, la visibilidad de la interfaz y la del botón Añadir al carrito.
Preselección de variantes (atributos de WooCommerce):
También puedes preseleccionar una variante concreta con parámetros como attribute_pa_color, pa_size o size. Estos parámetros se resuelven mediante la asignación de atributos y términos de tu tienda y permiten abrir Viewer con un color, talla, material, método de impresión o color personalizado ya seleccionado.
Lista de parámetros de URL disponibles
| Parámetro | Tipo | Descripción | Valor predeterminado |
|---|---|---|---|
nav | 0 / 1 | Oculta (0) o muestra (1) la navegación. Disponible solo en Business. | 1 |
add_to_cart | 0 / 1 | Oculta (0) o muestra (1) el botón «Añadir al carrito». | 0 |
bcg | string | Modo de fondo de la escena: grad_f6f7fb_e8fff6, app_img_123, uploaded, theme o env. | Tienda/predeterminado |
env | int | ID del entorno HDRI utilizado para iluminar la escena. Cuando bcg=env, el entorno también se utiliza como fondo visible de la escena. | 1 |
light_intensity | 0 - 2 | Intensidad de la iluminación de la escena 3D. | 0.6 |
bcg_blur | 0 - 100 | Desenfoque aplicado a los fondos de imagen seleccionados con bcg=app_img_*, bcg=uploaded o bcg=theme. | 0 |
bcg_brightness | 0 - 3 | Nivel de brillo/emisión de los fondos de imagen. | 1 |
bcg_underlay | string | Capa situada detrás de los fondos de imagen. Usa grad_ffffff_f5f7fb para un degradado o none para quitarla. | Predeterminado del fondo |
attribute_pa_* | string | Preselecciona un término de atributo de producto de WooCommerce. Se aceptan claves como attribute_pa_color, pa_color y color; los alias admitidos incluyen talla, color, material, tipo de impresión y patrón. | |
custom_color | 0 / 1 / true | Solicita la variante de color personalizado si el producto la admite. También se puede activar con color=custom. | 0 |
picked_colors | string | Valores de colores personalizados separados por comas con el formato detailKey:%23hex, por ejemplo front:%23ff6b6b,back:%2300ff88. El carácter # debe codificarse en la URL como %23. |