Skip to content

URL-parameters ​

URL-parameters configureren een product vooraf wanneer de configurator laadt. Ze werken in beide methodes:

Basis-URL ​

text
https://configurator.iconfigure.io/?product=YOUR_PRODUCT_ID
  • product is de product-UUID uit Manager.

Dealerproducten ​

Dealer-insluitingen gebruiken dealer=<dealer_product_id> (gekopieerd uit Manager). Voorbeeld:

text
https://configurator.iconfigure.io/?dealer=YOUR_DEALER_PRODUCT_ID

Taal ​

Gebruik lang om de content-taal te forceren:

text
https://configurator.iconfigure.io/?product=UUID&lang=de
  • Gebruik een taalcode in kleine letters die voor het bedrijf is gepubliceerd (de, en, fr, …), of lang=auto om de browsertaal van de bezoeker te detecteren.
  • De waarde wordt gecontroleerd tegen de gepubliceerde talen van het bedrijf. Een code die niet is gepubliceerd valt niet terug op de standaardtaal: de configurator toont dan in plaats van het product de melding Voor deze configurator is geen taal ingesteld. (in de standaardtaal van het bedrijf).
  • Met lang=auto, of zonder lang, wordt de standaardtaal van het bedrijf gebruikt wanneer de taal van de bezoeker niet is gepubliceerd.
  • Bij bedrijven met meer dan één gepubliceerde taal zet de configurator de gekozen lang in de adresbalk, zodat een gekopieerde link in dezelfde taal opent.
  • Bij script-injectie kan de taal ook via injectApp worden doorgegeven; de ?lang=-URL-parameter heeft altijd voorrang.

Samenstellingen ​

Gebruik pre_config om een opgeslagen samenstelling te openen:

text
https://configurator.iconfigure.io/?product=UUID&pre_config=SAMENSTELLING_ID

De knop Volledige URL bij een samenstelling geeft je deze URL (met dealer= bij dealerproducten). Wanneer pre_config geladen wordt, worden featureparameters in dezelfde URL genegeerd.

Featureparameters ​

Elke configureerbare feature heeft een ID die in de Product Editor is ingesteld (bijv. material, width, hoogte_sparing). Geef het feature-ID door als sleutel.

Voorbeelden:

text
https://configurator.iconfigure.io/?product=UUID&material=oak&width=120

Featureparameters worden toegepast bovenop de startconfiguratie van het product. Een optie-ID dat niet bij de feature bestaat, wordt genegeerd.

Enkele selectie ​

featureId=subfeatureId

Meervoudige selectie ​

Gebruik een door komma's gescheiden lijst:

text
featureId=subIdA,subIdB,subIdC

Opties die niet in de lijst staan, worden uitgezet.

Numerieke invoer ​

Gebruik de numerieke waarde als string:

text
width=120

Gereserveerde parameters (geverifieerd) ​

Deze sleutels worden niet als feature-ID's behandeld:

  • product, product_id
  • dealer
  • quotation
  • pre_config
  • mode, logic, theme, perf
  • active_step
  • dev_url, poster, hide_visualizer
  • items
  • lang

active_step

active_step zit in de URL-generator, maar wordt in de huidige code niet toegepast bij het laden. Vertrouw er niet op voor deep-linking.

Feature-ID's vinden ​

  1. Manager → Configuraties → open het product. De producteditor opent.
  2. Selecteer een feature in de structuurboom — het veld ID aan de rechterkant is de naam van de queryparameter.
  3. Gebruik bij een selectie het ID van de optie (subfeature) als waarde.

Zie Producteditor voor hoe stappen, features en opties zich tot elkaar verhouden.

Verder lezen ​