logo

Bokningswidget — teknisk implementering

Med Muntras bokningswidget kan patienter boka tider direkt från klinikens hemsida. Widgeten visas antingen som en knapp som öppnar ett bokningsfönster, eller som ett inbäddat formulär direkt på sidan.



Förutsättningar


Klinikens domän måste vitlistas av Muntra innan widgeten fungerar. Kontakta Muntras support och ange exakt vilken domän widgeten ska användas på.



Installation


Widgeten kräver två saker: ett <div>-element där widgeten ska synas, och ett <script>-element som laddar widgetens kod.



Komplett exempel


<body>
<!-- Placera div-elementet där widgeten ska visas -->
<div
class="muntra-widget"
key="0"
muntra_clinic_id="DIN_KLINIK_ID"
muntra_referral_source="dinklinik.se"
></div>

<!-- Skriptet ska placeras precis före </body> -->
<script type="text/javascript" src="https://muntra-dev.github.io/index.js"></script>
</body>


Attribut


Ange attributen direkt på <div>-elementet.



AttributObligatorisktBeskrivning
classJaMåste innehålla muntra-widget. Lägg till primary, secondary eller without-modal för att underlätta CSS-styling av enskilda widgetar.
keyJaUnikt ID per widget på sidan (t.ex. 0, 1, 2). Krävs om du har flera widgetar på samma sida.
muntra_clinic_idJaKlinikens ID i Muntra.
muntra_referral_sourceNejDomännamnet som bokningskällan ska registreras under (t.ex. dinklinik.se). Används för spårning.
muntra_caregiver_idNejVisar enbart en specifik behandlare.
muntra_role_idNejFiltrerar behandlare efter roll (t.ex. tandläkare, tandhygienist).
muntra_procedure_idNejFörväljer en behandling i bokningsflödet.
muntra_button_textNejAnpassad text på bokningsknappen. Standard: Boka tid.
muntra_without_modalNejSätt till true för att visa widgeten direkt på sidan, utan knapp och utan popup-fönster.
show_caregiverNejSätt till false för att dölja behandlarval i widgeten.
muntra_localeNejSpråk för widgeten (t.ex. nb-no för norska). Standard: klinikens språk.
goal_page_urlNejWebbadress dit patienten skickas efter en genomförd bokning.


Flera widgetar på samma sida


Du kan placera flera widgetar på samma sida. Ge varje widget ett unikt key-värde och kombinera attribut för att visa olika behandlare, roller eller behandlingar.



<!-- Widget för tandläkare -->
<div class="muntra-widget" key="0"
muntra_clinic_id="DIN_KLINIK_ID"
muntra_role_id="3"
muntra_button_text="Boka tandläkartid"></div>

<!-- Widget för tandhygienist -->
<div class="muntra-widget" key="1"
muntra_clinic_id="DIN_KLINIK_ID"
muntra_role_id="4"
muntra_button_text="Boka tandhygienist"></div>

<script type="text/javascript" src="https://muntra-dev.github.io/index.js"></script>


Ombokning och bekräftelse


När en patient bokar via widgeten skickas ett mejl med en länk i formatet:


https://www.dinklinik.se?m_id=XXXXXXXXXX

Om den länken leder till en sida med bokningswidgeten visas bokningsuppgifter med knappar för bekräftelse och ombokning. (Huruvida ombokning är tillåten styrs av klinikens bokningsinställningar i Muntra.)



CSS-styling


Knappens utseende anpassas via CSS-klassen .muntra-widget-button:


.muntra-widget-button {
border-radius: 100px;
color: #ffffff;
font-size: 18px;
font-weight: 700;
}


Använd de extra klasserna på <div>-elementet (t.ex. secondary) för att styla enskilda knappar:


.secondary .muntra-widget-button {
background-color: #fff;
border-color: #52a8ff;
color: #52a8ff;
}


Widgetfönstret (när muntra_without_modal="true") stylas via .muntra-widget:


.muntra-widget.without-modal {
width: 100%;
max-width: 720px;
height: 500px;
border: 1px solid lightgrey;
border-radius: 15px;
}


Felsökning



  1. Kontrollera muntra_clinic_id — är det rätt klinik-ID?

  2. Kontrollera muntra_referral_source — matchar det exakt det domännamn som är vitlistat?

  3. Kontrollera skriptets placering<script>-taggen måste stå efter alla <div>-element, helst precis före </body>.

  4. Kontrollera att widgeten inte ligger i en iframe — widgeten fungerar inte inuti en <iframe>.

  5. Testar du på en annan domän? — om du utvecklar på en testmiljö med annat domännamn än den publicerade hemsidan, måste även testdomänen vitlistas.



Hitta vitlistningsfel



  1. Öppna hemsidan där widgeten är placerad.

  2. Högerklicka och välj Inspektera (Inspect på engelska).

  3. Gå till fliken Console (Konsol).

  4. Leta efter ett rött felmeddelande som nämner CORS och notera webbadressen efter ordet origin.

  5. Skicka webbadressen till Muntras support tillsammans med uppgift om vilken widget det gäller.



Kontrollera om widgeten ligger i en iframe



  1. Högerklicka och välj Inspektera (Inspect).

  2. Gå till fliken Elements (Element).

  3. Tryck Ctrl+F (eller Cmd+F på Mac) och sök efter muntra.

  4. Kontrollera om widgetens <div> ligger inuti ett <iframe>-element.

  5. Om ja: ta bort <iframe>-taggen och ersätt den med en vanlig <div>.