Changes

Jump to navigation Jump to search

ICal Export

2,271 bytes added, 27 March
[[Category:Ical]]
[[Category:Error Messages from Channels]]
[[Category:Set up InstructionsTroubleshooting]]<div class="heading">Ical Export</div> ''Synchronising This page is about the menu {{#fas:cog}} (SETTINGS) CHANNEL MANAGER > ICAL EXPORT and explains how to synchronise Beds24.com with your Google or any iCal calendar''
== Capabilities ==
Beds24.com can export bookings to your and unavailable dates as an iCal feed. Google (calendar and many other systems can read the iCal) calendarfeed.
Many holiday rental sites support Ical [[Ical_Sync|more Information]]
== Limitations ==
Only active bookings are exported, cancelled bookings will not appear.
 
Settings in prices which limit availability are not considered.
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.
== 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.
Select whether to export bookings only, blocked dates or both bookings and blocked dates.
The iCal If you add &nourl=1 to the URL can the link to the booking will be read with or without the secret token parameterremoved.
== Calendar content =Activate ===Select whether to export bookings only, blocked dates or both bookings and blocked dates.
Because the iCal feed is public, by default only non personal data will be All upcoming bookings are includedand blocked dates for one year in advance.
If === Seed ===The Seed is optional and can be used to change the secret token in the URL is correct the Booking Description will contain the value entered in the '''Booking Description''' fieldvalues. Use [[Template Variables]], here You only need to include information from each bookinguse this function if your token is compromised.
The Booking Summary can be customised using Enter a short phrase or word to seed new tokens. After you press SAVE you will see that the '''Booking Summary''' fieldUrls for "Include Property and Room Description", this field can also contain [[Template Variables]]"Include Property Description" and "Include Room Description" have changed. Make sure you have these exact URLs entered in your calendars.
The password is optional and can be used to change the token value. If anyone accesses the calendar with the wrong token, no only the default non-personal information iCal feed will be available in the calendarshown.
== In your Calendar ==
== Data Options ==
1. 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.{| class="wikitable"|-! scope="col"| Paramenter! scope="col"| Use|- | &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.|- |} 2. Additional parameters can be added to the calendar URL to further specify the export data.{| class="wikitable"|-! scope="col"| Paramenter! scope="col"| Use|- | &end=lastnight| Exports the end date of the booking as the date of the last night, i.e. one day before the checkout date|- | &dates=checkin| Only shows check-in days, not the rest of the booking|- | &dates=checkout| Only shows check-out days, not the rest of the booking|- | &showtime=true''| Adds time to the calendar dates. Default checkin is added at 2PM and checkout at 10AM <span style="color:#fe746c;“ >{{#fas:exclamation-triangle}} </span>This option should only be used if your software requires dates including time information.|-
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. '''| &icalimport1starttime=hide''' - add this to not include bookings imported from channel Ical Import 1.hh:mm '''| Specifies the event start time, for example 16:00 when using &icalimport2showtime=hide''' - add this to not include bookings imported from channel Ical Import 2.true '''&icalimport3=hide''' |- add this to not include bookings imported from channel Ical Import 3.
| &endtime=hh:mm
| Specifies the event end time, for example 11:00 when using &showtime=true
|-
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.
| &timezone=Europe/London
| 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
|-
This option will only show check-| &hiderequest=true|Prevents request status bookings appearing in days, not the rest of the booking.ical '''&dates=checkin''' |- add this to export only the check-in day to the calendar.
| &hideblack=true
|Prevents black status bookings appearing in the ical
|-
This option | &showinquiry=true|Shows Inquiry bookings in the ical, they will only show check-out days, not the rest of the bookingappear without this option. '''&dates=checkout''' |- add this to export only the check-out day to the calendar.
| &includerooms=true
| Include the details of bookings included from other rooms as per the room dependency "Include Bookings From" settings.
|-
This option should only be used if your software requires dates including time information. '''| &showtimeunavaildates=true''' - add 365| The default days in the future returned is 365 days, this can be overridden with this parameter to add time to the calendar datesany value between 0 and 750 days in advance. Default checkin is added at 2PM and checkout at 10AM|-
Specify a different event start time when using | &showtimenourl=true| Hides the view booking link. '''&starttime=hh:mm''' |- add this to specify the event start time, for example 07:30
Specify a different event end time when using | &showtimeback=true7| Include bookings from this many days ago (allowed values are 0 to 30). '''&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|}
== Troubleshooting ==
'''Check-out date shows available'''
Some calendars will fix dates particularly the check-out date midnight. This will cause the check-out date to show available. You can fix this by adding '''&showtime=true''' as explained above.
== Disconnect ==
*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 customise customize the link.

Navigation menu