🎯 Need Help?

Get Premium Support

Priority assistance from the developer

⬆️ Upgrade

Football Leagues Premium

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 →

Players Shortcode


Display player statistics rankings – top scorers, assist leaders, and more. Perfect for showing leaderboards and competition statistics tables.

Basic Usage

[anwpfl-players competition_id="12" type="scorers" limit="10"]

This displays the top 10 goal scorers from competition 12.

All Parameters

Query Parameters

Parameter Default Description
type scorers Statistic type: scorers (goals) or assists
competition_id (empty) Competition ID(s). Comma-separated for multiple competitions
season_id (empty) Filter by Season ID
league_id (empty) Filter by League ID
club_id (empty) Filter by Club ID(s). Comma-separated for multiple
limit 0 Maximum players to show. Use 0 for unlimited
soft_limit yes Include ties at the limit boundary. Use no to cut off exactly at limit
join_secondary 0 Include secondary stages (multistage competitions). Use 1 to enable

Note

The Competition Selector only shows main stages. By default, only main stage statistics are included. To include all stages in a multistage competition, set join_secondary="1". To get statistics for a specific stage (knockout or playoff), enter the stage ID manually in competition_id.

Display Parameters

Parameter Default Description
layout default Display layout: default, small, or mini
show_photo yes Show player photos. Use no to hide
compact 0 Use compact spacing. Use 1 to enable
hide_zero 0 Hide players with 0 goals/assists. Use 1 to enable
penalty_goals 0 Show penalty goals separately. Use 1 to show
games_played 0 Show matches played column. Use 1 to show
games_played_text “Played” Column header text for matches played
group_by_place 0 Group players with same stats under one position. Use 1 to enable
secondary_sorting (none) Tiebreaker: less_games or less_penalty

Layout Comparison

Layout Best For Features
default Main content area Full width, large photos, club logos, all details
small Sidebars, secondary content Smaller photos, condensed layout
mini Widgets, tight spaces Minimal design, essential info only

The same top-eight scorers, rendered by each layout:

Default

Players shortcode, default layout - a top-scorers table with rank, photo, player name, club, nationality flag and goals

small

Players shortcode, small layout - the same top-scorers table with reduced row height and smaller photos

mini

Players shortcode, mini layout - a narrow sidebar-sized list of rank, player, club and goals with no photos or flags

Examples

Example 1: Top 10 Scorers

When to use: Competition page showing leading goal scorers.

[anwpfl-players competition_id="12" type="scorers" limit="10"]

Result: Top 10 scorers with photos, club logos, and goal counts.

Example 2: Assist Leaders

When to use: Show top assist providers alongside scorers.

[anwpfl-players competition_id="12" type="assists" limit="10"]

Result: Top 10 assist leaders from the competition.

Example 3: Sidebar Widget (Mini Layout)

When to use: Compact display for sidebars or homepage widgets.

[anwpfl-players competition_id="12" type="scorers" limit="5" layout="mini"]

Result: Condensed list of top 5 scorers.

Example 4: Single Club’s Top Scorers

When to use: On a club page showing their leading scorers.

[anwpfl-players competition_id="12" club_id="8" type="scorers" limit="5"]

Result: Top 5 scorers from club 8 in competition 12.

Example 5: Multiple Competitions Combined

When to use: Season summary across all competitions.

[anwpfl-players competition_id="12,15,18" type="scorers" limit="10"]

Result: Combined top scorers from multiple competitions.

Example 6: With Games Played and Penalty Details

When to use: Detailed statistics view showing efficiency.

[anwpfl-players competition_id="12" type="scorers" limit="20" games_played="1" penalty_goals="1"]

Result: Top 20 scorers with matches played and penalty goals shown separately.

Example 7: Tiebreaker Sorting

When to use: When you want efficiency to break ties.

[anwpfl-players competition_id="12" type="scorers" limit="10" secondary_sorting="less_games"]

Result: Players with equal goals are ranked by fewer games played (more efficient).

Tip

Use soft_limit="yes" (default) to include all players tied at the cutoff position. This prevents unfair exclusions when multiple players have the same stats.

Understanding Soft Limit

The soft_limit parameter controls how ties at the limit boundary are handled:

  • soft_limit=”yes” (default): If you set limit="10" and players 10, 11, and 12 all have 5 goals, all three are included
  • soft_limit=”no”: Exactly 10 players shown, even if it arbitrarily excludes tied players

Troubleshooting

No players showing?

  • Verify the competition has finished matches with goals scored
  • Check that goals are recorded in match events, not just the final score
  • If using hide_zero="1", players with 0 goals are hidden

Wrong player count?

  • soft_limit="yes" may include extra players with tied stats
  • Use soft_limit="no" for exact limits

Stats seem incorrect?

  • Goals must be recorded as match events (not just in the score)
  • Check join_secondary setting for multistage competitions
  • Clear the plugin cache: FL Settings & Tools > Toolbox > Clear Cache

Related