Event Matrix
The [event_matrix] shortcode displays a head-to-head results grid between teams. Rows and columns both represent teams; each cell shows the result of the fixture between those two teams. This is sometimes called a "results matrix" or "cross-table."
Requires SportsPress Pro. The Results Matrix module must be enabled.
What It Displays
A scrollable grid table with teams on both axes. Each cell at the intersection of a row team and a column team displays the result of that fixture (linked to the event page when link_events is enabled). Cells on the diagonal (a team vs itself) are typically blank.
When to Use It
Embed on any page. Supply id pointing to a SportsPress Calendar post. The Calendar should be associated with a league/season so the correct set of teams can be determined. Without id, the shortcode uses get_the_ID().
Parameters
Parameter | Type | Default | Description |
| integer |
| Post ID of the SportsPress Calendar containing the events. |
| string |
| Event status filter: |
| string |
| Date preset filter. |
| string |
| Start of date range (YYYY-MM-DD). |
| string |
| End of date range (YYYY-MM-DD). |
| string |
| Days in the past to include. |
| string |
| Days in the future to include. |
| string |
| Relative date mode. |
| string |
| Match day filter. |
| integer/string |
| League term ID or slug. |
| integer/string |
| Season term ID or slug. |
| string | From settings | PHP date format for cell date display. Default from Results Matrix > Date Format setting ( |
| boolean | From settings |
|
| boolean | From settings |
|
| boolean | From settings |
|
| boolean | From settings |
|
| boolean |
|
|
Usage Examples
Minimal — matrix from a specific calendar:
[event_matrix id="30"]
Matrix filtered to a specific league and season, with team logos:
[event_matrix id="30" league="3" season="7" show_team_logo="1"]
Matrix with linked results and teams, scrollable:
[event_matrix id="30" link_events="1" link_teams="1" scrollable="1"]
