Title: Badhub Widget
Author: badhub
Published: <strong>2026 年 5 月 5 日</strong>
Last modified: 2026 年 5 月 6 日

---

搜索插件

![](https://ps.w.org/badhub-widget/assets/banner-772x250.png?rev=3524603)

![](https://ps.w.org/badhub-widget/assets/icon-256x256.png?rev=3523313)

# Badhub Widget

 作者：[badhub](https://profiles.wordpress.org/badhub/)

[下载](https://downloads.wordpress.org/plugin/badhub-widget.0.2.0.zip)

 * [详情](https://cn.wordpress.org/plugins/badhub-widget/#description)
 * [评价](https://cn.wordpress.org/plugins/badhub-widget/#reviews)
 *  [安装](https://cn.wordpress.org/plugins/badhub-widget/#installation)
 * [开发进展](https://cn.wordpress.org/plugins/badhub-widget/#developers)

 [支持](https://wordpress.org/support/plugin/badhub-widget/)

## 描述

**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](https://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](https://badhub.de)
 * Privacy policy: [https://badhub.de/datenschutz](https://badhub.de/datenschutz)
 * Terms of use: [https://badhub.de/nutzungsbedingungen](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.

## 屏幕截图

 * [[
 * League table widget on a club website
 * [[
 * Match schedule with clickable match reports
 * [[
 * Plugin settings page
 * [[
 * Widget Generator on plugin.badhub.de

## 区块

该插件提供了 1 个区块.

 *   Badhub Widget Ligatabelle deines Vereins direkt auf deiner Website.

## 安装

 1. Upload the plugin files to `/wp-content/plugins/badhub-widget/`, or install via**
    Plugins  Add New** and search for “Badhub Widget”
 2. Activate the plugin
 3. Go to **Settings  Badhub Widget**
 4. Enter your API key (free at [plugin.badhub.de](https://plugin.badhub.de))
 5. Select your federation and club
 6. Add `[badhub_widget]` to any page or post

## 常见问题

### Where do I get an API key?

Visit [plugin.badhub.de](https://plugin.badhub.de) and register for free. You will
receive your API key by email immediately.

### Is the plugin free?

Yes. The free tier includes the full league table with the “Powered by badhub.de”
badge. A Pro upgrade (no badge, priority support) is available for a small annual
fee.

### Which federations are supported?

Currently supported: BVBB, BVRP, HBV, BWBV, BBV, NBV. More federations are being
added.

### The widget shows nothing / an error — what do I do?

 * Make sure your API key is entered correctly under **Settings  Badhub Widget**
 * Check that the API key is registered for your website’s domain
 * Make sure you have selected your federation and club

### Can I use the widget without WordPress?

Yes. Visit [plugin.badhub.de](https://plugin.badhub.de) to generate a script tag
embed code that works on any website.

### Can I display multiple widgets on one page?

Yes. Each `[badhub_widget]` shortcode generates an independent iframe. You can use
different `pool_id` or `type` attributes for each.

## 评价

此插件暂无评价。

## 贡献者及开发者

「Badhub Widget」是开源软件。 以下人员对此插件做出了贡献。

贡献者

 *   [ badhub ](https://profiles.wordpress.org/badhub/)

[帮助将「Badhub Widget」翻译成简体中文。](https://translate.wordpress.org/projects/wp-plugins/badhub-widget)

### 对开发感兴趣吗?

您可以[浏览代码](https://plugins.trac.wordpress.org/browser/badhub-widget/)，查看
[SVN仓库](https://plugins.svn.wordpress.org/badhub-widget/)，或通过[RSS](https://plugins.trac.wordpress.org/log/badhub-widget/?limit=100&mode=stop_on_copy&format=rss)
订阅[开发日志](https://plugins.trac.wordpress.org/log/badhub-widget/)。

## 更新日志

#### 0.2.0

 * “Prüfen” button next to API key field — auto-fills the registered federation 
   and club, locks them for free/pro keys (federation tier still has full freedom).
   Lock now persists across saves (15-min transient cache, server-side rendered)
 * Fixed critical PHP TypeError when saving settings without selecting all fields(
   sanitize callbacks now accept null/empty values)
 * New “Transparent background” option (`transparent="1"` shortcode attribute) —
   widget background becomes transparent so the host page background shows through;
   theme (light/dark/auto) still drives text and border colours
 * New API endpoint `/api/v1/key-info` returns tier, federation and registered club
   for the calling key

#### 0.1.0

 * Initial release
 * League table widget (shortcode + Gutenberg block)
 * Match schedule widget (`type="matches"`)
 * Combined table + schedule widget (`type="combined"`)
 * Dark mode and auto theme support
 * Promotion/relegation markers and club logo display
 * Federation mode for federation websites
 * Live preview in plugin settings

## 额外信息

 *  版本 **0.2.0**
 *  最后更新：**4 天前**
 *  活跃安装数量 **不到10**
 *  WordPress 版本 ** 5.8 或更高版本 **
 *  已测试的最高版本为 **6.9.4**
 *  PHP 版本 ** 8.1 或更高版本 **
 *  语言
 * [English (US)](https://wordpress.org/plugins/badhub-widget/)
 * 标签
 * [badminton](https://cn.wordpress.org/plugins/tags/badminton/)[club](https://cn.wordpress.org/plugins/tags/club/)
   [schedule](https://cn.wordpress.org/plugins/tags/schedule/)[sport](https://cn.wordpress.org/plugins/tags/sport/)
   [table](https://cn.wordpress.org/plugins/tags/table/)
 *  [高级视图](https://cn.wordpress.org/plugins/badhub-widget/advanced/)

## 评级

尚未提交反馈。

[Your review](https://wordpress.org/support/plugin/badhub-widget/reviews/#new-post)

[查看全部评论](https://wordpress.org/support/plugin/badhub-widget/reviews/)

## 贡献者

 *   [ badhub ](https://profiles.wordpress.org/badhub/)

## 支持

有话要说吗？是否需要帮助？

 [查看支持论坛](https://wordpress.org/support/plugin/badhub-widget/)