Hockey GMS Feed

Description

Use a shortcode to show fixtures, results and league tables from England Hockey Game Management System (GMS) in your posts and pages. The initial version of this plugin will embed content from the following web site GMS Match Site. You must have permission from EH GMS support to embed GMS Match Site content on your club website.

The current GMS Match Site is supposedly a temporary solution to show fixtures, results and league tables. It is hoped that once a permanent solution is found then either Widgets (custom HTML provided by England Hockey to be embedded on your site) or an API will be made available (and incorporated in later version of this plugin).

If you are looking for the features of this plugin but do not use WordPress then you may use this web service as an alternative GMS Feed.

Currently this plugin will embed GMS content using “parse” or “ajax” methods. When first activated this plugin will default to the “parse” method. Once installed use the plugin settings for help understanding and using the methods. The plugin provides a number of features:

  • Full control of table styling using CSS
  • Display fixtures, results and league tables separately
  • Filter fixtures and results to only include specific team name
  • Filter using whatson to only include upcoming fixtures or recent results
  • Server side parsing of HTML provides performance benefits through caching

Using this plugin allows fixtures, results and league tables to be included within posts or pages using a “gms” shortcode e.g.

  • [gms comp_id=1234567] – Show the fixtures for the competition with the id 1234567
  • [gms club_name="club name"] – Show the fixtures for all teams in a club
  • [gms comp_id=1234567 method="parse" team="team name"] – Show fixtures (default) for the team in the competition with the id 1234567
  • [gms comp_id=1234567 method="ajax" show="league+results"] – Show the league table and results for the competition with the id 1234567
  • [gms method="parse" whatson=14] – Show the fixtures (default) over the next 14 days, for all teams in your default club
  • [gms show="results" whatson=7] – Show the results in last week for all teams in your default club (assuming “parse” is your default method)

For help generating GMS shortcodes you may use the following page Generate Shortcode.

Installation

  1. For manual code install upload and extract the plugin to the /wp-content/plugins/ directory.
  2. Activate the plugin through the ‘Plugins’ menu in WordPress.
  3. Go to the settings page for this plugin from the ‘Plugins’ menu or the ‘GMS Feed’ menu item and follow the instructions on that page.

If you deactivate the plugin all settings will be retained until you uninstall (delete).

FAQ

How do I find the Competition ID for a team?

To show fixtures, results and league tables for any team in your club, you need to find the competition identifier.

  1. To find this go to the GMS Match Site
  2. Select your area
  3. Select a competition that a team from your club has entered

The URL in the browser search window will include a parameter called “comp”. The value of this “comp” should be used as the “comp_id” parameter in the shortcode. From the example URL below, you would extract the competition identifier as “comp_id=4137502”.

https://gms.englandhockey.co.uk/fixtures-and-results/competitions.php?comp=4137502

How do I find my Club Name used by the GMS?

  1. To find this go to the GMS Match Site
  2. Select your area
  3. Select a competition that one of your club teams has entered
  4. Then click on your team

The URL in the browser search window will include a parameter called “id”. The value of this “id” should be used as the club name. For example you may find a URL like the following:

https://gms.englandhockey.co.uk/fixtures-and-results/club.php?id=Old%20Kingstonian%20HC&prev=4137502

From the above example URL you would extract the club name as “Old%20Kingstonian%20HC” which you may enter as shown but also as “Old Kingstonian HC” or “Old+Kingstonian+HC”.

What happens if the temporary GMS changes?

The operation of the current “parse” and “ajax” methods depends both on the URLs used by the GMS Match Site not being changed, and the HTML identifiers for the tables remaining unchanged.

We anticipate and expect there to be changes, and hope for improvements or the release of additional capabilities such as “widgets” or a proper API to the GMS.

We aim to update this plugin as soon as changes are identified (whether they cause problems or enable improvements). You should find that the plugin degrades elegantly when problems arise. If you discover problems please check the plugin support forum and contact the plugin developer.

Reviews

There are no reviews for this plugin.

Contributors & Developers

“Hockey GMS Feed” is open source software. The following people have contributed to this plugin.

Contributors

Translate “Hockey GMS Feed” into your language.

Interested in development?

Browse the code, check out the SVN repository, or subscribe to the development log by RSS.

Changelog

1.2

  • Tweak to display of validation errors
  • Link to shortcode generator

1.1

  • Fix to find tables with parse/ajax method
  • Enqueue default style sheet
  • Disabled iFrame method (currently not working)

1.0

  • Initial release