- 2026-07-23
- by LethaldiranMX
- Trends
- 0 Comments
LethaldiranMX Insight
Soccr offers a highly efficient, block-based solution for WordPress site owners looking to integrate real-time football data without the typical performance bloat of heavy iframe embeds or client-side JavaScript. By leveraging server-side rendering and a structured, multi-tiered caching strategy, it bridges the gap between dynamic sports data and optimal Core Web Vitals. This plugin is particularly valuable for sports bloggers, local fan clubs, and regional news portals that need reliable, automated German and European football statistics directly within the block editor. Its developer-friendly architecture, including custom filter hooks, ensures it can adapt to niche leagues beyond the default configurations.
Best Fit & Operational Role: This plugin is an ideal fit for WordPress sites built on modern block themes that require lightweight sports integration. It solves the operational headache of manually updating league tables and match scores by pulling directly from OpenLigaDB. Because it renders entirely server-side and utilizes a built-in image proxy with caching for team crests, it fits seamlessly into high-traffic environments where frontend performance and page-load speeds are critical. It is best suited for publishers targeting German-centric competitions but can easily scale via filters for developers managing custom sports portals.
Potential Limitations & Pitfalls: While the plugin is highly optimized, its reliance on a third-party API (OpenLigaDB) introduces an external dependency; any downtime or schema changes on their end will directly impact data rendering, though the built-in caching (up to 24 hours) mitigates immediate frontend breakage. Additionally, because it relies on server-side rendering, sites without object caching or page caching might experience minor TTFB (Time to First Byte) spikes when the cache expires and a block triggers a fresh API request. Finally, expanding beyond the default German leagues requires writing custom PHP filters, which might limit non-technical users who want to display niche international competitions out of the box.
Display football match results, standings, and upcoming matches from OpenLigaDB as Gutenberg blocks.
Soccr integrates live football data from OpenLigaDB 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
Tabelle (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.
Spieltag (Group Matches)
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-Spiel (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/icons. 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:
-
- Bundesliga (bl1)
-
- Bundesliga (bl2)
-
- Liga (bl3)
- Frauen-Bundesliga (fbl1)
-
- Frauen-Bundesliga (fbl2)
- UEFA Champions League (ucl)
- DFB-Pokal (dfb)
Additional leagues can be added via the soccr_league_shortcuts filter. 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;
});
Features
- Three ready-to-use Gutenberg blocks
- Server-side rendering — no JavaScript required on the frontend
- Configurable caching (1 hour for matches and standings, 12 hours for matchday data, 24 hours for teams and leagues)
- 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. 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', 'dfb'])soccr_team_match_html— Modify the Team Match block HTML outputsoccr_group_matches_html— Modify the Group Matches block HTML outputsoccr_group_matches_headline— Modify the Group Matches headline text
Available actions:
soccr_exception— Triggered on API or rendering errors; use for custom error logging
Editorial note: This overview combines WordPress.org official plugin metadata with an AI-assisted LethaldiranMX editorial review. Plugin data should be verified on the official WordPress.org listing before installation.
