Back

Fixtures & Results – A ClassicPress/WordPress Plugin for Irish GAA


Warning: Undefined variable $display in /home/dh_hermina/dev.vault80.com/wp-content/plugins/wp-frp/index.php on line 227

Warning: Undefined variable $display in /home/dh_hermina/dev.vault80.com/wp-content/plugins/wp-frp/index.php on line 227

Warning: Undefined variable $limit in /home/dh_hermina/dev.vault80.com/wp-content/plugins/wp-frp/index.php on line 609

Fixtures and Results

Version: 3.3.0

Record and display fixtures (upcoming matches) and results for Gaelic games and related sports: football (Gaelic), hurling, camogie, and handball. Manage competitions, teams, venues, players, and formations (jersey layouts with subs) from the WordPress dashboard, then show them on your site with shortcodes and widgets.

Table of contents

  1. What you need
  2. Installation
  3. Where to find everything in the dashboard
  4. Recommended setup order
  5. Managing each area (plain English)
  6. Showing content on your website (shortcodes)
  7. Sidebar widgets
  8. Options, maintenance, and demo data
  9. Match reports, video, photos, and formations
  10. Tips for club secretaries
  11. Updating the plugin
  12. Removing the plugin completely
  13. Frequently asked questions

What you need

  • A WordPress site (or ClassicPress with a compatible version).
  • A user account with Administrator rights (or another role that can access Fixtures & Results in the admin menu).
  • No coding required for day‑to‑day use: add data in the admin and paste shortcodes into pages or posts.

Installation

  1. Upload the plugin folder (for example wp-frp) into your site’s wp-content/plugins/ directory.
  2. In the dashboard, go to Plugins, find Fixtures and Results, and click Activate.

On activation, the plugin creates its own database tables (names start with frp_) and adds starter codes (Football, Hurling, Camogie, Handball) and grades (Senior, Junior levels, underage grades, etc.). You do not need to create those from scratch.

Deactivating the plugin does not delete your data. Deleting the plugin from the Plugins screen (when your site offers an uninstall routine) can remove plugin data—see Removing the plugin completely.

Where to find everything in the dashboard

In the left-hand admin menu you will see Fixtures & Results (network icon). Open it to reach:

Submenu What it’s for
Fixtures & Results (first item) Overview: shortcode list, jersey preview, link to Demo data
Players List of player names (used when building formations and for suggestions)
Competitions Your competitions (e.g. county league, championship)
Competition stages Stages or rounds (e.g. League, Group stage, Final)
Matches Add and edit fixtures/results; filter the big list
Formations Starting 15 (or 12/13) plus subs; each gets an ID for shortcodes
Teams Club or county team names, home venue link, website
Venues Ground names and optional website
Options Club name for widgets/tables, rows per page, maintenance tools
Demo data Import or remove a full sample dataset (great for training or theme demos)

At the top of most list screens you can add a new record. In the table, click a name (or edit link) to change something, or use the trash icon to delete (you may be asked to confirm).

You can work in any order, but this flow avoids “empty dropdowns” when adding a match:

  1. Venues — pitches and halls you use often.
  2. Teams — each team can be linked to a default venue and optional website.
  3. Competition stages — e.g. League, Championship, Cup.
  4. Competitions — link each competition to a code (sport) and grade from the lists provided.
  5. Players (optional but useful) — names for squads and formation pickers.
  6. Formations — build a lineup; note the formation ID shown in the list.
  7. Matches — choose competition, stage, year, teams, date, time, venue, scores (for past games), and optional report links.

Managing each area (plain English)

Competitions

Each competition has a long name (full title) and short name (for tight spaces). You also choose:

  • Code — Football, Hurling, Camogie, or Handball (from the built‑in list).
  • Grade — Senior, Junior A, etc. (from the built‑in list).
  • Gender group — e.g. Male / Female, if you use that for your fixtures.

Competition stages

Simple labels such as League, Semi-final, County final. Matches will pick one stage per game.

Teams

Team name, venue (from your venues list), and optional homepage URL (club website).

Venues

Venue name and optional website (often the pitch location or booking page).

Players

Each player name must be unique in the database. The list helps when you build formations and keeps spelling consistent.

Formations

A formation is a visual lineup:

  • Each position uses jersey number and name, in the form: 15,Player Name (number, comma, name).
  • Subs is a free-text line (e.g. comma-separated names).
  • Templates support 12‑a‑side, 13‑a‑side, and 15‑a‑side (leave unused slots empty as explained on the form).

Important: The picture of jerseys on the front of the site comes from the shortcode [frp-formations id="…"], not from the match list automatically.

