Sports Standings and Rankings Tables

Sports Standings & Rankings Tables

Turn a plain list of results into a polished league table or ranking. Give it the numbers you have — wins, draws, losses, goals — and it works out the rest: matches played, differences, points, winning percentage, games behind, the order of the teams and their movement, with recent form shown as coloured badges.

• The six rulesets
• Quick start
• The header row
• Football (Soccer)
• Basketball
• Volleyball
• Handball
• Generic standings
• Rankings
• Recent form
• Zones: title, qualification, relegation
• Highlighting a team
• Team logos
• Ruleset options
• Languages
• Colours and styling
• Header key reference

The six rulesets

Pick the ruleset for your sport. They share one design; each has its own accent colour.

Each ruleset comes with a sample data source, so you can see it working straight after importing.

Quick start

1. Prepare your data as a table or CSV file. The first row names what each column holds, using the short keys described below (team, w, d, l, …).
2. Apply the ruleset for your sport to it, the same way as any other Tabulizer ruleset.
3. That's it: missing values are calculated, and the teams are put in order and ranked.

For example, this is all a football table needs:

team,w,d,l,gf,ga,form
Panathinaikos,5,0,0,12,2,WWWWW
PAOK,4,0,1,12,5,WWLWW
AEK,3,2,0,13,3,WDWDW

and it becomes a table with the columns # · Team · P · W · D · L · GF · GA · GD · Pts · Form — matches played, goal difference, points and the positions are worked out for you.

The header row

The first row is not shown as data. Each of its cells tells the ruleset what that column contains:

• Keys are not case sensitive: team, Team and TEAM are the same. Spaces, dashes, dots and underscores are ignored, so Goals For works as well as goals_for.
• Common alternative names are understood: club, country, player or name for the team; played, gp or mp for matches played; won, drawn, lost; and so on. The full list is in the reference.
• The order of your columns does not matter: the table always shows them in the standard order for the sport.
• You do not need every column. Columns you leave out are simply not shown — unless they can be calculated from the others.
• Columns the ruleset does not recognise are ignored, so your file can hold extra information.

If your data has a rank column, the positions you give are kept, and so is your order. Without it, the teams are ordered and numbered for you. A team tied with another on every criterion stays in the order it had in your data.

Football (Soccer)

Order: points, then goal difference, then goals scored.

team,w,d,l,gf,ga,form
Panathinaikos,5,0,0,12,2,WWWWW
PAOK,4,0,1,12,5,WWLWW
AEK,3,2,0,13,3,WDWDW
OFI,3,1,1,8,4,WWDWL

Basketball

Order: winning percentage, then wins, then fewer losses, then point differential.

team,w,l,pf,pa,home,away,form,streak
Detroit Pistons,60,22,9254,8872,31-10,29-12,WWLWW,W3
Boston Celtics,56,26,9130,8764,30-11,26-15,WWWWW,W2
New York Knicks,53,29,9042,8815,30-10,23-19,WLWWW,L1

Volleyball

Order: points, then wins, then set ratio, then point ratio.

team,w,l,sf,sa,pf,pa,pts,form
France,9,1,28,8,812,672,27,WWWWW
Poland,8,2,26,10,788,690,24,WWLWW
Italy,7,3,24,13,760,701,22,WLWWW

Handball

The same columns and order as football, with handball's points: 2 for a win, 1 for a draw.

team,w,d,l,gf,ga,form
Olympiacos,11,1,0,352,281,WWWWW
AEK Athens,10,0,2,340,290,WWLWW
PAOK,8,2,2,331,300,WDWWL

Generic standings

For any other sport — water polo, hockey, rugby, e-sports, a local league. It shows whichever of these columns your data has: rank, team, p, w, d, l, gf, ga, gd, pf, pa, diff, winpct, pts, form, streak.

• Matches played are calculated from w + d + l, or w + l for sports without draws; goal and point differences from their for/against columns.
• Points are not calculated, because every sport counts them differently — include a pts column, or tell the ruleset your points system with win_points, draw_points and loss_points in the ruleset options.
• Order: points (then wins and differences) when there are points; otherwise wins, then fewer losses.

team,w,d,l,pts,form,streak
Falcons,8,1,1,25,WWDWW,W2
Tigers,7,2,1,23,WWWDW,W1
Eagles,6,2,2,20,LWWDW,W1

Rankings

For national team, player, club or federation rankings.

Movement is shown as ▲ 2 for a team that climbed, ▼ 1 for one that dropped, and — when unchanged. If you supply the movement column yourself, use a number (+2, -1, 0).

