Event List

The [event_list] shortcode displays events from a SportsPress Calendar as a sortable, paginated table with columns for date, event name (or home/away teams), time/results, venue, league, season, article, and match day.

What It Displays

A data table of events. Columns shown depend on the Calendar's column configuration and the columns parameter override. Results or time are shown in a combined or separate format depending on the time_format and title_format settings.

When to Use It

Use on any page or post. Supply id to pull events from a specific Calendar. Without id, the shortcode falls back to get_the_ID() and will look for a Calendar post with that ID — it is most useful when placed on a Calendar's own page (inside the Loop) or with an explicit id.

Parameters

Parameter	Type	Default	Description
`id`	integer	`null`	Post ID of the SportsPress Calendar to display.
`title`	string/boolean	`false`	Override the displayed heading. `false` uses the Calendar's caption or title when `show_title` is `1`.
`status`	string	`'default'`	Event status filter: `'default'`, `'future'`, or `'publish'`.
`format`	string	`'default'`	Event format filter.
`date`	string	`'default'`	Date preset filter.
`date_from`	string	`'default'`	Start of date range (YYYY-MM-DD).
`date_to`	string	`'default'`	End of date range (YYYY-MM-DD).
`date_past`	string	`'default'`	Days in the past to include.
`date_future`	string	`'default'`	Days in the future to include.
`date_relative`	string	`'default'`	Relative date mode.
`day`	string	`'default'`	Match day filter.
`league`	integer/string	`null`	League term ID or slug.
`season`	integer/string	`null`	Season term ID or slug.
`venue`	integer/string	`null`	Venue term ID or slug.
`team`	integer	`null`	Team post ID to filter events.
`teams_past`	integer	`null`	Filter to include past teams.
`date_before`	string	`null`	Exclude events after this date.
`player`	integer	`null`	Player post ID to filter events.
`number`	integer	`-1`	Maximum number of events to display. `-1` shows all.
`columns`	string/array	`null`	Comma-separated column slugs to override the Calendar's column selection (e.g. `'event,time,venue'`).
`order`	string	`'default'`	Sort order: `'ASC'` or `'DESC'`.
`show_team_logo`	boolean	From settings	`1` to display team logos in the event column.
`link_events`	boolean	From settings	`1` to link event dates/titles to event pages.
`link_teams`	boolean	From settings	`1` to link team names to team pages.
`link_venues`	boolean	From settings	`1` to link venue names.
`sortable`	boolean	From settings	`1` to enable client-side column sorting.
`responsive`	boolean	From settings	`1` to enable responsive table mode.
`scrollable`	boolean	From settings	`1` to enable horizontal scrolling on narrow screens.
`paginated`	boolean	From settings	`1` to paginate the table.
`rows`	integer	From settings	Rows per page when pagination is active. Default `10`.
`show_all_events_link`	boolean	`false`	`1` to show a "View all events" link below the table (requires `id`).
`show_title`	boolean	From settings	`1` to display the Calendar name as a heading above the table.
`title_format`	string	From settings	Column layout: `'title'` (event title), `'teams'` (stacked team names), or `'homeaway'` (separate home/away columns).
`time_format`	string	From settings	Time/results column format: `'combined'`, `'separate'`, `'time'`, or `'results'`.

Usage Examples

Minimal — all events from a specific calendar:

[event_list id="30"]

Future events only, team names linked, paginated with 5 rows per page:

[event_list id="30" status="future" link_teams="1" paginated="1" rows="5"]

Home/away format, with logos and a "View all events" link:

[event_list id="30" title_format="homeaway" show_team_logo="1" show_all_events_link="1"]