Title: Soccr
Author: rockschtar
Published: <strong>2010 年 10 月 28 日</strong>
Last modified: 2026 年 7 月 23 日

---

搜尋外掛

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

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

# Soccr

 由 [rockschtar](https://profiles.wordpress.org/rockschtar/) 開發

[下載](https://downloads.wordpress.org/plugin/soccr.2.0.6.zip)

 * [詳細資料](https://tw.wordpress.org/plugins/soccr/#description)
 * [使用者評論](https://tw.wordpress.org/plugins/soccr/#reviews)
 *  [安裝方式](https://tw.wordpress.org/plugins/soccr/#installation)
 * [開發資訊](https://tw.wordpress.org/plugins/soccr/#developers)

 [技術支援](https://wordpress.org/support/plugin/soccr/)

## 外掛說明

**Soccr** integrates live football data from [OpenLigaDB](https://www.openligadb.de)
into the WordPress block editor. The plugin provides three fully configurable Gutenberg
blocks for displaying match results, league standings, and team-specific match information—
all server-side rendered and cached for performance.

#### Blocks

**Standings**
 Displays a full league table for a selected league and season. The
table shows position, team name, matches played, wins, draws, losses, goals, goal
difference, and points. The league and season can be selected directly in the block
inspector.

**Matchday**
 Displays all matches for a specific matchday. Automatically shows 
the current matchday by default. Includes optional pagination to browse through 
all matchdays of a season. Matches are grouped by date and show kickoff times for
upcoming games and final scores for finished ones.

**Team Match**
 Displays a match for a specific team. Three display modes are available:
current match (next upcoming or last finished), next match, or last match. Optionally
shows team crests. The team can be selected from a list of all teams in the chosen
league.

#### Supported Leagues

By default, the following leagues and competitions from OpenLigaDB are available:

 * 1. Bundesliga (bl1)
 * 2. Bundesliga (bl2)
 * 3. Liga (bl3)
 * 1. Frauen Bundesliga (fbl1)
 * 2. Frauen Bundesliga (fbl2)
 * UEFA Champions League (ucl)
 * UEFA Europa League (uel)
 * UEFA Conference League (uecl)
 * DFB-Pokal (dfb)

Additional leagues can be added via the `soccr_league_shortcuts` filter — see the
_For Developers_ section for an example.

#### Features

 * Three ready-to-use Gutenberg blocks
 * Server-side rendering — no JavaScript required on the frontend
 * Built-in caching (1 hour for match and standings data, up to 24 hours for teams,
   leagues, and crests)
 * Alignment support (left, center, right, wide, full) for all blocks
 * Optional custom block title for each block
 * Team crest display with built-in image proxy and caching
 * Pagination for matchday browsing

#### Data Attribution

All data is provided by **OpenLigaDB** under the [Open Database License (ODbL) v1.0](https://opendatacommons.org/licenses/odbl/).
Each block automatically displays the required attribution notice.

By using this plugin, your WordPress site will make requests to `https://api.openligadb.
de`. No personal user data is transmitted to OpenLigaDB.

#### For Developers

Available filters:

 * `soccr_league_shortcuts` — Customize which leagues are available in the block
   inspector (default: `['bl1', 'bl2', 'bl3', 'fbl1', 'fbl2', 'ucl', 'uel', 'uecl','
   dfb']`)
 * `soccr_team_match_html` — Modify the Team Match block HTML output
 * `soccr_group_matches_html` — Modify the Matchday block HTML output
 * `soccr_group_matches_headline` — Modify the Matchday block headline text
 * `soccr_team_icon_url` — Modify the team crest URL before it is proxied
 * `soccr_league_season_display` — Modify how the season is displayed alongside 
   the league name (default: `2025/2026`)

Example — adding leagues via `soccr_league_shortcuts`. Use any shortcut available
on OpenLigaDB:

    ```
    add_filter('soccr_league_shortcuts', static function (array $shortcuts): array {
        $shortcuts[] = 'uefaeuro2024'; // UEFA Euro 2024
        $shortcuts[] = 'wm2022';       // FIFA World Cup 2022
        return $shortcuts;
    });
    ```

Available actions:

 * `soccr_exception` — Triggered on API or rendering errors; use for custom error
   logging

## 適用於區塊編輯器

這個外掛提供 3 個可供 Gutenberg/區塊編輯器使用的區塊。

 *   Soccr Matchday OpenLigaDB matchday
 *   Soccr Team Match Next, current or last match of a team from OpenLigaDB
 *   Soccr Standings OpenLigaDB standings

## 安裝方式

 1. Install the plugin via _Plugins  Add New_ in your WordPress admin and activate 
    it.
 2. Add any of the three Soccr blocks via the block editor. The blocks are listed under
    the **Soccr** category in the block inserter.
 3. Select the desired league and season in the block inspector on the right-hand side.

## 常見問題集

### Which leagues are supported?

By default, the German men’s and women’s Bundesliga divisions, the 3. Liga, the 
UEFA club competitions, and the DFB-Pokal are available — see the description for
the full list. Any other league available on OpenLigaDB can be added using the `
soccr_league_shortcuts` filter.

### Is an API key required?

No. OpenLigaDB is a free, open service and does not require registration or an API
key.

### Why does the block show outdated data?

The plugin caches API responses as transients. Match and standings data is cached
for 1 hour. If you need to refresh data immediately, clear the cached data with `
wp transient delete --all` on the command line. If your site uses a persistent object
cache, flush it with `wp cache flush` instead.

### Can I add custom styles?

Yes. All blocks use BEM-style CSS classes prefixed with `wp-block-soccr-` (e.g.,`.
wp-block-soccr-standings`, `.wp-block-soccr-team-match`, `.wp-block-soccr-group-
matches`). You can target these classes in your theme’s stylesheet.

### Are team crests displayed?

The Team Match block optionally displays team crests sourced from OpenLigaDB and
Wikimedia Commons. The crest display can be toggled in the block inspector. Images
are proxied through WordPress to avoid mixed-content issues and cached for 24 hours.

## 使用者評論

![](https://secure.gravatar.com/avatar/c8aca693c38cd2c8d22c180be8f0a8ba117ca7fa281f858f5e61e76afe6bdcc1?
s=60&d=retro&r=g)

### 󠀁[Perfekt!](https://wordpress.org/support/topic/perfekt-43/)󠁿

 [ArcherTC](https://profiles.wordpress.org/archertc/) 2016 年 11 月 24 日

On the http://www.volk-ohne-raumdeckung.de site, where there is one widget for FCN
and one for Schalke. Works well with 4.6.1. It would be great if several clubs could
be shown in the same widget instead of needing multiple separate ones, but NO COMPLAINT
🙂 Vielen Dank für die Arbeit!

 [ 閱讀全部 1 則使用者評論 ](https://wordpress.org/support/plugin/soccr/reviews/)

## 參與者及開發者

以下人員參與了開源軟體〈Soccr〉的開發相關工作。

參與者

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

[將〈Soccr〉外掛本地化為台灣繁體中文版](https://translate.wordpress.org/projects/wp-plugins/soccr)

### 對開發相關資訊感興趣？

任何人均可[瀏覽程式碼](https://plugins.trac.wordpress.org/browser/soccr/)、查看 
[SVN 存放庫](https://plugins.svn.wordpress.org/soccr/)，或透過 [RSS](https://plugins.trac.wordpress.org/log/soccr/?limit=100&mode=stop_on_copy&format=rss)
訂閱[開發記錄](https://plugins.trac.wordpress.org/log/soccr/)。

## 中繼資料

 *  版本 **2.0.6**
 *  最後更新 **2 週前**
 *  啟用安裝數 **10+**
 *  WordPress 版本需求 ** 7.0 或更新版本 **
 *  已測試相容的 WordPress 版本 **7.0.2**
 *  PHP 版本需求 ** 8.4 或更新版本 **
 *  語言
 * [English (US)](https://wordpress.org/plugins/soccr/)
 * 標籤:
 * [bundesliga](https://tw.wordpress.org/plugins/tags/bundesliga/)[football](https://tw.wordpress.org/plugins/tags/football/)
   [fussball](https://tw.wordpress.org/plugins/tags/fussball/)[soccer](https://tw.wordpress.org/plugins/tags/soccer/)
 *  [進階檢視](https://tw.wordpress.org/plugins/soccr/advanced/)

## 評分

 5 星，滿分為 5 星

 *  [  1 個 5 星使用者評論     ](https://wordpress.org/support/plugin/soccr/reviews/?filter=5)
 *  [  0 個 4 星使用者評論     ](https://wordpress.org/support/plugin/soccr/reviews/?filter=4)
 *  [  0 個 3 星使用者評論     ](https://wordpress.org/support/plugin/soccr/reviews/?filter=3)
 *  [  0 個 2 星使用者評論     ](https://wordpress.org/support/plugin/soccr/reviews/?filter=2)
 *  [  0 個 1 星使用者評論     ](https://wordpress.org/support/plugin/soccr/reviews/?filter=1)

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

[查看全部使用者評論](https://wordpress.org/support/plugin/soccr/reviews/)

## 參與者

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

## 技術支援

使用者可在技術支援論壇提出意見反應或使用問題。

 [檢視技術支援論壇](https://wordpress.org/support/plugin/soccr/)

## 贊助

想要支援這個外掛的發展嗎？

 [ 贊助這個外掛 ](https://github.com/rockschtar/soccr)