{"id":1119,"date":"2025-06-30T21:28:21","date_gmt":"2025-06-30T19:28:21","guid":{"rendered":"https:\/\/quanticalabs.com\/docs\/chauffeur-booking-system\/?post_type=lsvr_kba&p=1119"},"modified":"2025-07-04T14:06:00","modified_gmt":"2025-07-04T12:06:00","slug":"icalendars-synchronization-with-external-calendars","status":"publish","type":"lsvr_kba","link":"https:\/\/quanticalabs.com\/docs\/chauffeur-booking-system\/knowledge-base\/icalendars-synchronization-with-external-calendars\/","title":{"rendered":"iCalendars – Synchronization with External Calendars"},"content":{"rendered":"
\n

Good to Know<\/strong><\/p>\n

iCalendars<\/a> is a separate add-on that extends the capabilities of the Chauffeur Taxi Booking System for WordPress plugin. To start using the add-on, make sure you have the latest version of the Chauffeur Taxi Booking System installed on your WordPress site.<\/p>\n<\/div>\n

iCalendars (Add-on) allows you to synchronize your Chauffeur Booking System calendar with external calendar systems supporting .ics files, such as Google Calendar, Outlook, Apple Calendar, and other applications that accept public ICS feeds. This ensures that vehicle availability stays up-to-date across different systems, preventing double bookings and improving operational efficiency for transport and chauffeur services.<\/p>\n

Accessing iCalendars<\/h2>\n

To configure synchronization, navigate to ‘Chauffeur Booking System’<\/mark> -> ‘iCalendars’<\/mark> menu. Here, you will see a list of all existing calendar synchronizations. To add a new synchronization, click ‘Add New iCalendar’<\/mark>.<\/p>\n

Creating a New Synchronization<\/h2>\n

On the synchronization setup page, enter a title in the ‘Add Title’<\/mark> field. Below, you will find several tabs to configure the synchronization.<\/p>\n

‘Main’ Tab<\/h2>\n

iCalendar ID<\/h3>\n

Displays the unique ID of the calendar.<\/p>\n

Vehicle<\/h3>\n

Select the vehicle from the dropdown list to synchronize its calendar. The synchronization applies to the calendar of the selected vehicle.<\/p>\n

‘Import’ Tab<\/h2>\n

The import section allows you to import data from external calendars. It offers two types of import – manual and scheduled.<\/p>\n

Manual import<\/strong> lets you upload a .ics file from an external calendar. This method is useful for one-time updates or testing synchronization. You simply select the file, upload it, and import the booking data into the system.<\/p>\n

Scheduled import<\/strong> automates the process using cron jobs, ensuring that vehicle availability stays updated without manual intervention. The system periodically fetches external .ics files and syncs reservations accordingly.<\/p>\n

‘Import’ -> ‘Manual’ Tab<\/h2>\n

Path to the File<\/h3>\n

Select a .ics file from an external calendar. Click ‘Browse’<\/mark> button, choose the file, and then click ‘Import’<\/mark> button to upload the data.<\/p>\n

Source ID<\/h3>\n

A unique identifier for the imported data (e.g., \u201coutlook-calendar\u201d). The system assigns events to this ID. If event removal is enabled, previously imported events with this ID will be deleted before new ones are imported.<\/p>\n

‘Import’ -> ‘Scheduled’ Tab<\/h2>\n

Cron Job Command<\/h3>\n

The command that must be added to the cron table on the server (e.g., in cPanel). Example command:<\/p>\n

* * 1 * * wget \"https:\/\/yourdomain.com\/chauffeur-booking-system\/?chbseic_run_code=AE625EBAA43ACFB2FCE6861293922C6E&chbseic_cron_event=3\"<\/code><\/pre>\n
\n
How to Set Up Cron in cPanel<\/strong><\/p>\n
Log in to cPanel. Go to ‘Cron Jobs’<\/mark>. Add a new cron job and set the execution interval. Copy and paste the command provided in the plugin.<\/p>\n<\/div>\n
Import URL Addresses<\/h3>\n
Add multiple URLs of external .ics files. The system will periodically fetch these files via cron and update vehicle availability.<\/p>\n
‘Import’ -> ‘Settings’ Tab<\/h2>\n
Remove Events<\/h3>\n
Enable\/disable removal of events with the same Source ID before importing new data.<\/p>\n
Current\/Future Events<\/h3>\n
Enable\/disable importing only current and future events (ignoring past events).<\/p>\n
‘Export’ Tab<\/h2>\n
The export section allows you to share vehicle availability data with external calendars. This can be done manually or via scheduled exports.<\/p>\n
‘Export’ -> ‘Manual’ Tab<\/h2>\n
Click the ‘Export’<\/mark> button to download the .ics file of the vehicle\u2019s calendar. You can upload this file to other systems or calendar apps that support iCalendar synchronization.<\/p>\n
‘Export’ -> ‘Scheduled’ Tab<\/h2>\n
The system generates an ICS file URL that can be copied and used in external calendar applications that support periodic ICS updates, such as Apple Calendar or Outlook.<\/p>\n
\n
How to Use the ICS File in Apple Calendar<\/strong><\/p>\n
Open Apple Calendar. Go to ‘File’<\/mark> -> ‘New Calendar Subscription’<\/mark>, paste the ICS URL and confirm. The application will periodically fetch updates from this feed.<\/p>\n
For more details, please refer to Apple Calendar documentation.<\/p>\n<\/div>\n
‘Export’ -> ‘Settings’ Tab<\/h2>\n
Current\/Future Events<\/h3>\n
Enable\/disable exporting only current and future events.<\/p>\n
Event summary and description<\/h3>\n
This section allows you to define a customized title (summary) and description for each exported event in the ICS file. These fields let you control how bookings from the Chauffeur Booking System will appear in external calendar applications. For example, you can include key booking details in the event name, making it easier to identify reservations directly from your calendar view.<\/p>\n
If either the summary or the description field is left empty, the system will use a default value instead.<\/p>\n
    \n
  • [chbs_pickup_location]<\/code> – pickup address<\/li>\n
  • [chbs_dropoff_location]<\/code> – drop-off address<\/li>\n
  • [chbs_pickup_date]<\/code> – date of pickup<\/li>\n
  • [chbs_pickup_time]<\/code> – time of pickup<\/li>\n
  • [chbs_vehicle_name]<\/code> – selected vehicle name<\/li>\n
  • [chbs_booking_sum_gross]<\/code> – total booking price<\/li>\n
  • [chbs_client_first_name]<\/code> – client\u2019s first name<\/li>\n
  • [chbs_client_last_name]<\/code> – client\u2019s last name<\/li>\n
  • [chbs_client_email_address]<\/code> – client\u2019s email<\/li>\n
  • [chbs_client_phone_number]<\/code> – client\u2019s phone number<\/li>\n
  • [chbs_comment]<\/code> – any comments from the client<\/li>\n<\/ul>\n
    ‘Events’ Tab<\/h2>\n
    This section displays a list of all imported events (blocked dates), with an option to manually remove them if needed.<\/p>\n
    ‘Logs’ Tab<\/h2>\n
    This section contains a record of system events, such as import\/export operations. The last 50 operations are displayed for review.<\/p>\n
    \n
    Summary<\/strong><\/p>\n
    Document version: 1.0
    \nLast updated: June 30, 2025
    \nPlugin version: 8.7+<\/p>\n<\/div>\n","protected":false},"excerpt":{"rendered":"
    Good to Know iCalendars is a separate add-on that extends the capabilities of the Chauffeur Taxi Booking System for WordPress plugin. To start using the add-on, make sure you have the latest version of the Chauffeur Taxi Booking System installed on your WordPress site. iCalendars (Add-on) allows you to synchronize your Chauffeur Booking System calendar […]<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"closed","ping_status":"closed","template":"","format":"standard","meta":{"footnotes":""},"lsvr_kba_cat":[20],"lsvr_kba_tag":[],"_links":{"self":[{"href":"https:\/\/quanticalabs.com\/docs\/chauffeur-booking-system\/wp-json\/wp\/v2\/lsvr_kba\/1119"}],"collection":[{"href":"https:\/\/quanticalabs.com\/docs\/chauffeur-booking-system\/wp-json\/wp\/v2\/lsvr_kba"}],"about":[{"href":"https:\/\/quanticalabs.com\/docs\/chauffeur-booking-system\/wp-json\/wp\/v2\/types\/lsvr_kba"}],"author":[{"embeddable":true,"href":"https:\/\/quanticalabs.com\/docs\/chauffeur-booking-system\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/quanticalabs.com\/docs\/chauffeur-booking-system\/wp-json\/wp\/v2\/comments?post=1119"}],"version-history":[{"count":7,"href":"https:\/\/quanticalabs.com\/docs\/chauffeur-booking-system\/wp-json\/wp\/v2\/lsvr_kba\/1119\/revisions"}],"predecessor-version":[{"id":1159,"href":"https:\/\/quanticalabs.com\/docs\/chauffeur-booking-system\/wp-json\/wp\/v2\/lsvr_kba\/1119\/revisions\/1159"}],"wp:attachment":[{"href":"https:\/\/quanticalabs.com\/docs\/chauffeur-booking-system\/wp-json\/wp\/v2\/media?parent=1119"}],"wp:term":[{"taxonomy":"lsvr_kba_cat","embeddable":true,"href":"https:\/\/quanticalabs.com\/docs\/chauffeur-booking-system\/wp-json\/wp\/v2\/lsvr_kba_cat?post=1119"},{"taxonomy":"lsvr_kba_tag","embeddable":true,"href":"https:\/\/quanticalabs.com\/docs\/chauffeur-booking-system\/wp-json\/wp\/v2\/lsvr_kba_tag?post=1119"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}