team,pts,prev_rank
Poland,412.4,1
Italy,398.1,3
France,392.7,2
Brazil,361.9,4

Recent form

The form column shows recent results as coloured badges: W win, D draw, L loss. Write them oldest first; the most recent result, the last one, gets a ring around it.

All of these are understood:

WWDWL
W,W,D,W,L
W W D W L
W-W-D-W-L
win, win, draw, win, loss
ΝΝΙΗΝ          (Greek: Ν νίκη, Ι ισοπαλία, Η ήττα)

T (tie) counts as a draw. A value the ruleset cannot read is shown exactly as written.

The streak column (for example W3 or L1) is coloured green for a winning streak and red for a losing one.

Zones: title, qualification, relegation

League tables often colour the places that matter. A zone draws a coloured bar at the start of the row and colours the position number:

• green — title, promotion, play-offs
• blue — qualification, European places, play-in
• red — relegation, play-outs

In the data: a zone column

Add a zone column and write the zone next to each team that has one. The column itself is not shown; whatever you write becomes the tooltip on the position, so you can use your competition's own names:

team,w,d,l,gf,ga,zone
Panathinaikos,5,0,0,12,2,Champions League
PAOK,4,0,1,12,5,Europa League
AEK,3,2,0,13,3,Conference League
OFI,3,1,1,8,4,
Volos,0,2,3,4,9,Relegation

These words choose the colour: champions, champions league, title, promotion, play-offs, up for green; relegation, relegated, play-outs, down for red. Any other text — Europa League, Play-in, Qualification — is blue. You can also write the colour itself: green, blue or red.

Because the zone belongs to the team, it follows the team wherever it finishes.

In the ruleset: by position

To colour places by position instead, add promote, qualify and relegate to the ruleset options: promote=1;qualify=3;relegate=2 colours the leader green, the next three blue and the last two red. A zone in the data still wins for its row.

Highlighting a team

On a club's own site, make its row stand out: add highlight=Team name to the ruleset options. The row gets a light yellow background and the team name is shown in bold. Highlight several teams by separating them with |: highlight=PAOK|Aris. Upper and lower case do not matter.

Team logos

A logo appears next to the team name, never instead of it. There are two ways to add them:

A logo column

Give each team the address of its image. The column itself is not shown.

team,logo,w,d,l
Arsenal,/images/logos/arsenal.png,8,1,1
Chelsea,/images/logos/chelsea.svg,7,2,1

A folder of logos

Put the images in one folder, named after the team in lower case with dashes instead of spaces — Manchester United becomes manchester-united.png — and add logos=1;logo_path=/images/logos/ to the ruleset options (and logo_ext=svg if they are not PNG files). Use the path as your site's visitors see it, including any sub-folder your site lives in.

The folder can also be set for the whole site, in PHP: define('TABULIZER_SPORTS_LOGO_PATH', '/images/logos/');

Ruleset options

Each ruleset tells the table which sport it is with a modification rule such as:

sportstables$sport=football

Add options after it, separated by semicolons. Edit the ruleset in Tabulizer and change the value of its modification rule — or better, copy the ruleset first and change the copy, so that updating this ruleset archive does not overwrite your settings.

sportstables$sport=football;promote=1;qualify=3;relegate=2;highlight=PAOK

Languages

The column headings follow your site's language. English and Greek are included; any other language uses English. Hover over a heading to see the full name of the column (GD — Goal difference).

To add a language, copy templates/tabulizer/language/sportstables.en.ini to a file named with your language's two-letter code, for example sportstables.de.ini for German, and translate the text in quotes. Keep the keys on the left unchanged and in capitals.

GD="TD"
GD_TITLE="Tordifferenz"

Colours and styling

Every table has the same clean design: a coloured header, alternating row shading, the points column emphasised, and differences coloured green or red. On phones, the position and team stay in view while the rest of the table scrolls sideways.

The colours are CSS variables, so you can change them in your template's CSS without touching the ruleset. For example, to give the football table your club's colours:

table.tabtable-rs_sportstables_1 {
    --st-accent: #8b0000;                       /* header */
    --st-accent-soft: rgba(139, 0, 0, .07);     /* points column */
    --st-highlight: #ffe4e4;                    /* highlighted team */
}

Other variables: --st-win, --st-draw, --st-loss (form and differences), --st-promote, --st-qualify, --st-relegate (zones), --st-stripe, --st-hover, --st-line and --st-radius. Every cell's content carries a class naming its column (st-team, st-pts, st-form, …) for anything more specific.

Header key reference