golfbox Embedded Solution
Integrationsguide – turneringsdata på jeres egen hjemmeside
Oversigt
Med golfbox' embedded løsning kan I vise live turneringsdata fra golfbox direkte på jeres egen hjemmeside – turneringskalender, startlister, live leaderboards, resultater og Order of Merit-ranglister. Hver visning indsættes med en enkelt linje kode, og indholdet opdateres automatisk. I skal aldrig vedligeholde data på jeres hjemmeside – alt styres direkte fra golfbox.
Sådan indsætter I en visning
Jeres webmaster indsætter blot et script-tag på siden, dér hvor indholdet skal vises. For eksempel turneringskalenderen:
<script src="https://scores.golfbox.dk/api/js/schedule/customerid/{CustomerID}/language/1030/template/GolfBox" type="text/javascript"></script>
Det præcise script – med jeres egne ID'er – genereres for jer i golfbox (se Sådan henter I scriptet i golfbox nedenfor), så I behøver aldrig bygge URL'en i hånden.
Indholdet vises direkte på siden – uden iframe – og tilpasser sig bredden af den omkringliggende container, så det passer naturligt ind i jeres eksisterende layout.
Script-URL'en forklaret
https://scores.golfbox.dk/api/js/{view}/{identifikator}/{id}/language/{kode}/template/{template}
| Parameter | Betydning |
|---|---|
| view | Visningen der skal vises: schedule, orderofmerits, leaderboard, holebyhole, result, teetimes, players, info eller orderofmerit. Se den fulde liste under Tilgængelige visninger. |
| customerid / competitionid | Hvilke data der vises. Kundevisninger bruger jeres customerid. Turneringsvisninger bruger competitionid for den enkelte turnering. Begge udfyldes automatisk, når scriptet genereres i golfbox. |
| language | Visningssprog som standard sprogkode (LCID) – fx 1030 = dansk, 2057 = engelsk, 1034 = spansk. Kan sættes pr. visning. |
| template | Det visuelle design. GolfBox er standarddesignet. Vi kan lave skræddersyede templates, der matcher jeres hjemmeside – se Design og farvetilpasning nedenfor. |
| hideNavigation | Valgfri. true skjuler den øverste navigationsbjælke og topheaderen (fx kunde- og turneringsnavn). Standard: false. |
| hideTopBar | Valgfri. true skjuler kun den øverste navigationsbjælke. Standard: false. |
De valgfrie parametre tilføjes blot til URL'en. For eksempel et leaderboard uden navigationsbjælke og header:
<script src="https://scores.golfbox.dk/api/js/leaderboard/competitionid/{CompetitionID}/language/1030/template/GolfBox/hideNavigation/true" type="text/javascript"></script>
Tilgængelige visninger
| Visning | Scriptnavn | Identifikator | Beskrivelse |
|---|---|---|---|
| Turneringskalender | schedule | customerid | Fuld kalender over jeres turneringer, altid opdateret. |
| Orders of Merit | orderofmerits | customerid | Oversigt over alle jeres Order of Merit-ranglister. |
| Leaderboard | leaderboard | competitionid | Live leaderboard for en bestemt turnering. |
| Hul-for-hul leaderboard | holebyhole | competitionid | Live leaderboard med scores hul for hul. |
| Resultatliste | result | competitionid | Endelige resultater for en bestemt turnering. |
| Startliste | teetimes | competitionid | Starttider og bolde for en bestemt turnering. |
| Deltagerliste | players | competitionid | Liste over tilmeldte spillere i en bestemt turnering. |
| Information | info | competitionid | Generel informationsside for en bestemt turnering. |
| Order of Merit | orderofmerit | orderofmeritid | Stillingen i en bestemt Order of Merit. |
Deep links: filtrér kalenderen på sæson og kategori
Kalendervisningen understøtter deep links, så I kan linke direkte til en filtreret visning af kalenderen – fx kun turneringer i en bestemt kategori i en bestemt sæson. Linket tilføjes efter sidens URL som en hash-rute:
#/customer/{CustomerID}/schedule/{Sæson}/{CategoryID}
Eksempel – link direkte til én kategori for sæsonen 2026:
https://www.jereshjemmeside.dk/turneringer/#/customer/{CustomerID}/schedule/2026/{CategoryID}
CategoryID-værdierne er specifikke for jeres opsætning – kontakt golfbox support for at få listen over jeres kategorier.
Bemærk: hvis jeres kategorier ændres i fremtiden, kan det være nødvendigt at opdatere CategoryID-referencerne i jeres deep links.
Sådan henter I scriptet i golfbox
golfbox genererer det korrekte script for hver visning:
- Åbn turneringen i golfbox og gå til Settings → Embedding.
- Vælg den ønskede visning (Leaderboard, Resultatliste, Startliste, Deltagerliste, Information m.fl.).
- Kopiér det genererede script-tag og indsæt det på jeres hjemmeside.
Under Embedding-indstillingerne kan I også styre, hvad der vises i kalendervisningen – fx om spillested, starttid eller turneringstype skal vises.
Design og farvetilpasning
Alle visninger leveres med standard-templaten GolfBox. Ønsker I, at de indlejrede visninger matcher jeres hjemmesides udseende, kan vi lave en skræddersyet template til jer. Alle visninger, der bruger templaten, deler samme styling, så integrationen ser ensartet ud på tværs af jeres side.
For at få en skræddersyet template – eller justere en eksisterende – skal I blot sende os:
- Jeres brandfarver (hex-koder) til baggrunde, overskrifter, tekst og fremhævninger.
- Jeres foretrukne skrifttype, hvis den afviger fra standarden.
- Et link til den eller de sider, hvor visningerne skal indlejres, så vi kan se resultatet i kontekst.
Template-ændringer laves centralt af os – når templaten er opdateret, opdateres alle sider, der bruger den, automatisk, uden ændringer på jeres hjemmeside.
Godt at vide
- Scriptene leveres via HTTPS og virker på alle moderne webplatforme (WordPress, eget CMS m.fl.).
- I kan indlejre flere visninger på samme site – fx kalenderen på én side og et live leaderboard på en turneringsside.
- language-parameteren kan ændres pr. visning, hvis I har brug for samme visning på flere sprog.
- Live-visninger (leaderboards) opdateres automatisk, mens der scores.
Spørgsmål?
Har I brug for hjælp til integrationen, flere visninger eller en skræddersyet template, så kontakt golfbox support – vi hjælper jer godt i gang.
Kommentarer
0 kommentarer
Log ind for at kommentere.