ICal Export - Revision history

Weins: 1 revision imported

2021-05-19T01:33:03Z

1 revision imported

Beds24>Markkinchin: /* Data Options */

2020-07-22T09:42:21Z

‎Data Options

Weins: 1版をインポートしました

2019-03-12T02:19:18Z

1版をインポートしました

Beds24>Markkinchin: /* Activate */

2018-10-22T14:50:20Z

‎Activate

New page

[[Category:Channel Manager]]
[[Category:Ical]]
[[Category:Error Messages from Channels]]
[[Category:Set up Instructions]]
''Synchronising Beds24.com with your Google or any iCal calendar''
== Capabilities ==
Beds24.com can export bookings and unavailable dates as an iCal feed.

Google calendar and many other systems can read the iCal feed.

Many holiday rental sites support Ical [[Ical_Sync|more Information]]

For details please [[Channel_Manager_Capabilities|click here]]

== Limitations ==
Only active bookings are exported, cancelled bookings will not appear.

Your Calendar program is responsible for routinely updating the calendar, we have no control over how often systems like Google calendar actually perform an update.

== What you will need ==
The Beds24 Calendar URL as displayed in the channel manager menu for each room.

== Beds24.com ==
=== Calendar content ===
The calendar information consists of a "Summary" and a "Description.
*The Summary of each event can be customized using the '''iCal Summary''' field, this field can contain text and [[Template Variables]].
*The Description of each event can be customized using the '''iCal Property Description''' and '''iCal Room Description''' fields, these fields can contain text and [[Template Variables]].

Both are optional,

We provide 4 different URLs from which you can choose:

'''iCal''': Because the iCal feed is public, by default only non personal data will be included in this URL

If the secret token in the URL is used, the iCal SUMMARY and DESCRIPTION fields of each iCal event can contain more information about the booking.

'''Include Property and Room Description''': This link will show personal information plus the values of the template variables you have entered in the "iCal Property Description" and "iCal Room Description" fields.

'''Include Property Description''': This link will show personal information plus the values of the template variables you have entered in the "iCal Property Description" field.

'''Include Room Description''': This link will show personal information plus the values of the template variables you have entered in the "iCal Room Description" field.

=== Activate ===
Select whether to export bookings only, blocked dates or both bookings and blocked dates.

All upcoming bookings are included and blocked dates for one year in advance.

=== Seed ===
The Seed is optional and can be used to change the token values. You only need to use this function if your token is compromised.

Enter a short phrase or word to seed new tokens. After you press SAVE you will see that the Urls for "Include Property and Room Description", "Include Property Description" and "Include Room Description" have changed. Make sure you have these exact URLs entered in your calendars.

If anyone accesses the calendar with the wrong token only the default non-personal iCal feed will be shown.

== In your Calendar ==
The iCal export will work with any calendar capable of importing iCal format data. Google and Mac chosen here as examples because they are often used.

'''Google.com'''

*Log into your Google calendar.
*In the left column select "Other calendars".
*Select "Add by URL".
*Enter the Beds24 Calendar URL (see above).
*Click Add Calendar and the bookings for that room should import.
*Repeat for any other rooms.

'''Mac'''
*In Calendar, choose File > New Calendar Subscription.
*Enter the calendar’s web address, and then click Subscribe.
*Enter a name for the calendar in the Name field and choose a color from the adjacent pop-up menu.
*Repeat for any other rooms.

== Data Options ==
Additional parameters can be added to the calendar URL to further specify the export data.

These options can be used to setup two way syncing to a google or other calendar without re-exporting imports and creating duplicate bookings. See also the options for iCal import to ignore duplicates.
'''&icalimport1=hide''' - add this to not include bookings imported from channel Ical Import 1.
'''&icalimport2=hide''' - add this to not include bookings imported from channel Ical Import 2.
'''&icalimport3=hide''' - add this to not include bookings imported from channel Ical Import 3.

This option will export the end date of the booking as the date of the last night, i.e. one day before the checkout date.
'''&end=lastnight''' - add this to export end date as last night.

This option will only show check-in days, not the rest of the booking.
'''&dates=checkin''' - add this to export only the check-in day to the calendar.

This option will only show check-out days, not the rest of the booking.
'''&dates=checkout''' - add this to export only the check-out day to the calendar.

This option should only be used if your software requires dates including time information.
'''&showtime=true''' - add this to add time to the calendar dates. Default checkin is added at 2PM and checkout at 10AM

Specify a different event start time when using &showtime=true.
'''&starttime=hh:mm''' - add this to specify the event start time, for example 07:30

