Søgeord: badetemperatur, vandtemperatur, lufttemperatur, temperatur-widget, holdstyring-temperature, latitude, longitude, koordinater, Open-Meteo, Thermit, water temperature, embed
Web Components til at indlejre live Holdstyring-data (hold, booking, priser, instruktører, blog m.m.) på ekstern hjemmeside (WordPress, Wix, Squarespace, Webflow, statisk HTML).
Kernebegreber
- Badetemperatur: vand- og lufttemperatur MÅLES, den skrives aldrig ind. Kilde: studiets Thermit-sensor (sættes op af Holdstyrings support) eller offentlig hav-/lufttemp via Open-Meteo med latitude/longitude. Vises med
holdstyring-temperature(egen hjemmeside) eller CMS-widgetten "Temperatur-banner" (se hjemmesiden-guide). - Hovedafbryder: Indstillinger → Hjemmeside & indhold → "Widgets til egen hjemmeside". Slået fra afvises alle kald med
WIDGETS_DISABLED. Widgets-siden viser så banneret "Widgets er ikke slået til endnu" med knappen "Slå widgets til" (ét klik). - Find Widgets-siden: /admin/widgets (virker altid; uden hovedafbryder viser siden banneret "Slå widgets til"). Kortet "Widgets" i Indstillinger-hubben og linket "Gå til Widget-opsætning…" på Hjemmeside & indhold vises først, når hovedafbryderen er slået til.
- API-nøgle: "Opret API-nøgle" → Navn + "Tilladte domæner (påkrævet)" (én pr. linje, mindst ét — ellers kan nøglen ikke oprettes). Den fulde nøgle vises KUN én gang (grøn boks + "Klar til din hjemmeside" med "Kopiér opsætning" og "Kopiér og luk").
- Tilladte domæner: en tom liste ville afvise alle kald, derfor kræves mindst ét domæne. Sti, afsluttende
/og manglendehttps://normaliseres automatisk (https://eksempel.dk/bookinggemmes somhttps://eksempel.dk).www.eksempel.dkogeksempel.dker to forskellige domæner — tilføj begge, eller brug*.eksempel.dk(dækker eksempel.dk og alle underdomæner).*= alle domæner. - Ret domæner: hver aktiv nøgle har knappen "Ret domæner" (ét domæne pr. linje → "Gem domæner"; mindst ét). Nøglen og koden på hjemmesiden er uændrede, så der skal ikke oprettes en ny nøgle eller sættes ny kode ind. En aktiv nøgle uden domæner vises med advarslen "Ingen domæner — nøglen afviser alle kald". Et ventende eller afvist domæne, du tilføjer her, regnes som godkendt.
- Domæner der venter på godkendelse: et domæne kommer aldrig automatisk på nøglen. Beder et websted om adgang (fx WordPress-plugin'ets "Send domænet til godkendelse"), lægges det på nøglens venteliste. Gult banner øverst på Widgets-siden: "N domæner venter på din godkendelse" + linket "Gå til API-nøgler". Ved den aktive nøgle: boksen "Venter på din godkendelse" med "Godkend"/"Afvis" pr. domæne. Godkend = flyttes til tilladte domæner, widgetten virker dér. Afvis = huskes og kan ikke bede igen (du kan stadig selv tilføje det med "Ret domæner"). Højst 10 ventende pr. nøgle; kun konkrete domæner, aldrig
*eller*.domæne. - Dashboard-kortet "Et domæne venter på godkendelse til dine widgets" kommer igen, så længe et domæne venter: "Udskyd 24 timer" → igen ved første daglige kørsel efter 24 timer; udløbet (14 dage) → fornyes; skjult med "Skjul i 7 dage" eller lukket med "Gå til siden" → igen efter 7 dage, eller med det samme, når et domæne beder om adgang, også et der allerede venter (fx fra WordPress-plugin'et). Aldrig mere end ét kort. Det er først væk for godt, når intet domæne venter (godkendt, afvist, tilføjet med "Ret domæner" eller nøglen deaktiveret).
- Nøgleliste: Aktiv/Deaktiveret, Oprettet, Sidst brugt, Domæner, knapperne "Ret domæner" og "Deaktiver" (en deaktiveret nøgle kan ikke genaktiveres). Ny nøgle er kun nødvendig for at skifte selve nøglen. Listen viser kun starten af nøglen +
...; kopi-ikonet kopierer kun den start — ikke en gyldig nøgle. - Host: brug
base-url="https://<studio-host>"(verificeret eget domæne, ellers<slug>.class-booking.comeller<slug>.holdstyring.dk). Widgets-siden udfylder base-url korrekt i al kode.tenant-slug="<slug>"resolver ALTID til<slug>.holdstyring.dk→ forkert for Class Booking og eget domæne. Kun på en side under*.holdstyring.dkfindes host automatisk. - Færdig kode: "Hurtig integration" ("Kopiér kode"), "Kopiér tag" på hvert widget-kort under "Tilgængelige widgets" (alle widgets i kataloget), og Widget-byggeren. Nøglen er kun sat ind så længe du bliver på siden efter oprettelsen; ellers står pladsholderen
DIN_FULDE_API_NØGLE. - Widget-bygger: Embed-type "Inline" / "Knap" / "Flydende knap". Inline: "Vælg widget" (12 widgets), "Udseende" (Overstyr primærfarve, Hjørner — overstyrer skabelonens hjørner, Tema), "Indstillinger" pr. widget, "Live-eksempel", "Færdig kode" + "Kopiér kode". Knap/Flydende knap = almindeligt link til bookingsiden (Knaptekst, Linkmål, Knapfarve, Placering), kræver ikke loader-scriptet. Live-eksemplet virker altid — også når widgets er slået fra eller domænet mangler.
- Kortet "Tilpas widgets" (på Widgets-siden): "Tekst på pris-widget'ens «Se hold»-knap" (fx «Book», maks 30 tegn) og "Billede i gavekort-widget'en" ("Upload billede" i stedet for 🎁; vises beskåret til billedfeltet, med gavekortets titel som alt-tekst) → "Gem". Gælder alle studiets pris- og gavekort-widgets. Tomme felter = standarden ("Se hold" på studiets sprog / 🎁). Attributten
button-textpå én pris-widget vinder over feltet (i Widget-byggeren: holdstyring-pricing → button-text). - Script-tag (én gang pr. side, helst før
</body>):<script src="https://widgets.holdstyring.dk/v1/holdstyring-widgets.min.js" async></script>. I WordPress/page-builders: i temaets footer eller et header/footer-plugin, IKKE i en page-builder-HTML-boks (kan strippe scriptet). Undtagelse: Wix, hvor script og tags skal ligge i samme Embed HTML-element (se Wix og iframe-embeds). - Én forbindelse pr. side: alle widgets deler én nøgle + host. Ligger der en gammel blok med anden nøgle/host, vinder den sidst indlæste, og alle kald fejler.
- Primærfarven arves fra studiets branding (se temaer-branding-guide); andenfarve og fremhævninger følger primærfarven. Overstyr pr. tag med theme-*.
- Sprog: widgets taler studiets sprog (dansk, engelsk, tysk, svensk, norsk, spansk, fransk). Kun opsætningsfejl er altid på engelsk.
- Eget domæne: links fra widgets peger på det verificerede domæne.
Widget-katalog
- Booking & Bruger:
holdstyring-schedule(holdoversigt + booking),holdstyring-login(log ind, opret bruger, glemt adgangskode),holdstyring-bookings(kommende bookinger med afmelding),holdstyring-membership(klippekort med saldo, abonnement, tidligere køb). - Indhold:
holdstyring-pricing,holdstyring-class-types("Book hold" viser holdene og booker i widgeten),holdstyring-instructors,holdstyring-upcoming-classes,holdstyring-weekly-schedule(dag-grupperet liste),holdstyring-week-grid(7-kolonners ugekalender Man-Søn),holdstyring-seasons,holdstyring-season-table(kursustabel med filtre),holdstyring-treatments,holdstyring-rooms,holdstyring-blog. - Engagement:
holdstyring-testimonials,holdstyring-contact-info,holdstyring-contact-form(henvendelser lander under Kontakt og mailes til studiets officielle e-mail og alle administratorer; skjules når "Modtag kontaktforespørgsler" er slået fra; se kontakt-guide),holdstyring-newsletter,holdstyring-gift-cards,holdstyring-waitlists(ventelister til forløb, tilmelding i widgeten),holdstyring-campaign-banner,holdstyring-temperature. - Retreats og events (beta):
holdstyring-retreats(oversigt over både retreats og events),holdstyring-retreat(ét retreat eller event med program, pakker/billetter og booking i widgeten; se retreats-guide). Der findes ingen særskilt event-widget: et event vises med de samme to widgets. - Klinikfællesskab:
holdstyring-klinik-schedule— kun med nøglen fra klinikhusets ejer-studie; viser medlemsklinikkernes første ledige behandlingstider, klik åbner klinikkens egen bookingside i ny fane (se klinikfaellesskab-guide).
Attributter
- Fælles:
api-key(påkrævet, FULD nøgle),base-url,tenant-slug(kun holdstyring.dk),theme-primary,theme-font(skal allerede være indlæst på siden; std Inter),theme-mode="light|dark|auto"(std light; auto følger den besøgendes system),theme-secondary(andenfarven i farveovergangene: «Populær»-mærket og billeder uden foto; std en mørk nuance af primærfarven),theme-accent(fremhævninger: rammen om den populære prisplan og «i dag» i ugekalenderen; std primærfarven),theme-radius(hjørner på kort, knapper og felter, fx0eller12px; overstyrer skabelonens hjørner). - Alle
show-*er ON som standard;="false"skjuler. holdstyring-schedule: hold-type-slugs (kommasepareret kategorier), template-id (ét hold/program; der er ingen class-id), weeks (1-52), title, view-toggle="true" (Hold/Kalender-skifter), default-view="calendar".holdstyring-weekly-schedule: hold-type-slugs, title, week-nav="false", layout="grid".holdstyring-week-grid: hold-type-slugs, title, week-nav="false".holdstyring-upcoming-classes: limit (1-30, std 6), title (overskrift over kortene).guests-only="true"påholdstyring-schedule,holdstyring-weekly-schedule,holdstyring-week-gridogholdstyring-upcoming-classes: booking-vinduet viser gæste-tælleren åben fra start i stedet for bag "+ Tilføj gæster" (til en side målrettet medlemmer, der tager gæster med). Antallet starter på 0, så medlemmet kan stadig booke sig selv uden gæster. Kun hvor gæste-tælleren ellers vises: holdtypen tillader gæster, holdet er ikke fuldt, og studiet bruger ikke gæste-kategorier.holdstyring-pricing: plan-ids (valg + rækkefølge), layout="cards|table|compact", title, show-features, category-filter="true" (skjules ved kun én kategori), classes-href (fx#skema; «Se hold» bliver på din side), button-text (egen tekst på «Se hold»-knappen, fx «Book», maks 30 tegn; vinder over "Tilpas widgets").holdstyring-class-types: hold-type-slugs, max-items, title, show-benefits, show-meta.holdstyring-instructors: max-items, title, show-bio, show-specialties.holdstyring-seasons: layout="cards|detailed", hold-type-slugs (kun forløb hvor mindst ét hold har en af kategorierne; forløbet vises med alle sine hold. Kategorier sættes under Forløb → åbn forløbet → "Rediger" → Kategorier; i en sæson ved forløbet: "Ret" → Kategorier).holdstyring-treatments: title, show-price, show-duration, show-benefits.holdstyring-rooms: title, show-features.holdstyring-season-table(kursustabel): én række pr. hold med kursus, sted, dag og tid (varighed), periode (antal gange), instruktør, ledige pladser og pris (pr. gang, samme pris som forløbstabellen på studiets side). Filtre på sted, kursus og instruktør. kursus="<slug eller navn>", sted="<sted>", traener="<navn>" vælger på forhånd; filtre="false" skjuler filtrene; hold-type-slugs som på holdstyring-seasons. «Book» åbner forløbets side (tilmeldingen sker der). Altid tabel uanset forløbssidens visning; under 640 px kort.holdstyring-blog: limit (antal af de seneste indlæg, 1-50, std 6), show-images.holdstyring-testimonials: max-items, title.holdstyring-contact-info: title, show-opening-hours.holdstyring-contact-form: title, subtitle, show-phone.holdstyring-newsletter: title, subtitle, button-text.holdstyring-gift-cards: cta-text, cta-link (fallback-link).holdstyring-campaign-banner: override-title.holdstyring-retreat: retreat-id (påkrævet), hide-image.holdstyring-klinik-schedule: title.holdstyring-temperature: title, variant="ocean|dark|light" (std ocean), show-last-updated, latitude+longitude (offentlig hav-/lufttemp via Open-Meteo). Uden koordinater bruges studiets Thermit-sensor; uden begge skjuler widgeten sig.- Ingen egne attributter:
holdstyring-login,holdstyring-bookings,holdstyring-membership,holdstyring-waitlists. holdstyring-retreats(retreats og events): compact="true" (mindre kort uden beskrivelse, 4-5 pr. række på computer og 2 på mobil; 12 pr. side med «Vis flere»), page-size (antal pr. side, 1-100; uden værdi vises alle, i kompakt visning 12). Uden attributter: store kort, alle vist som hidtil. Serveren leverer kun én side ad gangen (hurtig også med mange events), og «Vis flere» henter næste side. Knappen på kortet hedder «Se event» for events og «Se retreat» for retreats. I widget-byggeren: vælg Retreats → Indstillinger → compact (hver indstilling har en kort forklaring). Events på én dag viser én dato («1. december 2026»).
Booking og køb i widgeten
- Login: booking-, holdtype-, kalender- og venteliste-widgets åbner selv en login-boks (log ind/opret konto); handlingen fortsætter bagefter.
- Dækket medlem (abonnement eller klippekort, der dækker holdet) booker direkte i widgeten. Er holdet fuldt, skrives et dækkende abonnement direkte på ventelisten, mens et dækkende klippekort sender kunden videre til studiets bookingside (se Venteliste). Et klippekort bruges kun, når det stadig gælder ved holdets start og har ledige klip nok til holdets "Klip pr. booking": klip, som en online-betalt booking venter på (trækkes først ved holdstart), tæller ikke, og uden ledige klip skal holdet betales. Har kunden flere kort, bruges et, der gælder, efter samme kortvalg og samme fordeling over flere hold som studiets bookingside: klippene trækkes i holdenes tidsmæssige rækkefølge (tidligste hold først), uanset hvilken rækkefølge holdene vælges i, og det, forhåndsvisningen viser, er præcis det, der trækkes. Hold, der ikke betales med klip (dækket af abonnement eller uden for medlemskaber), påvirker ikke, hvilket kort de andre hold får (se klippekort-guide). Booker to samtidig med det sidste klip (også widgeten og studiets bookingside på én gang), får den, der taber, "Der er ikke længere klip nok på dit klippekort, så holdet blev ikke booket. Prøv igen."; kortet går aldrig i minus, og intet bookes. Udløber alle kundens kort før holdets start, trækkes intet klip, og kunden betaler holdets drop-in-pris (inline eller via studiets bookingside); er holdet kun for medlemmer, sendes kunden videre til studiets bookingside. Abonnement på pause (fx betalingsfri periode) dækker hold efter pausen, som kan bookes mens pausen står; hold inde i pausen dækkes ikke, og er ét af de valgte hold inde i pausen, dækker abonnementet ingen af dem. Uden virksom momsfritagelse (slået fra eller 0 %) kan alle bruge et klippekort uden moms.
- Betalt drop-in uden dækning: betales med det samme med MobilePay eller betalingskort (Stripe) — direkte fra widgeten, uden om studiets side. Har studiet begge dele, vælger kunden selv under "Betalingsmetode" (MobilePay, Vipps for NOK-studier, eller Betalingskort); MobilePay er forvalgt. Gælder også gæster. Er ingen betaling sat op, sendes kunden til studiets bookingside. Felt "Har du en rabatkode?" i booking-boksen. Booking-vinduet viser beløbet der trækkes: med momsfritagelse ser en under-30 fx 100 kr for et hold til 125 kr, også pr. gæst.
- Koster holdet drop-in og kunden ikke er dækket, tilbyder vinduet også "Eller køb et klippekort", allerede FØR "Bekræft booking" (også når studiet tager betaling direkte i widgeten), så kunden kan vælge et kort i stedet for drop-in. En kunde, der ikke er logget ind, ser de samme kort under login med "Har du allerede et klippekort? Log ind ovenfor, så bruges det automatisk."; "Køb" beder om login (intet gæstekøb af klippekort). Har kunden selv et kort, der dækker holdet, vælges det automatisk ("Dækket af dit klippekort"), og der vises ingen købstilbud. Kortene er de klippekort (og abonnementer) i studiets prisliste, der dækker netop dette hold (aktive, ikke skjulte, holdtypen tilladt, nok klip og gyldigt når holdet starter; ikke for "Gratis hold" eller hold uden for medlemskab). "Køb" åbner det almindelige købsvindue; abonnementer er et link til studiets prisside. Der bookes ikke automatisk bagefter: kunden åbner holdet igen og trykker Book, så bruges det nye kort. Enkeltbilletten ("Betal enkeltbillet") er der stadig. Kan holdet KUN bookes med klippekort (medlemskab påkrævet), viser vinduet kun de klippekort, der dækker holdet ("Køb et klippekort til dette hold"), aldrig abonnementer.
- Hold med både "Kræv medlemskab" og "Kræv drop-in-betaling af alle" (fx en saunagus): kun brugere med et aktivt medlemskab kan booke, og medlemmet betaler holdets drop-in-pris direkte i widgeten, som på studiets side. Uden aktivt medlemskab afviser widgeten bookingen, også på et gratis hold, med gæster og på ventelisten: "Dette hold kræver et aktivt medlemskab. Fortsæt på vores hjemmeside for at vælge medlemskab og booke." og knappen "Fortsæt til booking", som åbner studiets bookingside.
- Introsession (holdtype med reglen "Gør til introtime"): én pr. konto, også i widgeten, og ikke for kunder, der allerede går på et forløb (se opret-hold-guide). En ubetalt introbooking (fx et lukket betalingsvindue) tæller ikke som brugt introsession, hverken i widgeten eller andre steder, og spærrer ikke for en anden introsession. Har kunden et åbent betalingsforsøg på samme hold, afviser widgeten et nyt betalt forsøg med "Du har allerede en betaling i gang for dette hold. …", indtil forsøget udløber eller ryddes op; på studiets bookingside kan kunden prøve igen med det samme (booking-vinduet og betaling med kort, MobilePay eller Flatpay; MobilePay afviser dog, hvis den gamle betaling allerede har reserveret penge), og det afbrudte forsøg annulleres.
- "Fortsæt som gæst": køb en enkelt drop-in uden login, når "Walk-in som gæst" er slået til (Indstillinger → Booking & salg). Kun betalt drop-in, ikke medlemskabs-hold, ikke fuldt hold. Felter: fornavn, efternavn, e-mail, telefon (valgfri) + accept af handelsbetingelser og privatlivspolitik (links til studiets sider). Betaling som et medlem (MobilePay/kort). Gæsten er kun logget ind mens booking-vinduet er åbent; lukket vindue eller betalings-redirect = intet login tilbage på hjemmesiden. Gratis hold (reglen "Gratis hold") kan også bookes som gæst, når "Gratis hold uden konto" er slået til; 0 kr alene åbner aldrig gæste-vejen.
- Gæster: holdtyper der tillader gæster får en gæste-tæller (op til holdtypens maks); hver gæst betaler holdets drop-in-pris (prissat efter den der booker), også når medlemmet selv er dækket. Er medlemmet ikke dækket (fx klippekortet udløber før holdets start), betaler medlemmet sin egen drop-in-pris sammen med gæsterne. Rabatkode og gæster kan ikke kombineres. Gæste-kategorier og klippekort-dækket medlem + gæster → "Book med gæster" på studiets side.
- Venteliste: er holdet fuldt og har venteliste, hedder knappen "Tilmeld venteliste". Der betales intet i widgeten; pladsen gemmes ubetalt (0 kr, ingen betalingsmetode) som på studiets side. Dækker et abonnement holdet, står abonnementet på pladsen, og den tæller med i abonnementets bookingloft; rykkes kunden op, viser mailen intet beløb. Widgeten reserverer aldrig et klip på ventelisten (modsat studiets side og appen): dækker kundens klippekort holdet (holdtypen passer, og kortet har klip nok til holdets "Klip pr. booking") og gælder ved holdets start (også for en abonnent over bookingloftet), viser widgeten "Holdet er fuldt, og dit klippekort dækker det. Fortsæt på vores hjemmeside for at skrive dig på ventelisten, så dit klip bliver reserveret." og knappen "Fortsæt til booking", som åbner studiets bookingside. Dér reserveres klippet som ellers, og oprykningsmailen beder ikke om betaling. Direkte på widgetens venteliste skrives stadig en abonnent, hvis abonnement dækker holdet, kunder uden dækning, en kunde med et klippekort, der ikke dækker holdet, og en kunde med et kort, der udløber før holdets start; de to sidste står uden dækning som på studiets side, ligesom en abonnent over bookingloftet uden klippekort. Uden dækning viser oprykningsmailen beløbet (under-30 uden moms ved momsfritagelse) og "Du kan betale kontant i studiet", når "Kontant betaling" er slået til; ellers intet beløb. En ventelisteplads tæller kun som betalt, når der ligger en betaling bag den. Hold der kræver medlemskab: ventelisten kræver et aktivt abonnement eller et klippekort med klip tilbage.
- Afmelding: booket hold kan afmeldes i widgeten ("Afmeld") og i
holdstyring-bookingsmed samme regler som studiets side og appen. Før fristen: drop-in betalt med MobilePay/kort/Flatpay refunderes automatisk, klip gives tilbage, og et gavekorts andel sættes tilbage på kortet. Efter fristen: intet tilbage (abonnent kan få gebyr for sen afmelding). "Ingen refundering ved afmelding": aldrig noget tilbage. En MobilePay-reservation, der aldrig er hævet, frigives blot (ingen refusion, ingen kreditnota). Udmelding af ventelisten giver altid et reserveret klip tilbage (fra studiets side eller appen; en plads fra widgetens venteliste har intet klip). Pladsen (inkl. gæster) frigives, og ventelisten rykker op med mail + push, hvis holdet har venteliste og ikke er sæsonhold. Vises som "Selv afmeldt" (venteliste: "Forlod ventelisten") på holdet. Begyndt eller afsluttet hold kan ikke afmeldes (fejlbeskeden er på studiets sprog); en abonnent der ikke kommer, registreres som udeblevet. - Priser: "Køb" på klippekort og abonnement åbner køb i widgeten (samme betalingsvalg: kunden vælger MobilePay eller kort, når studiet har begge). Købsvinduet viser beløbet der trækkes (fx 320 kr for en under-30 på en plan til 400 kr). Rabatkode: "Har du en rabatkode?" → "Anvend" viser "Rabat" og "Pris efter rabat", før kunden betaler, og det er det beløb, der trækkes; på et abonnement står der "Rabatten gælder den første betaling." (eller "… hver betaling." for en løbende procentrabat). En kode der ikke gælder planen, giver fejlen ved feltet (fx "Rabatkoden gælder ikke for denne produkttype") (se rabatkoder-guide). På en plan med "Vis momsfri pris" er planens pris den momsfri pris: en under-30 betaler 400 kr og alle andre 500 kr (planens pris plus moms). Er studiets momsfritagelse slået fra, eller er momssatsen 0 %, har fluebenet ingen virkning: alle betaler planens pris (400 kr på en plan til 400 kr). Kortene i widgettens prisliste viser listeprisen uden mærket "Momsfri pris"; det mærke står på studiets prisside og i prislisten på studiets hjemmeside (se abonnementer-guide). Planer til flere deltagere (familieplaner) købes aldrig i widgeten: købsvinduet viser prisen for et køb uden deltagerprofiler (fx 700 kr for en under-30, hvor kun køberen er momsfri, og 778 kr for andre på en familieplan til 700 kr for 2, heraf 1 momsfri), og "Køb" sender kunden til studiets prisside, hvor beløbet følger de valgte deltagerprofiler. Planer til flere deltagere, op-/nedgradering, faste pladser, introtilbud o.l. fortsætter på studiets prisside.
- Gavekort: "Køb gavekort" åbner køb i widgeten uden login (beløb 100-5.000 i studiets valuta, navn + e-mail, valgfri modtager-e-mail og personlig hilsen; samme betalingsvalg).
- Sendes videre til studiets side: hold der kræver et medlemskab, kunden ikke har, eller som kundens klippekort eller abonnement ikke dækker (fx et tomt kort, et kort, der udløber før holdets start, eller et abonnement til andre holdtyper), venteliste på et fuldt hold, som kundens klippekort dækker, deltagernavne, ansvarsfraskrivelse, intake-spørgsmål første gang, alle hold når studiet bruger deltagerprofiler (kunden vælger deltager), "Book hele holdet", sæsontilmelding. Efter turen viser studiets side en bjælke "Tilbage til <din side>" (gælder 4 timer, kun godkendte domæner).
- Hold uden drop-in-pris vises med prislabel "Medlemskab".
- Hold kun for medlemmer ("Kræv medlemskab" uden "Kræv drop-in-betaling af alle"): en bekræftet plads kræver et abonnement, der dækker holdet, eller et klip fra et klippekort, der kan bruges til holdet; drop-in er ingen vej ind, heller ikke betalt. Ventelisten kræver et aktivt abonnement eller et klippekort med klip tilbage. Samme regel gælder på studiets bookingside, hvor booking-vinduet viser "Dette hold kan kun bookes med et klippekort eller abonnement, der dækker holdet." og ikke lader kunden booke, og i Min Booking-appen og ved online betaling, hvor bookingen afvises med ""Yin" kan kun bookes med et klippekort eller abonnement, der dækker holdet."
Sådan gør du
- Kom i gang: slå widgets til → "Opret API-nøgle" med domæne(r) → kopiér opsætningen fra den grønne boks → indsæt script + tags.
- Indsæt widget:
<holdstyring-schedule api-key="DIN_FULDE_API_NØGLE" base-url="https://dit-studio.class-booking.com"></holdstyring-schedule>. - Medlemsside ("min side"): ingen samlet widget — brug
holdstyring-login+holdstyring-membership+holdstyring-bookingspå samme side (deler login). - WordPress: gratis plugin "Holdstyring Class Booking Widgets" (gratis på WordPress.org: https://wordpress.org/plugins/holdstyring-class-booking-widgets/ ; kortet "Bruger du WordPress?" på Widgets-siden). WP-admin → Indstillinger → Class Booking: API-nøgle + Base-url → "Forbind og tjek" → mangler domænet: "Send domænet til godkendelse" → godkend det ved nøglen under "Venter på din godkendelse" på Widgets-siden. Indsæt med blokken "Class Booking" eller shortcode
[class_booking type="schedule"](attributter: theme-primary, theme-radius, theme-mode, hold-type-slugs, layout, limit, title). Plugin'et indlæser selv loader-scriptet. Typer: schedule, weekly-schedule, upcoming-classes, pricing, class-types, instructors, testimonials, contact-info, contact-form, gift-cards. Uden plugin: script i footer + tags i "Custom HTML"-blok. - Fuld guide med platform-vejledninger: linket "Se den fulde guide med platform-vejledninger" (/widget-guide).
Wix og iframe-embeds
- Wix' «Embed → Embed HTML» kører koden i en iframe på et ANDET domæne end hjemmesiden (
*.filesusr.com). Det er iframens domæne — ikkehttps://www.mit-studie.dk— der skal stå under "Tilladte domæner". EllersORIGIN_NOT_ALLOWED, selvom hjemmesidens eget domæne står på nøglen. - Find domænet: åbn den publicerede side. Widgeten viser en rød boks (engelsk):
This website (https://….filesusr.com) is not on your API key's allow-list— kopiér præcis det domæne ind på nøglen ("Ret domæner" → "Gem domæner") og genindlæs. - Wix kan bruge FLERE domæner til samme embed: set i praksis både
https://www-<domæne-med-bindestreger>.filesusr.comog et med tilfældig kode (https://<uuid>.filesusr.com). Viser boksen et nyt domæne efter genindlæsning, tilføj også det — gentag til boksen er væk. Behold hjemmesidens eget domæne på nøglen. - Script-tag OG widget-tags skal ligge i SAMME Embed HTML-element. Script under Wix' "Custom Code" (hele siden) når ikke ind i iframen → widgeten loader aldrig.
- Flyttes widgeten til en anden side, eller slettes+genindsættes embed-elementet, kan Wix give et nyt domæne → tjek siden igen.
- Giv embed-elementet rigelig højde: Wix beskærer indhold over elementets faste højde, og booking-vinduet åbner inde i elementet.
- Links og betaling åbner i en NY FANE når widgeten står i en iframe (Wix m.fl.): Wix-iframen må ikke vise studiesiden eller Stripes betalingsside, så uden det gav knapperne «… nægtede at oprette forbindelse». Hjemmesiden bliver stående i den oprindelige fane. På sider uden iframe (WordPress, almindelig HTML) åbner de i samme fane som før.
- Gælder alle systemer der viser egen kode i en iframe: iframens domæne skal på nøglen; den røde boks oplyser hvilket.
Regler / grænser
- Ingen ekstra pris og intet plan-krav; ubegrænset antal widgets pr. side.
ORIGIN_NOT_ALLOWED→ widgeten skriver "This website (…) is not on your API key's allow-list…" = sidens domæne mangler på nøglen → "Ret domæner" på nøglen (på Wix er det iframens domæne, se Wix og iframe-embeds). Test på den publicerede side, ikke i CMS-editorens preview.ORIGIN_PENDING_APPROVAL→ "This website (…) is waiting for the studio's approval…" = domænet har bedt om adgang og venter → "Godkend" ved domænet under "Venter på din godkendelse".Could not resolve the Holdstyring host= base-url mangler (ikke CORS).- "Invalid API key. Paste the FULL key…" = forkortet nøgle (
wk_live_…...) ELLER to nøgler/hosts på samme side. - "Could not reach your Holdstyring studio…" = base-url forkert stavet/forkert host.
An api-key attribute is required= api-key mangler på tagget.- Kontaktformular-widgetten vises ikke: "Modtag kontaktforespørgsler" (Kontakt) er slået fra — så skjules den ligesom formularen på /contact.
- Tom kalender: F12 → Network: kald til
/api/widget/*skal give 200 og gå til din studie-host.
FAQ
- Hvad er vandtemperaturen? — Holdstyring viser den målte temperatur, men assistenten kan ikke slå den aktuelle værdi op. Se den i temperatur-widgetten på hjemmesiden. Kilden er studiets Thermit-sensor eller Open-Meteo (badestedets koordinater).
- Hvor sætter jeg badetemperaturen? — Den kan ikke skrives ind; den måles. Med en Thermit-sensor: kontakt Holdstyrings support, som forbinder sensoren (Thermit-login). Uden sensor: sæt latitude og longitude på widgetten, så hentes hav- og lufttemperatur fra Open-Meteo, fx
<holdstyring-temperature latitude="57.59" longitude="9.97"></holdstyring-temperature>. Uden begge skjuler widgeten sig. Link altid til denne guide: Widgets. - Min widget vises ikke — 1) Hovedafbryderen "Widgets til egen hjemmeside" er ON, 2)
base-urler sat, 3) sidens domæne står på den aktive nøgle (ellers "Ret domæner"; venter det på godkendelse: "Godkend"; på Wix: iframens*.filesusr.com-domæne), 4) hele nøglen er indsat og aktiv, 5) script-tagget er loaded (F12 → Console). - Min widget vises ikke på min Wix-side, selvom mit domæne står på nøglen — Wix kører koden i en iframe på
*.filesusr.com, så det er DET domæne der skal på nøglen. Kopiér domænet fra den røde boks i widgeten ind med "Ret domæner" → "Gem domæner", genindlæs, og gentag hvis boksen viser et nyt domæne (Wix kan bruge flere). Script og tags skal ligge i samme Embed HTML-element. Se afsnittet "Wix og iframe-embeds". - Kan jeg rette domænerne på en nøgle? — Ja. Widgets → API-nøgler → "Ret domæner" på nøglen → ret listen → "Gem domæner". Nøglen og koden på hjemmesiden er uændrede. Listen skal have mindst ét domæne. WordPress-plugin'et kan sende sit domæne til godkendelse, men aldrig selv tilføje det.
- Hvorfor venter et domæne på min godkendelse? — Et websted har bedt om at vise dine widgets med din nøgle, typisk via WordPress-plugin'et. Nøglen står i sidens kildekode, så intet domæne kommer på nøglen uden dit ja. Din egen side: "Godkend". Ukendt domæne: "Afvis".
- Hvorfor kommer kortet "Et domæne venter på godkendelse til dine widgets" igen? — Et domæne venter stadig på dit svar. Udsat kort kommer igen efter 24 timer, et kort skjult med "Skjul i 7 dage" eller lukket med "Gå til siden" efter 7 dage eller med det samme, når domænet beder om adgang igen. Klik "Godkend" eller "Afvis" ved domænet under "Venter på din godkendelse" (Widgets → API-nøgler), så er kortet væk.
- Hvorfor sender widgeten en klippekortholder videre, når holdet er fuldt? — Widgeten reserverer intet klip på ventelisten. Dækker kundens klippekort holdet og gælder ved holdets start, viser widgeten "Holdet er fuldt, og dit klippekort dækker det. …" og "Fortsæt til booking": på studiets bookingside reserveres klippet ved tilmelding, og oprykningsmailen beder ikke om betaling. Et abonnement, der dækker holdet, skrives derimod direkte på widgetens venteliste, så længe bookingloftet ikke er nået.
- Hvorfor skal en kunde betale ved oprykning fra widgetens venteliste? — Pladsen på widgetens venteliste har ingen dækning, fx fordi kundens klippekort ikke dækker holdet (anden holdtype eller for få klip) eller udløber før holdets start, eller abonnementets bookingloft er nået. Oprykningen regnes så som drop-in: mailen viser drop-in-prisen og "Du kan betale kontant i studiet", når "Kontant betaling" er slået til.
- Hvorfor sender widgeten en kunde med medlemskab videre på et hold, der kun er for medlemmer? — Kundens klippekort eller abonnement dækker ikke holdet: kortet er tomt eller har for få klip, udløber før holdets start eller gælder andre holdtyper, eller abonnementet gælder andre holdtyper. Drop-in er ingen vej ind på holdet, så widgeten viser "Dette hold kræver et aktivt medlemskab. …" og "Fortsæt til booking". Studiets bookingside, Min Booking-appen og online betaling følger samme regel: holdet kan kun bookes med et klippekort eller abonnement, der dækker det.
- Kan kunderne betale direkte i widgeten? — Ja: drop-in, gæster, klippekort, abonnement og gavekort betales via MobilePay/Stripe direkte fra widgeten; har studiet begge, vælger kunden selv (MobilePay forvalgt). Komplekse køb fortsætter på studiets side med vej tilbage.
- Virker med WordPress/Squarespace/Wix? — Ja. WordPress: brug plugin'et "Holdstyring Class Booking Widgets" eller Custom HTML. Wix: se "Wix og iframe-embeds". Al domæne-opsætning sker i Holdstyring-admin.
- Findes der en prøvetime-widget? — Nej. Brug
holdstyring-schedulemed rabatkode (se rabatkoder-guide) og filtrér medhold-type-slugsellertemplate-id. - Kan jeg vise kun ét hold/program? — Ja,
template-id="…"ellerhold-type-slugs="…"påholdstyring-schedule. - Kan jeg begrænse hvor mange uger skemaet viser? —
weeks="4"påholdstyring-schedule(1-52) eller holdtypens felt "Hvor langt frem kan holdene bookes"; den strammeste vinder. - Kan jeg vise skemaet som ugekalender? —
holdstyring-week-grid,holdstyring-weekly-schedule layout="grid"ellerholdstyring-schedule view-toggle="true" default-view="calendar". - Hvordan viser jeg badetemperatur/vandtemperatur? —
<holdstyring-temperature latitude="57.59" longitude="9.97"></holdstyring-temperature>(Open-Meteo), eller uden koordinater med studiets Thermit-sensor. - Jeg valgte "Brug vores hjemmeside" i opsætningen — kan jeg stadig bruge widgets? — Ja. Valget "Hvor skal folk booke?" styrer kun hvilke trin opsætningen viser; både hjemmesiden og widgets kan bruges bagefter.
- Kan jeg lave en "Book"-knap i stedet for en hel widget? — Ja, Widget-byggeren → Embed-type "Knap" eller "Flydende knap" giver et link til din bookingside.