Viewer – Styles (paramètres d’URL)

Styles avec les paramètres d’URL

Les paramètres d’URL permettent de personnaliser l’apparence et le comportement de Viewer sans modifier le code. Ils peuvent être configurés directement dans l’application (par exemple dans l’onglet « Partager » ou dans Viewer) et permettent de contrôler le mode d’arrière-plan, les effets des images de fond, l’éclairage de l’environnement 3D, la visibilité de l’interface et celle du bouton Ajouter au panier. Présélection des variantes (attributs WooCommerce) : Vous pouvez également présélectionner une variante précise du produit à l’aide de paramètres de requête tels que attribute_pa_color, pa_size ou size. Ces paramètres sont interprétés à partir des associations d’attributs et de termes de votre boutique et permettent d’ouvrir Viewer avec une couleur, une taille, un matériau, une technique d’impression ou une couleur personnalisée déjà sélectionnés.

Liste des paramètres d’URL disponibles

ParamètreTypeDescriptionValeur par défaut
nav0 / 1Masque (0) ou affiche (1) la navigation. Disponible uniquement avec Business.1
add_to_cart0 / 1Masque (0) ou affiche (1) le bouton « Ajouter au panier ».0
bcgstringMode d’arrière-plan de la scène : grad_f6f7fb_e8fff6, app_img_123, uploaded, theme ou env.Valeur de la boutique/par défaut
envintIdentifiant de l’environnement HDRI utilisé pour éclairer la scène. Avec bcg=env, cet environnement sert également d’arrière-plan visible à la scène.1
light_intensity0 - 2Intensité lumineuse de la scène 3D.0.6
bcg_blur0 - 100Flou appliqué aux images de fond sélectionnées avec bcg=app_img_*, bcg=uploaded ou bcg=theme.0
bcg_brightness0 - 3Luminosité/niveau d’émission des images de fond.1
bcg_underlaystringSous-couche derrière les images de fond. Utilisez grad_ffffff_f5f7fb pour un dégradé ou none pour la supprimer.Valeur par défaut de l’arrière-plan
attribute_pa_*stringPrésélectionne un terme d’attribut de produit WooCommerce. Les clés acceptées comprennent attribute_pa_color, pa_color et color ; les alias pris en charge couvrent la taille, la couleur, le matériau, le type d’impression et le motif.
custom_color0 / 1 / trueDemande la variante à couleur personnalisée lorsque le produit la prend en charge. Le même résultat peut être obtenu avec color=custom.0
picked_colorsstringCouleurs personnalisées de remplacement, séparées par des virgules, au format detailKey:%23hex, par exemple front:%23ff6b6b,back:%2300ff88. Le caractère # doit être encodé dans l’URL sous la forme %23.

Exemple

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>