🎯 Need Help?

Get Premium Support

Priority assistance from the developer

⬆️ Upgrade

Unlock all features

More from ANWP

Sports Leagues Premium

Multi-sport league management with advanced statistics

Learn more →

AnWP SL Theme Kit

Starter themes & block patterns for Sports Leagues

Learn more →

Referees Stats Shortcode

Pro Feature

Display referee statistics rankings showing cards given, fouls called, and per-game averages. Perfect for referee analysis pages, season reviews, or competition statistics sections.

Referees stats shortcode - a sortable table of officials with games refereed and the yellow cards, red cards and fouls they awarded

Premium Feature

This shortcode requires the Football Leagues Premium plugin.

Basic Usage

[anwpfl-referees-stats competition_id="12"]

This displays referee statistics for all referees in competition 12.

All Parameters

Query Parameters

Parameter Default Description
competition_id (empty) Competition ID
season_id (empty) Season ID
league_id (empty) League ID
show_secondary 1 Include secondary stages (multistage competitions). Use 0 to disable
limit 0 Maximum referees to show (0 = all)

Note

By default, show_secondary="1" includes all stages of multistage competitions. The Competition Selector only shows main stages. To get statistics for a specific stage (knockout or playoff), enter the stage ID manually in competition_id and set show_secondary="0".

Filter Parameters

Parameter Default Description
filter_by_clubs (empty) Only matches involving these clubs
home_club (empty) Only matches with this home club
away_club (empty) Only matches with this away club
filter_by_matchweeks (empty) Filter by matchweeks (comma-separated)
date_from (empty) Start date (YYYY-MM-DD)
date_to (empty) End date (YYYY-MM-DD)

Display Parameters

Parameter Default Description
show_games 1 Show games column. Use 0 to hide
show_rc 1 Show red cards column. Use 0 to hide
show_fouls 1 Show fouls column. Use 0 to hide
home_away 1 Show home/away breakdown. Use 0 to hide
per_game 1 Show per-game averages. Use 0 to hide
profile_link 1 Link referee names. Use 0 to disable
header (empty) Custom header text
order (empty) Sorting order as column,direction pairs – 1,asc, or 2,desc;1,asc to sort on two columns

Examples

Example 1: Competition Referee Rankings

When to use: Main referee statistics page.

[anwpfl-referees-stats competition_id="12" profile_link="1"]

Result: All referees ranked with full stats and profile links.

Example 2: Cards-Only View

When to use: Focus on disciplinary actions.

[anwpfl-referees-stats competition_id="12" show_fouls="0" home_away="0"]

Result: Simplified view showing only cards given.

Example 3: Season Overview

When to use: Cross-competition referee stats.

[anwpfl-referees-stats season_id="5" header="2024/25 Referee Statistics"]

Result: All referee stats across the season.

Example 4: Club-Specific Analysis

When to use: How referees have officiated a specific club’s matches.

[anwpfl-referees-stats competition_id="12" filter_by_clubs="8" header="Referees in Our Matches"]

Result: Stats from matches involving club 8 only.

Tip

Use the home_away="1" option to see if referees show any bias toward home or away teams in their card distribution.

Troubleshooting

No data showing?

  • Verify referees are assigned to matches
  • Check that match events include referee card data

Related