iCal and Feed Integration
Every calendar post in SportsPress exposes an iCal feed that external calendar applications can subscribe to. The feed updates automatically whenever events are added or changed.
Feed Links in the Admin
When editing a calendar post, the Feeds meta box (on the right side of the editor) shows three ready-to-use subscription links:
Apple Calendar — a
webcal://URL that macOS Calendar and iOS Calendar open directlyOutlook — a
webcal://URL for Microsoft OutlookGoogle — a
webcal://URL prefixed withhttp://www.google.com/calendar/render?cid=so that clicking it opens the Google Calendar "Add by URL" dialog
Each link is displayed as both a clickable icon and a read-only text input you can copy.
Feed URL Format
The raw feed URL is:
https://example.com/calendar-slug/?feed=sp-ical
Where calendar-slug is the permalink of the calendar post. The feed=sp-ical query parameter triggers the iCal feed template.
The feed outputs a text/calendar response with the filename <post-slug>.ics.
What the Feed Contains
Each event in the calendar becomes one VEVENT block in the iCal output:
SUMMARY — the event title, or a score string (e.g. "Home FC 2 Away FC 1") when results are available
DTSTART — the event's scheduled date and time
DTEND — calculated by adding the event's Full Time duration (in minutes) to the start time; defaults to 90 minutes if not set
LOCATION — the venue name and address (from
sp_address), if the event has a venue assignedGEO — latitude and longitude (from
sp_latitudeandsp_longitude), if coordinates are stored on the venueDESCRIPTION — the event's post content (body text)
UID — the WordPress post ID
The calendar header includes X-WR-CALNAME and X-WR-CALDESC set to the calendar post title, and TZID / X-WR-TIMEZONE set to the WordPress timezone setting.
Subscribing in Apple Calendar
In the Feeds meta box, copy the Apple Calendar link.
In Apple Calendar, choose File > New Calendar Subscription.
Paste the URL and click Subscribe.
Set the auto-refresh interval and click OK.
Alternatively, click the link icon directly — macOS will open Calendar automatically and prompt you to subscribe.
Subscribing in Google Calendar
In the Feeds meta box, copy the Google link.
Click the link or paste it into a browser. Google Calendar opens the "Add calendar" screen with the URL pre-filled.
Click Add calendar.
Google Calendar re-fetches the feed periodically (typically every 24 hours; the feed requests a 2-minute refresh interval via REFRESH-INTERVAL;VALUE=DURATION:PT2M but Google does not honor this).
Subscribing in Outlook
In the Feeds meta box, copy the Outlook link.
In Outlook, choose File > Account Settings > Account Settings, then the Internet Calendars tab, and click New.
Paste the URL and click Add.
For Outlook on the web, use Add calendar > Subscribe from web and paste the URL.