Results Matrix Layout
The Matrix format is a Pro feature added by the SportsPress Results Matrix module. It displays a grid of head-to-head results between all teams in the calendar, with home teams on rows and away teams on columns.
This feature is part of SportsPress Pro.
How It Looks
The matrix is an HTML table:
The top-left header cell shows Home \ Away as a label.
Each column header shows an away team (logo or abbreviation).
Each row header shows a home team (logo or name).
The intersection cell for a home team and away team contains the result(s) of their match(es). Results are color-coded by outcome (win, draw, loss) using the colors assigned to each outcome in the SportsPress configuration.
Diagonal cells (where home and away are the same team) are empty.
Cells where no match has been played show a dash (—).
When multiple matches exist between the same pair of teams, all results appear in the same cell side by side.
Results link to the individual event page when Link events is enabled.
Matrix Settings
Global matrix settings live at Events > Settings, under the Results Matrix section.
Date Format
Date Format (sportspress_event_matrix_date_format, default: M j) — PHP date format string used to display dates for scheduled (future) events that have no result yet. For example, M j produces "Apr 25".
Teams
Display logos (sportspress_event_matrix_show_logos, default: off) — show team logo images (featured images) in the column and row headers instead of abbreviations/names.
Team Selection
The matrix uses teams from two sources in priority order:
Teams explicitly assigned to the calendar in the Team selector of the calendar's Details meta box.
If no teams are assigned, the matrix falls back to all teams associated with the calendar's selected leagues and seasons.
Shortcode
[event_matrix id="42"]
The id parameter is required to specify which calendar's event data and team selection to use.
Parameter | Default (setting key) | Description |
| (empty) | Calendar post ID |
|
|
|
|
| Date filter value |
|
| PHP date format for future event cells |
|
|
|
| site setting |
|
| site setting |
|
|
|
|