Match Results for snooker.org API

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

  • Tabbed interface showing Previous, Current, and Upcoming matches.
  • Seamless AJAX content loading for tabs.
  • Plugin settings page for entering API Header Value.

Installation

  1. Download the plugin zip file or clone the repository to your local machine.
  2. In your WordPress admin, go to Plugins > Add New.
  3. Click Upload Plugin and upload the zip file.
  4. Click Install Now, then Activate the plugin.
  5. Go to Settings > Match Results for snooker.org API to configure the required API Header Value (X-Requested-By).
  6. 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.org to 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.

Contributors

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.