Skip to content

RepairDirect Widget v3 (preview) ​

De RepairDirect Widget v3 maakt het mogelijk om formulieren direct op je eigen website weer te geven, zonder dat je zelf formulieren hoeft te bouwen. De widget wordt ingeladen via een extern JavaScript-bestand en weergegeven binnen een HTML-element op de pagina.

Preview: Widget v3 is nog niet compleet en is alleen beschikbaar op de acceptatieomgeving voor testpagina's. Deze versie is niet beschikbaar op go of productie en is niet bedoeld voor livegebruik door klanten. Gebruik voor bestaande integraties de RepairDirect Widget v2.

Wat je kunt verwachten: de preview laadt je formulierconfiguratie en thema en wordt nog verder uitgebouwd. Nog niet alle vraagtypen worden getoond en het formulier kan nog niet worden verstuurd, dus gebruik het niet om echte schade te melden.

Hoe werkt het? ​

  1. Je plaatst een <script>-tag op de pagina die het JavaScript-bestand laadt vanaf onze CDN.
  2. Je voegt een <div> toe op de plek waar je de widget zichtbaar wilt maken.
  3. Het script initialiseert de widget automatisch binnen het opgegeven element.

Omgeving ​

  • Acceptatieomgeving: alleen voor testen en ontwikkeling.
  • CDN URL: https://cdn.rumbledirect.dev/repair/widget-v3/latest/index.js

Je ontvangt van ons de benodigde configuratiegegevens: clientIdentifier, formId en eventueel themeId. Gebruik gegevens voor de acceptatieomgeving.

Integreren in je pagina ​

1. Voeg het script toe ​

Plaats de volgende <script>-tag vlak vóór de sluitende </body>-tag van je HTML:

html
<script
  src="https://cdn.rumbledirect.dev/repair/widget-v3/latest/index.js"
  defer
></script>

2. Voeg de widget-container toe ​

Op de plek waar je de widget wilt tonen, voeg je dit <div>-element toe:

html
<div
  id="rumbledirect-widget"
  data-client-identifier="YOUR_CLIENT_IDENTIFIER"
  data-form-id="YOUR_FORM_ID"
  data-theme-id="YOUR_THEME_ID"
></div>

Vervang de voorbeeldwaarden door de gegevens die wij je toesturen. De id moet altijd rumbledirect-widget zijn. data-theme-id is optioneel; zonder dit attribuut gebruikt de widget het thema dat bij het formulier hoort.

Ondersteunde attributen ​

AttribuutGebruik
data-client-identifierInloggegevens die je van ons ontvangt. Gebruik dit attribuut of de twee losse attributen hieronder.
data-client-idClient-id, alleen in combinatie met data-client-secret als alternatief voor data-client-identifier.
data-client-secretClient-secret, alleen in combinatie met data-client-id.
data-form-idVerplicht: het formulier dat je wilt tonen.
data-theme-idOptioneel: het thema voor de vormgeving.

data-view-configuration-id, voorinvullen via data-prefill-data en de overige v2-attributen, waaronder data-service-partner-id, data-service-partner-collection-id en data-source, worden nog niet ondersteund. Voeg geen data-view-configuration-id toe: daarmee wordt de widget niet geladen, ook niet als data-form-id is ingesteld.

Vormgeving en thema's ​

Widget v3 wordt altijd in een Shadow DOM weergegeven. De CSS van je website lekt niet door naar de widget; je hoeft geen data-display-mode in te stellen. Dit attribuut wordt niet ondersteund.

De widget neemt het lettertype van je website over, tenzij het gekozen thema een eigen lettertype opgeeft. De widget volgt de donkere-modusvoorkeur van de bezoeker alleen als het thema een donker kleurenpalet bevat. Anders blijft het lichte kleurenpalet actief.

Via data-theme-id kun je zowel een v3-thema ("version": 3) als een bestaand SurveyJS-thema gebruiken. Bij bestaande SurveyJS-thema's worden de primaire kleur en de afronding van hoeken overgenomen.

Klaar om te testen? ​

Controleer de integratie op een testpagina met gegevens uit de acceptatieomgeving. Houd er rekening mee dat deze preview nog niet alle functies van v2 ondersteunt.

Heb je vragen of loop je ergens tegenaan? Mail ons op [email protected].