
Calendar Feeds tab (Pro)
Add ICS / webcal calendar feeds and holiday calendars, and how refreshing and caching work.
Events and holidays come only from calendar feeds. You do not type events into Joomla.
Adding a feed
For each feed:
- Feed URL — an
https://orwebcal://link to an.icsfeed. Secret calendar URLs are private: treat them like a password. - Label — shown on the feed's filter chip and in the event popup.
- Colour — the feed's dots, pills and chip: blue, green, purple, amber, grey, or a custom colour. Choose Holiday red for holiday calendars: those dates are filled in and the holiday name is shown instead of a dot.
- Enabled — switch a feed off without deleting it.
- Test feed — downloads the feed now and reports "✓ Found 24 events", or explains what went wrong.
Refresh interval — 15 minutes, 1 hour, 6 hours or 24 hours. Refresh now downloads every feed immediately, and "Last updated" shows the oldest successful download.
How to find your calendar feed URL
JoomClock needs the calendar's iCal / ICS address. It often ends in .ics or starts with webcal://.
Google Calendar
- On a computer, open Google Calendar, click the gear icon, then Settings.
- Under Settings for my calendars, click the calendar.
- For a public calendar, first tick Access permissions for events › Make available to public, then copy Public address in iCal format. For a private calendar copy Secret address in iCal format instead. Anyone with that link can read the calendar.
Outlook.com and Microsoft 365 (Outlook on the web)
- Go to Settings › Calendar › Shared calendars.
- Under Publish a calendar, choose the calendar and Can view all details, then Publish.
- Copy the ICS link. In Microsoft 365, your administrator may need to allow publishing.
Apple iCloud
- Mac: in Calendar, Control-click the calendar, choose Share Calendar…, tick Public Calendar and copy the
webcal://address. - iPhone or iPad: Calendar › Calendars › the ⓘ next to the calendar › turn on Public Calendar › Share Link… › Copy.
- iCloud.com: Calendar › the share icon next to the calendar › Public Calendar › Copy Link.
Paste the address into Feed URL and press Test feed.
Showing national holidays
Google publishes a public holiday calendar for most countries.
- In Google Calendar, next to Other calendars click + › Browse calendars of interest › Regional holidays, and add your country.
- Open that calendar's settings and copy Public address in iCal format. For example, United States holidays:
https://calendar.google.com/calendar/ical/en.usa%23holiday%40group.v.calendar.google.com/public/basic.ics - Add it in JoomClock with the colour Holiday red.
Holiday dates are filled in and the holiday name appears on hover (and inside the day in the large month view). Visitors can hide holidays with the Holidays filter chip. You can add several holiday feeds, each with its own label.
How feed refreshing works
- JoomClock downloads each feed on the server and keeps it for the refresh interval. After that, the next visitor who needs the calendar triggers a new download.
- If a download fails (service down, URL changed, network blocked), JoomClock keeps showing the last successful download, for up to 30 days, instead of an empty calendar.
- Changes in your calendar app appear after the next refresh. Some providers cache their own feeds: Google can take several hours to update a published ICS feed whatever interval you choose. Refresh now cannot make Google's copy newer.
- A page never waits for a calendar service. The visible month is included in the page when it is already downloaded; otherwise it loads in the visitor's browser a moment later, and you briefly see a loading state.
- Feed addresses are never sent to visitors' browsers. Only the events themselves are.
- Recurring events (weekly services, monthly meetings, exceptions and moved occurrences) are expanded for the months being viewed. All-day events stay on their own dates in every time zone.
For security, JoomClock fetches only public internet addresses (http, https, webcal). Addresses that point to this server or to a private network are refused.