URL-parameters
URL-parameters configureren een product vooraf wanneer de configurator laadt. Ze werken in beide methodes:
- iFrame insluiten
- Script-injectie (wanneer je geen niet-leeg
preConfig-object doorgeeft)
Basis-URL
https://configurator.iconfigure.io/?product=YOUR_PRODUCT_IDproductis de product-UUID uit Manager.
Dealerproducten
Dealer-insluitingen gebruiken dealer=<dealer_product_id> (gekopieerd uit Manager). Voorbeeld:
https://configurator.iconfigure.io/?dealer=YOUR_DEALER_PRODUCT_IDTaal
Gebruik lang om de content-taal te forceren:
https://configurator.iconfigure.io/?product=UUID&lang=de- Gebruik een taalcode in kleine letters die voor het bedrijf is gepubliceerd (
de,en,fr, …), oflang=autoom 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 zonderlang, 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
langin de adresbalk, zodat een gekopieerde link in dezelfde taal opent. - Bij script-injectie kan de taal ook via
injectAppworden doorgegeven; de?lang=-URL-parameter heeft altijd voorrang.
Samenstellingen
Gebruik pre_config om een opgeslagen samenstelling te openen:
https://configurator.iconfigure.io/?product=UUID&pre_config=SAMENSTELLING_IDDe 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:
https://configurator.iconfigure.io/?product=UUID&material=oak&width=120Featureparameters 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:
featureId=subIdA,subIdB,subIdCOpties die niet in de lijst staan, worden uitgezet.
Numerieke invoer
Gebruik de numerieke waarde als string:
width=120Gereserveerde parameters (geverifieerd)
Deze sleutels worden niet als feature-ID's behandeld:
product,product_iddealerquotationpre_configmode,logic,theme,perfactive_stepdev_url,poster,hide_visualizeritemslang
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
- Manager → Configuraties → open het product. De producteditor opent.
- Selecteer een feature in de structuurboom — het veld ID aan de rechterkant is de naam van de queryparameter.
- 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
- Producteditor — waar de feature-ID's vandaan komen
- Samenstellingen — een opgeslagen startconfiguratie, alternatief voor een lange URL
- iFrame insluiten
- Script-injectie