Specify a different event end time when using &showtime=true.
'''&endtime=hh:mm''' - add this to specify the event end time, for example 11:00

Specify a time zone when using &showtime=true.
'''&timezone=Europe/London''' - add this to specify the timezone if your calendar needs it, the timezone must be a valid ical timezone value.
Valid timezone values can be found in the TZ* column at this link http://en.wikipedia.org/wiki/List_of_tz_database_time_zones

Hide request status bookings
'''&hiderequest=true''' - add this to prevent request status bookings appearing in the ical

Include bookings from linked rooms
'''&includerooms=true''' - add this to include the details of bookings included from other rooms as per the room dependency "Include Bookings From" settings.

Number of days into the future to include unavailable dates
'''&unavaildates=365''' - the default is 365 days, this can be overridden with this parameter to any value between 0 and 750 days in advance.

== Disconnect ==
*To disconnect set "Export" = Disable
*Remove the link from your calendar
== Notes ==
If you want to use a custom URL you can use a URL shorten-er service which lets you customize the link.

← Older revision	Revision as of 01:33, 19 May 2021
(No difference)

@@ Line 2: / Line 2: @@
 [[Category:Ical]]
 [[Category:Error Messages from Channels]]
-[[Category:Set up Instructions]]
+[[Category:Troubleshooting]]
-  ''Synchronising Beds24.com with your Google or any iCal calendar''
+<div class="heading">Ical Export</div>
 == Capabilities ==
 Beds24.com can export bookings and unavailable dates as an iCal feed.
@@ Line 40: / Line 41: @@
 '''Include Room Description''': This link will show personal information plus the values of the template variables you have entered in the "iCal Room Description" field.
 === Activate ===
@@ Line 72: / Line 76: @@
 == Data Options ==
-Additional parameters can be added to the calendar URL to further specify the export data.
+. These options can be used to setup two way syncing to a google or other calendar without re-exporting imports and creating duplicate bookings. See also the options for iCal import to ignore duplicates.
-These options can be used to setup two way syncing to a google or other calendar without re-exporting imports and creating duplicate bookings. See also the options for iCal import to ignore duplicates.
+| &end=lastnight
- '''&icalimport1=hide''' - add this to not include bookings imported from channel Ical Import 1.
+| Exports the end date of the booking as the date of the last night, i.e. one day before the checkout date
- '''&icalimport2=hide''' - add this to not include bookings imported from channel Ical Import 2.
+|-
-This option will export the end date of the booking as the date of the last night, i.e. one day before the checkout date.
+| &dates=checkout
- '''&end=lastnight''' - add this to export end date as last night.
+| Only shows check-out days, not the rest of the booking
-This option will only show check-in days, not the rest of the booking.
+| &starttime=hh:mm
- '''&dates=checkin''' - add this to export only the check-in day to the calendar.
+| Specifies the event start time, for example 16:00 when using &showtime=true
-This option should only be used if your software requires dates including time information.
+| &hiderequest=true
- '''&showtime=true''' - add this to add time to the calendar dates. Default checkin is added at 2PM and checkout at 10AM
+|Hides request status bookings to  prevent request status bookings appearing in the ical
-Specify a different event start time when using &showtime=true.
+| &includerooms=true
- '''&starttime=hh:mm''' - add this to specify the event start time, for example 07:30
+| Include the details of bookings included from other rooms as per the room dependency "Include Bookings From" settings.
-Specify a different event end time when using &showtime=true.
+| &unavaildates=365
- '''&endtime=hh:mm''' - add this to specify the event end time, for example 11:00
+| The he default days in the future is 365 days, this can be overridden with this parameter to any value between 0 and 750 days in advance.
-Specify a time zone when using &showtime=true.
+| &nourl=true
- '''&timezone=Europe/London''' - add this to specify the timezone if your calendar needs it, the timezone must be a valid ical timezone value.
+| Hides the view booking link.
- Valid timezone values can be found in the TZ* column at this link http://en.wikipedia.org/wiki/List_of_tz_database_time_zones
+|-
-Include bookings from linked rooms
+|}
-Number of days into the future to include unavailable dates
+== Troubleshooting ==
-  '''&unavaildates=365''' - the default is 365 days, this can be overridden with this parameter to any value between 0 and 750 days in advance.
+  '''Check-out date shows available'''
 == Disconnect ==

← Older revision	Revision as of 02:19, 12 March 2019
(No difference)

ICal Export - Revision history

Weins: 1 revision imported

Beds24>Markkinchin: /* Data Options */

Weins: 1版 をインポートしました

Beds24>Markkinchin: /* Activate */

Weins: 1版をインポートしました