Badhub Widget

Description

Badhub Widget lets badminton clubs embed their current league table and match schedule on their own website. No technical knowledge required.

Features

• Live league table — always up to date, directly from badhub.de
• Match schedule — upcoming fixtures and past results with match reports
• Table + Schedule combined — both widgets in one
• Automatic height adjustment — the iframe resizes to fit its content
• Theme support — light mode, dark mode, or auto (follows the visitor’s system preference)
• Highlight your own club — your club’s row is visually emphasised
• Promotion/relegation markers — coloured indicators for promotion and relegation zones
• Club logos — optional logo display next to each team name
• Federation mode — display a full federation table (for federation websites)
• Works with any WordPress theme via shortcode or Gutenberg block

How it works

1. Install and activate the plugin
2. Go to Settings → Badhub Widget
3. Enter your free API key (get one at plugin.badhub.de)
4. Select your federation and club
5. Insert [badhub_widget] into any page or post

Shortcode options

[badhub_widget] — league table (default)
[badhub_widget type="matches"] — match schedule
[badhub_widget type="combined"] — table + schedule combined
[badhub_widget type="table" pool_id="12345"] — specific league pool
[badhub_widget theme="dark"] — dark mode
[badhub_widget highlight="0"] — disable own-club highlight
[badhub_widget promotion="0"] — hide promotion/relegation markers
[badhub_widget logos="0"] — hide club logos

Federation league system shortcode (`[badhub_liga]`)

Federations with an active Federation-tier license can embed the complete league system — all divisions, all tables, full match schedule with built-in 3-level navigation — using a single shortcode:

[badhub_liga federation="bvbb"] — full league widget for the BVBB federation
[badhub_liga federation="bvbb" ga="G-XXXXXXXX"] — with Google Analytics 4 tracking
[badhub_liga min_height="700"] — set initial iframe height (default 500)

The federation slug is required. If your Plugin Settings already specify a federation, the attribute can be omitted. Only federations with a valid Federation-tier license on badhub.de are served — other slugs return 403.

External service

This plugin connects to badhub.de to retrieve league tables and match data, and to plugin.badhub.de to render the widget iframe.

• Service website: https://badhub.de
• Privacy policy: https://badhub.de/datenschutz
• Terms of use: https://badhub.de/nutzungsbedingungen

Data is fetched when a page containing the widget shortcode is loaded by a visitor. No personal visitor data is transmitted to badhub.de.