Estilo com parâmetros de URL
Os parâmetros de URL permitem personalizar a aparência e o comportamento do Viewer sem alterar o código.
Eles podem ser configurados diretamente na aplicação, por exemplo no separador Partilhar ou dentro do Viewer, e controlam o modo de fundo, efeitos da imagem de fundo, iluminação do ambiente 3D, visibilidade da interface e de Adicionar ao carrinho.
Pré-seleção de variantes (atributos WooCommerce):
Também pode pré-selecionar uma variante do produto com parâmetros como attribute_pa_color, pa_size ou size. Esses parâmetros usam o mapeamento de atributos e termos da loja para abrir o Viewer com uma cor, tamanho, material, método de impressão ou cor personalizada já selecionados.
Lista de parâmetros de URL disponíveis
| Parâmetro | Tipo | Descrição | Valor predefinido |
|---|---|---|---|
nav | 0 / 1 | Oculta (0) ou exibe (1) a navegação. Disponível apenas no Business. | 1 |
add_to_cart | 0 / 1 | Oculta (0) ou exibe (1) o botão Adicionar ao carrinho. | 0 |
bcg | string | Modo de fundo da cena: grad_f6f7fb_e8fff6, app_img_123, uploaded, theme ou env. | Loja/predefinido |
env | int | ID do ambiente HDRI usado na iluminação da cena. Com bcg=env, o ambiente também aparece como fundo da cena. | 1 |
light_intensity | 0 - 2 | Intensidade da luz da cena 3D. | 0.6 |
bcg_blur | 0 - 100 | Desfoque aplicado às imagens de fundo selecionadas com bcg=app_img_*, bcg=uploaded ou bcg=theme. | 0 |
bcg_brightness | 0 - 3 | Nível de brilho/emissão das imagens de fundo. | 1 |
bcg_underlay | string | Base atrás das imagens de fundo. Use grad_ffffff_f5f7fb para um gradiente ou none para removê-la. | Predefinição do fundo |
attribute_pa_* | string | Pré-seleciona um termo de atributo de produto WooCommerce. Aceita chaves como attribute_pa_color, pa_color e color, com aliases para tamanho, cor, material, tipo de impressão e padrão. | |
custom_color | 0 / 1 / true | Solicita a variante de cor personalizada, quando o produto oferece essa opção. Também pode ser ativada com color=custom. | 0 |
picked_colors | string | Cores personalizadas separadas por vírgulas no formato detailKey:%23hex, por exemplo front:%23ff6b6b,back:%2300ff88. O caractere # deve ser codificado na URL como %23. |