Event Calendar
The [event_calendar] shortcode displays a monthly grid calendar showing which days have events. Days with events are linked; clicking a day with a single event goes directly to that event, while a day with multiple events links to the day archive. Previous/next month navigation is provided.
What It Displays
A month-view calendar grid with the month name and year as caption. Days that have events are highlighted and linked. Navigation arrows in the footer allow moving between months.
When to Use It
Place on any page, post, or widget. id is optional — when supplied it filters the calendar to events belonging to that SportsPress Calendar post. Without id, all events site-wide are shown.
Parameters
Parameter | Type | Default | Description |
| integer |
| Post ID of a SportsPress Calendar to filter events. |
| string |
| Event publish status filter. |
| string |
| Event format filter (e.g. a custom format slug). |
| string |
| Date filter preset. |
| string |
| Start date for a date range (YYYY-MM-DD). |
| string |
| End date for a date range (YYYY-MM-DD). |
| string |
| Number of days in the past to include. |
| string |
| Number of days in the future to include. |
| string |
| Relative date mode. |
| string |
| Match day filter. |
| integer/string |
| League term ID or slug to filter by. |
| integer/string |
| Season term ID or slug to filter by. |
| integer/string |
| Venue term ID or slug to filter by. |
| integer |
| Team post ID to filter events. |
| integer |
| Player post ID to filter events. |
| boolean |
|
|
| string |
| HTML tag used to wrap the month/year heading. |
| boolean |
|
|
| boolean |
|
|
Usage Examples
Minimal — all events for the current month:
[event_calendar]
Events from a specific calendar, filtered to a league and season:
[event_calendar id="30" league="5" season="8" show_all_events_link="1"]
Calendar showing only a team's events with abbreviated weekday headers:
[event_calendar team="12" initial="0"]
