Viewer – Stile (parametri URL)

Stile con parametri URL

I parametri URL permettono di personalizzare l'aspetto e il comportamento del Viewer senza modificare il codice. I parametri possono essere configurati direttamente nell'app, ad esempio nella scheda Condividi o nel Viewer, e controllano modalità dello sfondo, effetti delle immagini di sfondo, illuminazione dell'ambiente 3D, visibilità dell'interfaccia e di Aggiungi al carrello. Preselezione delle varianti (attributi WooCommerce): Puoi anche preselezionare una variante di prodotto con parametri come attribute_pa_color, pa_size o size. Questi parametri usano la mappatura degli attributi e dei termini del negozio e permettono di aprire il Viewer con un colore, una taglia, un materiale, un metodo di stampa o un colore personalizzato già selezionati.

Elenco dei parametri URL disponibili

ParametroTipoDescrizioneValore predefinito
nav0 / 1Nasconde (0) o mostra (1) la navigazione. Disponibile solo in Business.1
add_to_cart0 / 1Nasconde (0) o mostra (1) il pulsante “Aggiungi al carrello”.0
bcgstringModalità dello sfondo della scena: grad_f6f7fb_e8fff6, app_img_123, uploaded, theme o env.Negozio/predefinito
envintID dell'ambiente HDRI usato per illuminare la scena. Con bcg=env, l'ambiente viene usato anche come sfondo visibile della scena.1
light_intensity0 - 2Intensità della luce della scena 3D.0.6
bcg_blur0 - 100Sfocatura applicata alle immagini di sfondo selezionate con bcg=app_img_*, bcg=uploaded o bcg=theme.0
bcg_brightness0 - 3Luminosità/livello emissivo delle immagini di sfondo.1
bcg_underlaystringSfondo sottostante alle immagini. Usa grad_ffffff_f5f7fb per una sfumatura o none per rimuoverlo.Predefinito dello sfondo
attribute_pa_*stringPreseleziona un termine di attributo di prodotto WooCommerce. Le chiavi accettate includono attribute_pa_color, pa_color e color; gli alias supportati includono taglia, colore, materiale, tipo di stampa e motivo.
custom_color0 / 1 / trueRichiede la variante di colore personalizzato quando il prodotto la supporta. Si può attivare anche con color=custom.0
picked_colorsstringSovrascritture dei colori personalizzati separate da virgole nel formato detailKey:%23hex, ad esempio front:%23ff6b6b,back:%2300ff88. Il carattere # deve essere codificato nell'URL come %23.

Esempio

URL: https://alterproduct.com/app/viewer/1?bcg=grad_f6f7fb_e8fff6&env=8&light_intensity=1.2&bcg_underlay=none&add_to_cart=1&nav=0&attribute_pa_color=white&attribute_pa_size=m

<iframe
  loading="lazy"
  title="Product Viewer"
  src="https://alterproduct.com/app/viewer/1?bcg=grad_f6f7fb_e8fff6&env=8&light_intensity=1.2&bcg_underlay=none&add_to_cart=1&nav=0&attribute_pa_color=white&attribute_pa_size=m"
  width="100%"
  height="100%"
  frameBorder="0"
  allowFullScreen
></iframe>