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 latest version of this plugin uses an API into the England Hockey Azure data warehouse of GMS data. You must have permission from EH GMS support to embed GMS data on your club website.

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.

Once installed use the plugin settings for help understanding the features provided:

  • Full control of table styling using CSS
  • Display fixtures, results and league tables separately
  • Select the fixtures and results for a specific team and competition
  • Filter using whatson to only include upcoming fixtures or recent results
  • Change the order of fixtures and results to show by start time on given day or reverse the default date order
  • Server side caching of GMS data to provide performance benefits

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

  • [gms team="31c4b1d8-ef73-40ee-a09a-1817ec821524" whatson=14] – Show the fixtures (default) over the next 14 days for the team with the id specified.
  • [gms method="api" show="league+results" comp_id="6e16da76-87a3-4092-9f53-71d500fffcdb" team="31c4b1d8-ef73-40ee-a09a-1817ec821524" sort_by="reverseDate"] – Show league table for the competition and results for the team specified with most recent result first.
  • [gms method="api-dynamic" show="results" whatson=14 options="showList:auto"] – Show the results in the last fortnight for the club (default) with a filter to select results, fixtures and league tables by team.
  • [gms club_id="19fd1b0c-e11c-46f9-9114-45c2262a1e90" sort_by="fixtureTime" options="showGender:yes"] – Show the fixtures (default) for the next match day, for all teams in the club specified, ordered by start time, with a suffix to indicate team gender.
  • [gms show="results" whatson=7 team="31c4b1d8-ef73-40ee-a09a-1817ec821524" link="https://london.englandhockey.co.uk/teams/old-kingstonian-mens-o50-mens"] – Show the results in last week for the team specified and provide a link to an external site.
  • [gms show="teams" club_id="19fd1b0c-e11c-46f9-9114-45c2262a1e90"] – List all teams in club with external links to England Hockey.

For help generating GMS shortcodes you must use the following tool 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, Team and Club Identifiers?

To show league tables you need to find the numeric identifier used by the GMS data warehouse for the competition. Similiarly to show fixtures and results for a team you need to find the ID used for the team. To show match day fixtures for a club you need to find the ID for the club.

For help generating GMS shortcodes you must use the following tool Generate Shortcode.

The tool to generate shortcodes provides a search/lookup button to help you find the numeric IDs required. The lookup will help you find the IDs based on the names of the areas, competition groups, competitions and teams.

What happens if the GMS system changes?

The β€œapi” method should become stable but as it has only been available for one season changes are expected.

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

Read all 1 review

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

3.18

  • Fix to display player role on fixture detail
  • Technical upgrade to error handling

3.17

  • Fix to England Hockey links
  • Tweak to message when no fixtures/results found
  • Added option to filter by home, away and gender for club wide fixtures
  • Technical upgrade to error handling

3.16

  • Fix to sort team form correctly when multiple competitions
  • Tweaks to custom league / competition summary when only one team
  • Show season for competitions listed by filter
  • Fix for compatibility with PHP 8.2

3.15

  • Show as list option added to custom league
  • League column titles responsive to screen size
  • Change to default CSS for custom league list view

3.14

  • Added club team fixtures button to fixture detail
  • Change to default CSS for club team fixtures button
  • Optimisation of caching for custom league table and fixture details
  • Default setting for β€œUse AJAX (Javascript)” in now β€œYes”
  • When AJAX option is β€œNo” can override on individual shortcode with method=”ajax”
  • Fix to transient expiry when viewing multiple match days for club

3.13

  • Fix fault with back button on fixture detail
  • Added showGender option to custom league table

3.12

  • Capability to show custom league table for selected teams
  • Extra cancel button to go back from fixture details
  • Change to default CSS for custom league table and cancel button
  • Tweak to message display on network failures

3.11

  • Added links for Google Maps, Waze and Apple Maps in fixture details
  • Added competition name to fixture detail
  • Tweak to fixture detail address format
  • Change to default CSS for media query and map links

3.10

  • Added option to click through to fixture details
  • Added status to fixture card e.g. for walkover and shootout result
  • Change to default CSS for fixture details
  • Fix to filter when selecting club team in multiple competitions

3.9

  • Added option to provide link to WebCal with club teams list

3.8

  • Added show as list option for fixtures and results
  • Change to default CSS for list view

3.7

  • Fix to not add gms-draw class to postponement
  • Tweak to consistently not show bye fixtures
  • Tweak to cache expiry for static data

3.6

  • Fix to default settings
  • Fix to class for combined fixtures and results

3.5

  • Deal with previous season competition in dynamic filter
  • Tweak to whatson calculation
  • Clicking on club team will show league with results and default whatson
  • Uncheck league when all club teams selected
  • Tweak to messages when no data found and when filter changed
  • Change to default CSS for gms-clubteam

3.4

  • Show gender option for club teams
  • Fix to whatson select when switching teams

3.3

  • Added position to league table
  • Change to default CSS for gms-table-league
  • Allow click on club team with dynamic filter

3.2

  • Tweak to what’s on select text
  • Hide filter labels for small screens
  • Change to default CSS to remove overqualified classes
  • Hide competition list filter if club wide
  • Remove gms-clubteam class for team fixtures

3.1

  • Combine fixtures and results into single table
  • Tweak to table footnotes and error messages
  • Tweak to dynamic method when team parameter specified

3.0

  • Deprecated parse method removed
  • Added dynamic method for club with filter to select results, fixtures and league tables by team
  • Change to default CSS for new dynamic filter
  • Added option to show a table of club teams with links to England Hockey
  • Remove table footnote message when no external link