Description
Match Results for snooker.org API fetches snooker match data from the Snooker.org API and caches it to improve performance.
This plugin does not connect to the external API until the user explicitly provides their Header Value (X-Requested-By), which is obtained by contacting the Snooker.org webmaster.
It displays previous, current, and upcoming matches using tabs with AJAX loading for a smooth user experience.
The plugin reduces API calls and speeds up your site by caching data temporarily.
Privacy
This plugin connects to the external API at Snooker.org only after the user provides the required Header Value (X-Requested-By). No personal data is collected, stored, or sent by this plugin.
Features
- Fetch match data from Snooker.org API.
- Show Previous, Current, and Upcoming matches.
- Smooth AJAX-powered tab switching.
- Lightweight caching system to minimize API calls.
- Easy-to-use shortcode:
[match_results_for_snooker_org_api]. - Cron-based caching for efficient performance.
- Admin settings page for entering API Header Value.
Notes
- Cached data expires every 10 minutes for recent matches and every week for long-term data.
- AJAX is used for smooth tab switching without reloading the page.
- Ensure your server can execute WP-Cron events for scheduled updates.
Support
For bug reports or feature requests, please open an issue on GitHub: https://github.com/novakurosevic/match-results-for-snooker-org-api/issues
Author
Novak Urošević
GitHub | LinkedIn
Important:
To use this plugin, you must request an API Header Value (X-Requested-By) by emailing webmaster@snooker.org.
Once received, enter this value in the plugin settings.
License
This plugin is licensed under the GPLv2 or later. See LICENSE.md for details.
Screenshots
Installation
- Download the plugin zip file or clone the repository to your local machine.
- In your WordPress admin, go to Plugins > Add New.
- Click Upload Plugin and upload the zip file.
- Click Install Now, then Activate the plugin.
- Go to Settings > Match Results for snooker.org API to configure the required API Header Value (X-Requested-By).
- Add the shortcode
[match_results_for_snooker_org_api]to any post, page, or widget to display match data.
FAQ
-
How do I get the API Header Value (X-Requested-By)?
-
You must email the Snooker.org webmaster at
webmaster@snooker.orgto request access. -
How do I display the matches on my site?
-
Use the shortcode
[match_results_for_snooker_org_api]in any post, page, or widget. -
Can I customize the display of matches?
-
Currently, the plugin uses a tabbed interface with default styling. You can override the CSS by enqueueing your own styles in your theme.
Reviews
There are no reviews for this plugin.
Contributors & Developers
“Match Results for snooker.org API” is open source software. The following people have contributed to this plugin.
ContributorsTranslate “Match Results for snooker.org API” into your language.
Interested in development?
Browse the code, check out the SVN repository, or subscribe to the development log by RSS.
Changelog
1.5
- Removed img, js and css directories from assets directory and set them to plugin root directory
1.4
- Fixed error in walkover message
- Fixed error in displaying powered by logo
1.3
- Unified all cron hook names so that scheduled events, activation, and deactivation hooks use consistent naming.
- Added
mrfs_prefix to all methods in MRFSSnookerOrgApiClient, including cron handlers and HTML output generation. - Updated the shortcode to use the new
mrfs_prefixed method for generating output. - Ensured all include files are correctly loaded and exist.
- Fixed minor naming inconsistencies to improve readability and maintainability of the plugin code.
- Overall code structure cleaned for better clarity and easier future updates.
1.2
- Removed «plugin» from plugin name everywhere.
- Changed links in file description.
- Changed slug name from snooker_org_plugin to match_results_for_snooker_org_api
- Changed screenshot images to resolution 1200px x 900px
- Added
mrfs_prefix to many functions, JS code, and cache key names.
1.1
- Added optional display of «supported by Snooker.org» logo at bottom of results display.
1.0
- Initial release.
- AJAX-based tab loading for matches.
- Lightweight caching system.
- Shortcode functionality.