Matches

When adding or editing a match you choose:

  • Competition, code, grade, stage, year
  • Team 1 and Team 2
  • Date (calendar picker in admin) and time
  • Venue
  • Scores for finished games (goals/points as your code uses them)
  • Optional: replay, walkover, extra time, match report URL, video, photos
  • Formation ID — optional reference number if you use a saved formation for that game

The Matches screen can also filter the table (e.g. by year or competition). The Competition ID shown in the table is what you use in the [frp-resultsyear … competition="…"] shortcode.

Showing content on your website (shortcodes)

Edit any page or post (or block that supports shortcodes) and paste one of these:

Shortcode What it shows
[frp-fixtures] All upcoming fixtures (by date/time).
[frp-resultsyear year="2026"] Results from one calendar year.
[frp-resultsyear year="2026" competition="5"] Same, but only for one competition ID (see Matches admin).
[frp-archive] A filterable archive (similar idea to the admin match list filters).
[frp-formations id="3"] Jersey layout for formation ID 3 (replace 3 with your ID from Formations).

Note: Shortcodes use dashes, not spaces: [frp-fixtures], not [[frp fixtures]].

Go to Appearance → Widgets (or the block-based widget screen, depending on your theme).

  • F&R Latest Result — Shows the latest finished game. You can leave code/grade blank to use the latest match overall, or type values that match your Codes and Grades lists.
  • F&R Next Fixture — Shows the next upcoming match. Again you can leave fields blank for “next any”, or fill in custom opponent/venue/date/time for a static line.

The home club name used in some labels comes from Fixtures & Results → Options.

Options, maintenance, and demo data

Open Fixtures & Results → Options.

  • Home team or club name — Used in widgets and some match text (e.g. “vs” wording).
  • Results per page — How many rows appear before pagination on long lists (shortcodes/archives that paginate).

Maintenance (use carefully; usually after big clean-ups):

  • Clean up duplicate players — Merges duplicate names and can add a unique rule (database maintenance).
  • Clean up empty homepage values — Removes placeholder https:// links on teams/venues.
  • Optimise tables — Asks the database to tidy plugin tables.

Demo data (Fixtures & Results → Demo data):

  • Import demo data — Loads sample GAA-style clubs, venues, competitions, matches, two formations, and players so you can learn the plugin or test a theme. Re-importing replaces the previous demo import only (tracked rows).
  • Remove demo data — Deletes only the last demo import (not your own manual entries).

Match reports, video, photos, and formations

  • If you enter a match report URL on a match, the fixtures/results tables (from shortcodes) can show a Report link for that game.
  • Video and photos fields power the extra icons where the theme/plugin output supports them (e.g. in admin and front-end tables).
  • Jerseys, starting 15, and subs are not pulled from the match row for display: add [frp-formations id="X"] on a page where you want that graphic.

Tips for club secretaries

  1. One match at a time — Add the fixture first with time and venue; edit later to add scores and report link.
  2. Keep competition IDs handy — If you filter results on a page with competition="…", open Matches and note the ID in the competition column.
  3. Widget codes — Spell Code and Grade exactly as in the plugin lists (Football / Hurling and grade names).
  4. Year in shortcode — Use the same year you stored in the match (often the season year).
  5. Formation IDs change — After deleting formations, IDs shift; update shortcodes if you delete old lineups.

Updating the plugin

Replace the plugin files with the new version (FTP, hosting file manager, or your usual workflow). Your data stays in the database. If the author ships notes in /docs/, read them before upgrading.

Removing the plugin completely

  • Deactivate — Stops the plugin; data remains.
  • Delete from Plugins — If an uninstall.php file is present, WordPress may run it and remove plugin options and tables, which permanently deletes fixtures, teams, venues, etc. Export or back up first if you might need the data later.

Frequently asked questions

