Opsætningsguide til WordPress Plugin
Booking Board Widget
Trin-for-trin-vejledning til installation og konfiguration af Booking Board-widgetten på en WordPress-side.
1. Forudsætninger
- WordPress 6.0+ og PHP 7.4+
- Administratoradgang til WordPress-siden
- Administratoradgang til dit Booking Board-kædedashboard
- WordPress-sidens offentlige domæne (f.eks.
example.com)
2. Installér pluginnet
| URL | Brug denne når… |
|---|---|
https://widget.bookingboard.io/wordpress-plugin/booking-board-widget-plugin.zip |
Førstegangsinstallation — altid nyeste. |
- Hent den zip, der passer til din computer.
- I WordPress-administrationen: Plugins → Tilføj nyt → Upload plugin.
- Vælg zip-filen, klik på Installér nu, og dernæst Aktivér.
Pluginnet vises under Værktøjer → Booking Board Widget. Automatiske opdateringer kontrolleres mod https://widget.bookingboard.io/wordpress-plugin/version_log.json.
3. Generér en API-nøgle (Booking Board-dashboard)
Widgetten godkendes med en API-nøgle per domæne, knyttet til din kæde.
- Log ind på dit Booking Board-dashboard.
- Åbn Systemindstillinger på den kæde, der ejer det/de centre, du vil eksponere.
- Rul ned til Website Integration.
- Klik på Add domain.
- Indtast WordPress-sidens domæne uden protokol, f.eks.
example.com. Klik på Save. - Kopiér API-nøglen med det samme — den vises kun én gang i klartekst. Derefter maskeres den (
BB_∗…∗_∗…∗). Hvis den mistes, skal du slette og oprette den igen.
Dashboardet viser også widgettens embed-uddrag med dit sub-domæne og (valgfrit) et forudvalgt center-id — nyttigt som reference.
Hvad er sub-domænet?
Det er præfikset i din kædes Booking Board-domæne. Eksempler:
| Kædedomæne | Sub-domæne-værdi |
|---|---|
mygym.bookingboard.io |
mygym |
Widgetten sender API-kald til https://{sub-domæne}.bookingboard.io/.
Hvad er center-id'et?
Hvis angivet, springer widgetten centervælgeren over og booker direkte i det center. Lad feltet være tomt, så brugerne selv vælger et center fra kæden.
4. Konfigurér pluginnet
- I WordPress-administrationen: Værktøjer → Booking Board Widget.
- Udfyld:
- API Key — indsæt værdien fra trin 3.
- Sub Domain — f.eks.
mygym. - Gym id — numerisk center-id, eller lad være tomt.
- Klik på Gem.
Værdierne gemmes som WordPress-indstillinger og bruges som standard i shortcoden.
5. Indlejr widgetten på en side
Tilføj shortcoden hvor som helst (side, indlæg, blok-editor som en Shortcode-blok):
[booking-board-widget]
Overstyring af standardværdier per placering
Alle fire attributter er valgfrie; manglende attributter falder tilbage til de gemte indstillinger.
| Attribut | Eksempel | Formål |
|---|---|---|
api-key |
api-key="BB_...." |
Brug en anden nøgle på denne side. |
sub-domain |
sub-domain="mygym" |
Peg på et andet kædemiljø. |
gym-id |
gym-id="42" |
Forudvælg et center. |
lang |
lang="en" |
UI-sprog (standard da). |
Eksempel:
[booking-board-widget lang="en" gym-id="42"]
Shortcoden genererer:
<div class="bookingboard-widget"
data-sub-domain="..."
data-api-key="..."
data-gym-id="..."
data-language="..."
style="width: 350px; height: 540px;"></div>
<script src="https://widget.bookingboard.io/widget.js" async></script>
6. Verificér
- Åbn den offentlige side i en browser, hvor du ikke er logget ind.
- Widgetten indlæser formularen.
- Gennemfør en testbooking af et tidsrum fra start til slut.
7. Fejlfinding
| Symptom | Sandsynlig årsag |
|---|---|
| Widget-containeren forbliver tom | widget.js er blokeret, eller ingen .bookingboard-widget-div er genereret (shortcoden blev ikke kørt). |
| API-kald returnerer 401/403 | API-nøglen er forkert, tilbagekaldt, eller domænet på nøglen matcher ikke siden, der serverer siden. |
| API-kald fejler med DNS / 404 | Sub-domænet er forkert; skal være kædens præfiks uden .bookingboard.io. |
| Sidder fast på indlæsningsspinner | gym-id peger på et center, der ikke findes eller ikke tilhører denne kæde. |
| Forkert sprog | lang-attribut eller gemt sprog er ikke sat; standard er da. |
| Nøgle mistet | Nøgler kan kun ses én gang; slet og opret igen i dashboardet. |
8. Rotation eller fjernelse af en nøgle
- Rotér: i dashboardet, slet den aktuelle domænepost og tilføj den igen. Indsæt den nye nøgle i plugin-indstillingerne.
- Afinstallér: deaktivering + sletning af pluginnet fjerner de gemte indstillinger (
*-api-key,*-sub-domain,*-gym-id) via uninstall-hooket.