Fixtures and Results

Version: 3.5.5

Record and display fixtures (upcoming matches) and results for Gaelic games and related sports: football (Gaelic), hurling, camogie, and handball, plus Rugby Union (totals and league tables). 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

1. [frp-formations]
2. [frp-fixtures]
3. [frp-resultsyear]
4. [frp-archive]
5. [frp-club]
6. [frp-rugby-league]

---

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.
   The main plugin file is wp-frp.php (WordPress convention). Upgrading from a very old package that used index.php: if the plugin shows as missing or invalid, go to Plugins, delete/deactivate that entry, then install this version and activate again — data in the database is unchanged by that step.

On activation, the plugin creates its own database tables (names start with frp_) and adds starter codes (Football, Hurling, Camogie, Handball, Rugby Union) 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).

---

Recommended setup order

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, Handball, or Rugby Union (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 — GAA codes: goals/points/overall as usual; Rugby Union: enter the total match points in Team 1 points and Team 2 points only (leave goals/overall at 0). Optional referee text
• 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.

When adding a match, the Competition list shows each name with its sport after an em dash (e.g. … — Rugby Union) and only competitions that match the Code you picked stay selectable—so rugby fixtures line up with a rugby competition.

---

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: date, time, venue, competition, Team 1, Team 2.
[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-club year="2026" team="5"]	Fixtures and/or results for one team across competitions (optional show).
[frp-rugby-league competition="12" year="2026"]	Rugby Union league table for one competition and year (4 pts win, 2 draw, losing bonus within 7; TB stays 0 until tries are stored per match). Optional code=”ID” overrides the sport code (defaults to Rugby Union).
[frp-archive]	A filterable archive by year, competition, and opposition (Team 2). After you click Filter, your choices stay selected on the reloaded page.
[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]].

---

Sidebar widgets

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. Scores follow the same rules as tables: Rugby Union matches show a single total per side; GAA codes show goals–points.
• 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 http:// 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; if Rugby Union is present in your codes, it also adds a small Rugby Demo competition and three finished matches. 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.

Database updates: The plugin compares its version to a stored value on each page load. If your files are newer, it runs migrations (new columns, new codes such as Rugby Union, etc.) automatically—usually you only need to open the WordPress dashboard once after uploading. You do not have to deactivate/reactivate for every small update, though re-activation is still safe if something looks out of date.

---

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, Handball, or Rugby Union per competition and match.

How do I add Rugby Union matches?

1. After updating the plugin, load any admin page once (migrations add Rugby Union to the code list). If it still does not appear under Competitions → Code, deactivate and reactivate the plugin once.
2. Under Competitions, add a competition and set Code to Rugby Union (and a grade, etc.).
3. Under Matches → Add new match, choose Rugby Union as Code, then pick that competition (the dropdown shows the sport after each name and only lists competitions that match the code). Enter total points in Team 1 points and Team 2 points; optional Referee.

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.5.5 — Rugby Union as a built-in code; optional referee on matches; rugby scores and league shortcode [frp-rugby-league]; admin match form hints and competition picker (sport shown, filtered by code); demo data can include a small rugby slice; automatic version-based migrations on load; [frp-archive] filters remember your selections after submit.
• 3.5.4 — [frp-fixtures] lists both Team 1 and Team 2 under Versus.
• 3.4.0 — Main plugin file is wp-frp.php only (no index.php); match datepicker years through current year + 10; re-activate if migrating from an index.php-based build.
• 3.3.0 — Demo data import/remove; uninstall cleanup; admin pagination fix on empty lists; widget hardening; plugin_dir_* URLs; maintenance SQL for MySQL 8+; README handbook and readme metadata.
• 3.2.1 — Pagination fixes for strict hosts; BOM; security/PSR-2 cleanup; pagination styles; PHP 7+ compatibility.
• 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

• Plugin URI: getbutterfly.com – Fixtures and Results
• Author: Ciprian Popescu

Licensed under the GNU General Public License v2 or later.

---

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.

[frp-formations]

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

[frp-fixtures]

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

[frp-resultsyear]

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

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

[frp-archive]

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

Filter archive: By year...2026 By competition...Cork Senior A Football Championship 2026Demo Rugby Union League 2026Ducon Cup Football 2026Duhallow Junior A Hurling Championship 2026Intermediate Football League 2026Junior A Hurling League 2026McCarthy Insurance Senior Football League Division 3 2026 By opposition...BanteerBishopstownCastlemagnerDemo River RFCDemo Valley RFCDouglasKanturkKiskeamLyreNewmarketRockchapel Filter

[frp-club]

Lists every match for one club in that year (all competitions and grades): upcoming fixtures and past results. Use the numeric team ID from Teams. Optional: show="fixtures", show="results", or show="all" (default).

Usage

• Both fixtures and results (default)
  [frp-club year="2026" team="12"]
  • year — competition year (same as on matches).
  • team — numeric team ID from Fixtures & Results → Teams (not the name).
• Only upcoming games
  [frp-club year="2026" team="12" show="fixtures"]
• Only finished games
  [frp-club year="2026" team="12" show="results"]

[frp-rugby-league competition="12" year="2026"]

No completed matches for this competition and year.