Description
Gudjons Turneringer for Golfbox fetches a golf club’s upcoming tournaments from Golfbox and displays them in WordPress in the club’s own style, without loading the full Golfbox widget. The plugin is generic and works for any club by setting the club’s customerID.
Data is fetched server-side from the Golfbox schedule endpoint, cached with WordPress Transients, filtered and displayed. The same data source and cache are shared by all views on the page.
Main features
- Three layouts: list (rows), table (columns) and cards (grid).
- Field and column selection: choose which fields are shown and in what order: date, time, name, type, venue and status.
- Theming with colors and font: set accent color, soft accent, tint color and heading font, from the settings page or per shortcode. Built on CSS variables, so your theme can override everything.
- Density: normal or compact (great for a front-page box).
- Filtering: by named series, free text search and/or Golfbox category IDs.
- Deep link per tournament to the Golfbox calendar.
- Template override: developers can copy the layout files into the theme and override the markup completely, and use filters.
- Its own settings page, shortcode and template tag. No editing of
functions.phprequired.
Shortcode
Basic usage:
[gudjons_turneringer limit="50"]
Examples:
- Table:
[gudjons_turneringer layout="table" fields="date,time,name,venue,badge"] - Cards:
[gudjons_turneringer layout="cards" limit="6"] - Front-page box:
[gudjons_turneringer density="compact" limit="5" all_url="/turneringer/"] - Custom color:
[gudjons_turneringer accent="#0a3d2a" tint="#e6f4ea"] - A series:
[gudjons_turneringer series="torsdagsduellen"]
External services
This plugin connects to the Golfbox tournament schedule API to display your golf club’s upcoming tournaments. This is required for the plugin to function.
- Service: Golfbox (scores.golfbox.dk), provided by Golfbox A/S.
- What is sent and when: On front-end page views that render a tournament list, the plugin makes a server-side request to
https://scores.golfbox.dk/Handlers/ScheduleHandler/GetSchedule/.... The request URL contains the club’s customerID, the season (year) and a language ID that you configure. No personal data about your site visitors is sent. Responses are cached with WordPress Transients to limit the number of requests. - Deep links from each tournament point to the club’s own Golfbox calendar page.
- Golfbox terms of service: https://www.golfbox.no/
- Golfbox privacy policy: https://www.golfbox.no/
If you do not configure a customerID, the plugin makes no external requests.
Screenshots
Installation
- Upload the plugin folder to
wp-content/plugins/, or install the ZIP via Plugins > Add New > Upload. - Activate Gudjons Turneringer for Golfbox under Plugins.
- Open Gudjons Turneringer for Golfbox in the admin menu and set at least the club’s customerID.
- Place
[gudjons_turneringer]on a page, or use one of the variants above.
FAQ
-
Where do I find the club’s customerID?
-
It is part of the club’s Golfbox setup, and is often visible in the URL of the club’s Golfbox calendar. Contact your club administrator or Golfbox/NGF if you are unsure.
-
Can I control which fields are shown?
-
Yes. On the settings page you can tick fields on or off, and in the shortcode you can set the order with
fields="date,name,venue,badge". -
Can I change colors and font?
-
Yes, from the settings page (color pickers and font), or per shortcode with
accent,accent_soft,tintandfont_heading. Everything is built on CSS variables, so your theme can also override.gudjons-turneringer-for-golfbox { --gbt-accent: ... }. -
Can I override the HTML itself?
-
Yes. Copy one of the files in the plugin’s
templates/folder (for examplelist.php,table.php,cards.php) intoyour-theme/gudjons-turneringer-for-golfbox/and edit it there. There are also filters such asgolfbox_turneringer_entry,golfbox_turneringer_entry_fieldsandgolfbox_turneringer_render_args. -
How often is the data updated?
-
It is cached for the number of seconds set by “Cache time” (default 30 minutes). The cache is cleared when you save the settings.
Reviews
There are no reviews for this plugin.
Contributors & Developers
“Gudjons Turneringer for Golfbox” is open source software. The following people have contributed to this plugin.
Contributors
Translate “Gudjons Turneringer for Golfbox” into your language.
Interested in development?
Browse the code, check out the SVN repository, or subscribe to the development log by RSS.
Changelog
2.1.2
- Fixed: cards layout – the status badge could overlap the start time on multi-day tournaments; the card header now wraps cleanly.
2.1.1
- Changed: renamed the plugin to “Gudjons Turneringer for Golfbox” and the shortcode to
[gudjons_turneringer]to clearly mark it as a third-party integration (no affiliation with Golfbox).
2.1.0
- New: three layouts – list, table and cards (
layout="list|table|cards"). - New: field and column selection (
fields="...") and choices in the admin. - New: theming with CSS variables – accent color, soft accent, tint color and heading font (admin + shortcode).
- New: template override from the theme, and the filters
golfbox_turneringer_entry,golfbox_turneringer_entry_fields,golfbox_turneringer_render_args. - New: time as a selectable field.
- Changed:
variant="compact"is nowdensity="compact"(the oldvariantstill works). - Improved: full internationalization (i18n), text domain and translation template.
- Improved: admin script and style are loaded as separate files (no inline script/style).
- Fixed: robust date handling and an early return when customerID is not set.
2.0.0
- List and compact view, filtering by series/text/category, deep link, caching and a settings page.