Airbnb Integration

Using the iCal plugin available in the DPCalendar Standard version it is possible to present a single calendar view of a users holiday rental website with the popular airbnb accommodation rental site, this article explains the steps involved in getting up and running.

It is assumed at this point you have read and followed our instructions for getting started and have created your local calendar. It is also assumed you have a presence on the airbnb website and have access to the user admin section. It is also worth understanding the different types of calendars is use, we will be using both a local native view and a subscribed view see here

There are 2 steps involved in providing a single calendar view to both sites

• Exporting the airbnb calendar to your jooma website, to be viewed within DPCalendar as a subscribed calendar.
• Exporting your DPCalendar to be replicated onto your airbnb calendar.

Step 1, export from airbnb to DPCalendar

Lets assume we have setup our local DPCalendar and it has a title of "Local Calendar1" and we know how to create an event and for that event to be viewed on our site either by using a menu item or perhaps the mini module, what we now want to be able to do is to overlay that view with the content from the corresponding airbnb calendar.

First we need to logon to our airbnb admin area and take a copy of the Uri which we will need when we setup our Ical plugin.

• Logon to airbnb with your admin userid.
• Click your name in the top-right corner.
• Select Your Listings from the menu, you will now be presented with all of your listings.
• For the listing you want to edit, click Manage Listing and Calendar.
• You will now be shown the calendar for that specific listing.
• Click Settings in the top-right corner of your calendar view.
• Under Sync Calendars, select Export calendar.

You will then be provided with a Uri which you can now cut and paste into your Ical plugin settings

Now we can go back to out Joomla site and open up the DPCalendar Ical plugin and proceed as follows.

• First ensure our plugin is enabled.
• Select New , name your Ical calendar and paste in your Uri copied from the airbnb site above.
• Optionally change the colour of your calendar entries.
• When your ready Save & Close (both the Ical entry and the plugin)

We now have a link setup from the Joomla site to the airbnb site, now we can add the calendar feed to our local calendar

In this example I'm using the mini calendar module, but the same applies using the menu item calendar display.

• Select the mini module item you want to use to display your combined calendars
• Give it a suitable title (Combined Calendar worked for me)
• In the field to Select Calendars you will be given the option to select 1 or more calendars to display in this module, these are represented as a single calendar view
• Select your local DPCalendar AND your airbnb calendar

You will now have a combined view of both calendars, which will refresh from airbnb and DPCalendar whenever a user loads your page. see notes below

 Step 2, export from DPCalendar to airbnb

At this stage we now have a single view on our Joomla site of our local calendar AND the airbnb calendar, the view of the airbnb calendar will be refreshed when a user loads the page on our Joomla site, we now want to reflect any changes made to the DPCalendar back to the airbnb calendar to complete the integration.

The steps to be performed are essentially the same steps as above, but instead of exporting from airbnb, we now want to import.

First we need to obtain our DPCalendar Uri for our local native calendar, there are 2 options to find this:-

1. If you are using a menu item to display the calendar, navigate to the menu entry and select Calendar Options Tab, ensure the option for Show Calendars is set to Yes and expand, now from the front end you will be shown the calendar name and an option to download its ICal file, at this point you can right click the ICal option and Copy Link Location, this is what we will need on the airbnb site.

   

2. Alternatively the Uri requird can be constructed as follows http://your-site-name-here.com/index.php?option=com_dpcalendar&task=ical.download&id=30 simply substitute your site name and the calendar id, which can be found in the back end DPCalendar Component and is the id of the native DPCalendar you want to export to airbnb.

Now that we have our Uri, we can logon to our airbnb admin area and copy the Uri into the calendar import setting.

• Logon to airbnb with your admin userid.
• Click your name in the top-right corner.
• Select Your Listing from the menu, you will now be presented with all of your listings.
• For the listing you want to edit, click Manage Listing and Calendar.
• You will now be shown the calendar for that specific listing.
• Click Settings in the top-right corner of your calendar view.
• Under Sync Calendars, select Import calendar.

Simply paste your Uri into the Calendar Address (URL) field, give your Calendar a name e.g. DPCalendar1 and press the Import button, the airbnb calendar will now synch with your Joomla site and continue to do so automatically every few hours.

An entry exported from DPCalendar will appear on the airbnb admin view as shown

And on the front end guest view

We now have a 2 way flow between our Joomla site and airbnb, there are some points worth remembering

• We have simply subscribed to the airbnb calendar, therefore we do NOT maintain any of the airbnb data on our Joomla website.
• Airbnb has no concept of an event or a booking, therefore if you create an event in DPCalendar against the local calendar, this will be imported into airbnb at the next cycle and will block the specific dates from the airbnb calendar. This is regardless of whether you have made any corresponding booking within DPCalendar; therefore I suggest you only ever create an event when you make a booking within DPCalendar.
• The Ical plugin will cache the view of the airbnb calendar for a number of seconds which can be modified in the plugin advanced options.
• The airbnb calendar works on the basis that any day which does NOT have a rental price listed on the airbnb calendar is considered to be blocked by the owner, and will export an entry for that day with the item description as "Not available" , therefore to avoid double entries. only block dates on the airbnb calendar, and this will be reflected on your combined calendar view on your Joomla site. Similarly be creating an event/booking in DPCalendar this will be imported into airbnb and mark the dates as blocked and unable to be booked.
  
• If you subsequently unpublish or delete an event from DPCalendar, this will be picked up by airbnb at the next automatic sync and will unblock the entry in the airbnb calendar