Why don’t I see a Report link on the front page?
The match probably has an empty match report field. Add a full URL (including https://) in the match editor.

Why is the formation not next to the score?
The plugin is designed so match tables and formations are separate: use a shortcode (or a second block) for [frp-formations id="…"] where you want the jersey graphic.

Can I use multiple sports?
Yes. Codes are built in; pick Football, Hurling, Camogie, or Handball per competition and match.

Does this work with page builders?
Usually yes, in a “Shortcode” or “HTML” block—paste the shortcode there.

Multisite?
The plugin can be used on multisite installs; options are per site unless your network setup shares tables (ask your host or admin).

Changelog (recent)

For a full historical changelog, see readme.txt in this folder. Summary of recent themes:

  • 3.2.1 — Pagination and compatibility fixes; PHP 7+ oriented cleanup.
  • 3.2.0 — Input sanitisation; admin notices; contributor/tags updates.
  • 3.1.x — Widget constructor updates; date/time UI updates.
  • 3.0.0 — Shortcode naming (use dashes); multisite-related fixes; schema updates.

Support and credits

Licensed under the GNU General Public License v2 or later.

This README is written for site owners and editors. Developers can inspect the plugin source and inline headers for hooks and implementation details.

Demo

This WordPress plugin stores competitions, matches, formations and players in a database for easy archiving and display of both retroactive and upcoming fixtures. The plugin is setup with preexisting codes (football, hurling, camogie, handball) and grades. Some of the sport codes are country-specific.

Displays a team formation using of the 2 possible templates (13-a-side and 15-a-side).
Replace 1 with the desired team formation ID from the Formations page inside the plugin administration area.

[frp-formations id="1"]

Cian O'Sullivan
Pádraig Murphy Seán McGrath Liam Ó Ceallacháin
Conor Walsh Aidan Creedon Fionn Ó Briain
Rory Buckley Tadhg Hegarty
Eoin Kelleher Donnacha Ryan Micheál Casey
Shane O'Connell Diarmuid Lynch Colm O'Flynn
Subs: R. Buckley, T. Hegarty, E. Kelleher, D. Ryan (panel subs — same squad as Players list)

Stephen O'Keeffe
Darragh Murphy Killian Walsh James Cronin
Neil O'Connor Brian Herlihy Mark Twomey
Denis McCarthy Paul Lucey
John Linehan David O'Riordan Alan Forde
Barry O'Leary Thomas Sheehan Kieran Brosnan
Subs: M. O'Donoghue, S. Creedon, K. Twomey, P. Lucey

Displays all upcoming/pending fixtures. Use this shortcode in a post or page.

Date Time Venue Competition Versus
20/04/202615:00Newmarket GAA GroundsCork SFC ARockchapel
27/04/202619:30Kiskeam GAA PitchLeague Div 3Newmarket
04/05/2026TBDNewmarket GAA GroundsDuhallow JAHCCastlemagner
11/05/202620:00Banteer GAA GroundsLeague Div 3Newmarket

Displays all results from a specific year. Replace 2026 with the desired year.

Date Venue Competition Versus Score Report
07/04/2026Kiskeam GAA PitchDucon CupKiskeam1-19 to 3-12Report
23/03/2026Banteer GAA GroundsDuhallow JAHCBanteer0-21 to 1-14Report
13/03/2026Lyre GAA FieldDucon CupLyre1-17 to 0-12Report
02/03/2026Newmarket GAA GroundsLeague Div 3Bishopstown2-14 to 1-10Report
10/02/2026Kanturk GAA GroundsJAHLKanturk2-20 to 2-19Report
18/01/2026Newmarket GAA GroundsLeague Div 3Newmarket0-11 to 1-15Report
14/09/2025Páirc Uí ChaoimhCork SFC ADouglas0-16 to 1-18Report

Use the competition ID from Competition (ID) (Stage) column in Matches section to filter results on posts and pages based on optional competition ID.

Date Venue Competition Versus Score Report

Displays a filterable matches archive, just like the one on Matches section.

Filter archive:

Date Venue Competition (Stage) Versus Score Report
11/05/2026Banteer GAA GroundsLeague Div 3 (League)Newmarket0-00 to 0-00
27/04/2026Kiskeam GAA PitchLeague Div 3 (League)Newmarket0-00 to 0-00
20/04/2026Newmarket GAA GroundsCork SFC A (Group Stage)Rockchapel0-00 to 0-00
02/03/2026Newmarket GAA GroundsLeague Div 3 (League)Bishopstown2-14 to 1-10Report
18/01/2026Newmarket GAA GroundsLeague Div 3 (League)Newmarket0-11 to 1-15Report
14/09/2025Páirc Uí ChaoimhCork SFC A (County Championship)Douglas0-16 to 1-18Report
04/05/2026Newmarket GAA GroundsDuhallow JAHC (Championship)Castlemagner0-00 to 0-00
07/04/2026Kiskeam GAA PitchDucon Cup (Ducon Cup)Kiskeam1-19 to 3-12Report
23/03/2026Banteer GAA GroundsDuhallow JAHC (Duhallow Championship)Banteer0-21 to 1-14Report
13/03/2026Lyre GAA FieldDucon Cup (Ducon Cup)Lyre1-17 to 0-12Report
10/02/2026Kanturk GAA GroundsJAHL (League)Kanturk2-20 to 2-19Report