Title: Matchball – Standings & Tables for SAMS Author: renao Published: October 15, 2026 Last modified: October 15, 2026 --- Search plugins ![](https://ps.w.org/matchball-for-sams/assets/icon-256x256.png?rev=3749249) # Matchball – Standings & Tables for SAMS By [renao](https://profiles.wordpress.org/renao/) [Download](https://downloads.wordpress.org/plugin/matchball-for-sams.3.0.1.zip) * [Details](https://wordpress.org/plugins/matchball-for-sams/#description) * [Reviews](https://wordpress.org/plugins/matchball-for-sams/#reviews) * [Installation](https://wordpress.org/plugins/matchball-for-sams/#installation) * [Development](https://wordpress.org/plugins/matchball-for-sams/#developers) [Support](https://wordpress.org/support/plugin/matchball-for-sams/) ## Description Matchball – Standings & Tables for SAMS provides two Gutenberg blocks for sports websites: * Standings block (league table) * Results block (finished matches) Data is fetched from a SAMS API source and cached via WordPress transients. A 5- minute WP-Cron sync keeps data fresh, while fallback cache protects frontend output during API issues. Source code: https://github.com/renao/matchball-for-sams External service usage: * This plugin connects to a SAMS REST API endpoint configured by the site administrator. * The official SAMS REST API documentation is published by the provider at: https:// wiki.sams-server.de/wiki/REST-API-Schnittstelle * According to the provider documentation, API keys are issued by the relevant association support contact for intended API access. * Requests include an API key in the HTTP header X-Api-Key. * The provider documents a general rate limit of 5 requests per second and a daily limit per key. The plugin reduces request volume by using transients and a 5- minute sync interval. * No visitor personal data is transmitted by default. Service terms and privacy: * Use of the external SAMS service is subject to the policies and operating rules of the respective association or operator. * Site administrators are responsible for using valid API credentials and complying with the provider rules for the configured endpoint. ## Screenshots [⌊Backend output: standings table and results with settings sidebar⌉⌊Backend output: standings table and results with settings sidebar⌉[ Backend output: standings table and results with settings sidebar [⌊Standings block example from the frontend⌉⌊Standings block example from the frontend⌉[ Standings block example from the frontend [⌊Results block example from the frontend⌉⌊Results block example from the frontend⌉[ Results block example from the frontend ## Blocks This plugin provides 2 blocks. * Matchball Standings * Matchball Results ## Installation 1. Upload the plugin folder to /wp-content/plugins/ or install the ZIP via Plugins > Add New > Upload Plugin. 2. Activate Matchball – Standings & Tables for SAMS in the WordPress admin. 3. Open SAMS Sources in admin and add at least one source (base URL and API key). 4. Insert a Standings or Results block in Gutenberg and configure source, season, and league. ## FAQ ### Where do I obtain an API key? API keys are issued by the relevant regional association or operator of the configured SAMS endpoint. The official provider documentation states that access keys are granted by the association support contact. ### Does the plugin need cron? Yes. WP-Cron is used for regular data refresh every 5 minutes. ### Where are API keys stored? API keys are stored in WordPress options and encrypted at rest. ### What happens if the API is unavailable? The plugin shows cached data and a “last updated” hint instead of failing hard. ### Where can I find the official API documentation? The provider documentation is available at https://wiki.sams-server.de/wiki/REST- API-Schnittstelle . ## Reviews There are no reviews for this plugin. ## Contributors & Developers “Matchball – Standings & Tables for SAMS” is open source software. The following people have contributed to this plugin. Contributors * [ renao ](https://profiles.wordpress.org/renao/) [Translate “Matchball – Standings & Tables for SAMS” into your language.](https://translate.wordpress.org/projects/wp-plugins/matchball-for-sams) ### Interested in development? [Browse the code](https://plugins.trac.wordpress.org/browser/matchball-for-sams/), check out the [SVN repository](https://plugins.svn.wordpress.org/matchball-for-sams/), or subscribe to the [development log](https://plugins.trac.wordpress.org/log/matchball-for-sams/) by [RSS](https://plugins.trac.wordpress.org/log/matchball-for-sams/?limit=100&mode=stop_on_copy&format=rss). ## Changelog #### 3.0.1 * Bundled German (de_DE) translations for admin screens, blocks and the editor #### 3.0.0 * Initial public release with Standings and Results blocks * 5-minute sync with WP-Cron * Encrypted API key storage * Graceful fallback on API errors ## Meta * Version **3.0.1** * Last updated **4 days ago** * Active installations **Fewer than 10** * WordPress version ** 6.0 or higher ** * Tested up to **7.1.3** * PHP version ** 7.4 or higher ** * Tags * [api](https://wordpress.org/plugins/tags/api/)[gutenberg](https://wordpress.org/plugins/tags/gutenberg/) [results](https://wordpress.org/plugins/tags/results/)[sports](https://wordpress.org/plugins/tags/sports/) [standings](https://wordpress.org/plugins/tags/standings/) * [Advanced View](https://wordpress.org/plugins/matchball-for-sams/advanced/) ## Ratings No reviews have been submitted yet. [Your review](https://wordpress.org/support/plugin/matchball-for-sams/reviews/#new-post) [See all reviews](https://wordpress.org/support/plugin/matchball-for-sams/reviews/) ## Contributors * [ renao ](https://profiles.wordpress.org/renao/) ## Support Got something to say? Need help? [View support forum](https://wordpress.org/support/plugin/matchball-for-sams/)