Calendar subscriptions - Liturgical-Calendar/LiturgicalCalendarAPI GitHub Wiki

Using the endpoint as a calendar subscription URL for Calendar Apps

(See usage.php#calSubscription.)

GOOGLE CALENDAR ON A DESKTOP COMPUTER

Get the link for the desired calendar subscription from https://staging.johnromanodorazio.com/usage.php#calSubscription, and copy the link to the clipboard.

Navigate to https://calendar.google.com on a desktop computer.

At the bottom left corner of the screen, next to Other calendars, click on the + icon to add a new calendar, and choose From URL.

Paste in the URL that you copied earlier.

Once subscribed, your calendar will be populated with the events from the Liturgical Calendar.

Google Calendar will poll the calendar URL every 8 hours.

Since you have made a subscription, any updates in the Liturgical Calendar API will be propagated to your subscription.

You will only see events for the current year. On the first day of a new year however, new events will be created automatically for the new year.

Once the calendar has been added from a desktop, it will become available for the same Gmail account on the Google Calendar app on a smartphone.

CALENDAR APPS ON AN ANDROID DEVICE

If you have not yet added the calendar subscription from the desktop version of Google Calendar, please do so now (see Google Calendar).

Open the Google Calendar app.

Go to Settings, then under the account which you used for the Desktop version, click on the Calendar subscription name.

Make sure Synchronization is turned on.

Once subscribed, your calendar will be populated with the events from the Liturgical Calendar.

Google Calendar will poll the calendar URL every 8 hours.

Since you have made a subscription, any updates in the Liturgical Calendar API will be propagated to your subscription.

You will only see events for the current year. On the first day of a new year however, new events will be created automatically for the new year.

IPHONE

Get the link for the desired calendar subscription from https://staging.johnromanodorazio.com/usage.php#calSubscription, and copy the link to the clipboard.

Go to Phone Settings → Accounts → Add account → Other → Add Calendar.

Paste in the URL that you copied earlier.

Once subscribed, your calendar will be populated with the events from the subscription URL.

The iPhone Calendar app will poll the calendar URL based on the settings at Phone Settings → Accounts → Fetch New Data → Fetch.

Since you have made a subscription, any updates in the Liturgical Calendar API will be propagated to your subscription.

You will only see events for the current year. On the first day of a new year however, new events will be created automatically for the new year.

MICROSOFT OUTLOOK

(tested with Outlook 2013)

Get the link for the desired calendar subscription from https://staging.johnromanodorazio.com/usage.php#calSubscription, and copy the link to the clipboard.

At the bottom of the screen, switch from Email view to Calendar view.

On the ribbon of the Home menu item, click on Open calendar → From the internet.

Paste in the URL that you copied earlier.

On the following screen, check the checkbox along the lines of "Poll this calendar in the interval suggested by the creator".

Outlook Calendar should now poll the calendar URL once a day.

Once subscribed, your calendar will be populated with the events from the Liturgical Calendar.

Make sure the Calendar is created in the Other calendars folder; if you find it under the Personal calendars folder, drag it and drop it onto the Other calendars folder, so as to ensure that it is treated as a subscription internet calendar.

You can manually fetch new data by clicking on Send/receive all (from the SEND/RECEIVE menu item).

Outlook Calendar supports a minimal amount of HTML in the event description, so the event descriptions for the Liturgical Calendar are a little bit more "beautified" for Outlook.

Since you have made a subscription, any updates in the Liturgical Calendar API will be propagated to your subscription.

You will only see events for the current year. On the first day of a new year however, new events will be created automatically for the new year.