CozyStay Documentation

Sync bookings with Apple Calendar

April 9, 2024

Intro

Starting with version 1.4, CozyStay supports synchronizing room bookings with OTA via iCal. In this tutorial, we will introduce how to synchronize the reservations on your website to Apple Calendar, and how to synchronize the reservations in Apple Calendar to your website.

Please note that to sync booking data, your WordPress site must be online and public at the same time:

  • Your WordPress site cannot be in a local development environment.
  • Your WordPress site must be live (not in maintenance mode), and the calendar must be accessible via URL (cannot be accessed only by logged-in users of your WordPress site).

Sync Bookings to Apple Calendar

Please follow the steps below:

  1. Get your calendar URL: On your WordPress website dashboard, please navigate to Rooms > iCal Sync > In the “Sync Calendars” tab, find the “Export” column.
  2. Click the “Export Calendar” button of a room. Copy the room’s calendar URL in the pop-up window.
  3. Launch Apple Calendar on your MacBook. Click “File” > “New Calendar Subscription“.
  4. Paste the calendar URL you just copied from your WordPress site and click “Subscribe“.
  5. Then enter a “Name” for the calendar, and set the “Auto-refresh” interval.
  6. Imported calendars will appear in your Apple Calendar. Double click on each item to view details.

Export Bookings from Apple Calendar to WordPress Site

This tutorial contains the following two parts:

  • Part #1 – Create a new Calendar in your Apple Calendar and add bookings to it;
  • Part #2 – Add the calendar URL of this newly created Apple Calendar to your WordPress site

Create a new Calendar and add bookings to it

Please follow the steps below:

  1. Launch Apple Calendar on your MacBook. Click “File” > “New Calendar“.
  2. The newly created calendar will show in the left toolbar, enter a name for it.
  3. In the Month view of the Apple calendar, select the dates you want to mark as booked. In the pop-up window, add a title for the booking, select dates, add some information/description, and select the new calendar you just created.
  4. Please note that when selecting dates, the check-out date needs to be excluded. For example, if you check in on April 29, 2024 and check out on May 1, 2024, your stay will be two nights on the 29th and 30th. When creating a booking in Apple Calendar, the dates selected should be the 29th to the 30th.
  5. You can repeat step 3 to add multiple bookings to the calendar.

Add the calendar URL of this newly created Apple Calendar to your WordPress Site

Please follow the steps below:

  1. In the left toolbar of your Apple Calendar, find the newly created calendar and right-click on it, select “Share Calendar“.
  2. Tick the checkbox of “Public Calendar” and click “Done“.
  3. Right-click on the calendar again and select “Get Info“.
  4. Copy the URL.
  5. After copying the calendar URL, log into your WordPress website dashboard, navigate to Rooms > iCal Sync > In the “Sync Calendars” tab, find the “Import” column.
  6. Click the “Import Calendar” button of a room, in the pop-up window, paste the copied URL into the first field (Please note: You need to replace “webcal” at the beginning of the copied link with “https”), and enter a name for this external calendar. Then click “Add Calendar” to save this external calendar. Please note that this calendar has only been saved at this time and has not yet been synchronized.
  7. You will then see the new external calendar added. Click the name of the calendar to open a pop-up window to modify the information. Click the “Sync” button to synchronize the data in the external calendar.
  8. You can view all imported bookings in the “Imported Bookings” tab. And view detailed logs of each synchronization process in the “Logs” tab.
Close
Close