Advanced implementation of KWHotel Booking Engine

Advanced implementation of KWHotel Booking Engine

Do you have any questions regarding KWHotel functions or development?
>>>Ask them here

This manual includes:

1. Introduction
2. Availability calendar
3. KWHotel Booking Engine

1. Introduction

Having configured your KWHotel Booking Engine, using this manual, it is time to implement the engine on the website.

First, let`s acquire your reservation system`s link. It can be found in the Administrator panel at dev.kwhotel.com. Navigate to Configuration –> Online reservations –> Basic. There you will find a link to the newest KWHotel Booking Engine. Click the yellow button to copy the link. Paste it to your Windows notepad to make any modifications (described below).

2. Availability calendar

Online availability calendar is available under the following address (pattern), where:

HASH (#) is a unique parameter given only to you. It is visible in the new Booking Engine`s link at dev.kwhotel.com –> Configuration –> Online reservations –> Basic.

Lang stands for language. Currently, we support the following languages: pl (Polish), en (English), fr (French), de (German), it (Italian), gr (Greek)

X stands for the room group ID. It can be taken from the Administrator’ panel at dev.kwhotel.com –> Rooms –> Room groups.

Y stands for the rate plan ID.

?monthsLength=x&columnsCount=x  stands for the number of months and columns to be displayed.

Exemplary code, based on our demo availability calendar.

• It can be implemented by the <iframe>, <a href> marker. No matter whether you wish to use an iframe or pop-up with an iframe inside it, a script can be used that will automatically adjust its` height. Details are linked here.

3. KWHotel Booking Engine

The most basic booking engine is available under the following pattern where:

Lang stands for language. Currently, we support the following languages: pl (Polish), en (English), fr (French), de (German), it (Italian), gr (Greek).

HASH (#) is a unique parameter given only to you. It is visible in the new Booking Engine`s link at dev.kwhotel.com –> Configuration –> Online reservations –> Basic.

Hotel ID value mostly often equals 0. It can be used in cases where multiple properties are operating on the same database. In such case:

0 – display offers from all hotels
1 – display offers from the first hotel in the database
3 – display offers from the second hotel in the database
5 – display offer from the third hotel in the database

Those values rise by 2 for every following hotel (7,9,11 etc.).

Exemplary code, based on our demo booking engine.

Link can also be generated for a specific date by using the following pattern, where;

?checkIn= stands for reservation start date (YYYY-MM-DD format)
?checkOut= stands for reservation end date (YYYY-MM-DD format)

Example

Link can also be generated for a specific room group by using the following pattern, where:

?roomGroupId is an ID of a room group. It can be taken from the Administrator`s panel at dev.kwhotel.com –> Rooms –> Room groups.

Example

Link can also be generated for a specific category. They allow you to put your room groups/apartments under different categories (i.e. location) to help your customer find what he needs. Categories and their IDs can be managed in the Administrator panel at dev.kwhotel.com –> Rooms –> Room group categories. The ID is based on the order of creation of the given category. The first added category receives ID = 1, second receives ID = 2 etc. You can achieve that by using the following pattern.

Example

Link can also be generated for a specific discount code. Please use the following pattern, where:

?discountCode= stands for a name of discount code created in the dev.kwhotel.com panel.

Example

You may also generate a link that searches for a specific amount of rooms for a specified number of people. Please use the following pattern, where:
?occupancy= stands for the number of people and rooms. The [{“count”:X}] value is used to determine the number of people in the first room we search. If you want to search for more rooms (to make a group reservation), separate another [{“count”:X}] with a comma.

For example, the below pattern allows me to search for two rooms – one for 2 people and one for 3.
The above properties can be used together. Parameters are linked with “&”.

Example
Exemplary implementation

The above links are all referring to the first step of the reservation process. However, it is possible to generate links that will redirect your customer to the second step, skipping the necessity to find the vacant room first. The pattern below is for the general link that will skip you to Step 2.

Exemplary implementation

You may include your own CSS styles at any stage of the implementation.

Click here to download or print full manual.