Knowledge Base

Learn about top features of our solutions. Get help whenever you need.

Instructions for integration of Exely Booking Engine on a website

A hotel website must contain the search form and booking engine:

Search form	Standard
Search form	Button widget
Booking engine	On a separate page
Booking engine	Pop-Up

We have sent you an archive with files required for the successful integration and examples of the best website layouts that increase website conversion the most:

Archive structure	Catalogue SCRIPT

Integration of script to set up the search form and booking engine

Folder	head_script
File	head_script-en*
Content	form upload script
Installation	between <head></head> tags on all pages of the website

*For a multilingual website, the catalog has different files for each language version. The last two letters in the name indicate a language version of the script.

If the search form is a button widget, there is no need to set up the search form and booking engine blocks separately. They will appear automatically after you have added head_script.

You need to go to the section Integrate the “Book now” buttons.

If the booking engine appears in a pop-up, there is no need to set up the booking engine block separately.

You need to go to the section Integrate the search form block.

How to integrate the booking engine block

If the booking engine opens up on a separate page

First, create a new booking page or add the booking engine script to the page you have created earlier. By default, the path /booking/ is used in the booking engine settings for the booking page.

Folder	booking_engine.2.0
File	reservation_form-en*
Content	booking engine code + styles
Installation	on the booking page

*For a multilingual website, the catalog has different files for each language version. The last two letters in the name indicate a language version of the script.

How to integrate the search form block

Folder	search_form.2.0
File	search_form-en*
Content	search form code + styles
Installation	the place where you want to display the search form, for example, before the </header> tag

*For a multilingual website, the catalog has different files for each language version. The last two letters in the name indicate a language version of the script.

If there are several hotels of the same hotel chain on the website, then the folder contains separate files for each hotel. The number (unique number of the hotel in Exely Suite) in the file name indicates for which hotel this script was prepared.

Folder “main”	search form script, where the select displays “Select a hotel”
Folder with numeric value	search form script, where the hotel with the corresponding ID in Exely Suite is displayed in the select

Сheck if the search form redirects to the booking engine successfully.

Go to the page with the search form, click “Find room” and make sure that you are redirected to the page with the booking engine.

If your page URL does not coincide with the search form URL, provide the correct URL of the booking engine page to your Exely manager.

Integrate the “Book now” buttons

The button is set up for each room type on the “Rooms” page and the pages of every room type.

Examples of links to be placed on the rooms/rate plans page are presented below.

Every room type has a unique ID redirecting to the booking engine. It is required to assign IDs to each room type.

“Linking” the “Book now” button to the booking engine on a separate page:

link_room
links_offer

“Linking” the “Book now” button to the booking engine in the pop-up:

link_room

*If the website is created in a website builder, for example, Tilda and/or it is not technically possible to add attributes, you can use the link:

links_offer

*If the website is created in a website builder, for example, Tilda and/or it is not technically possible to add attributes, you can use the link:

	Without specifying an ID, you will be redirected to the booking engine, where all rooms/rates will be displayed.
	The file may be empty if the IDs are not entered (Categories of rooms and/or Rates in the personal account are not filled).
	If the ID is entered, but the room/rate is not available, then the transition will be made to the booking engine, where all rooms will be displayed.

A link can contain both the room type and rate plan IDs simultaneously:

<a href='/booking?room-type=123456&special-offer=654321'>Book under promo rate</a>

A link can also contain several IDs of room types and rate plans simultaneously:

<a href='/booking?room-type=123456,234561&special-offer=654321,543216'>Book under promo rate</a>

If there are several hotels of the same hotel chain on the website, then the folder contains separate files for each hotel. The number (the unique number of the hotel in Exely Suite) in the file name indicates for which hotel the links are prepared. In this case, the hotel ID parameter is mandatory for the correct transition to the booking engine.

Example:

Checklist

№	Checkpoint	Main verification criteria
1	The head-script is added to all website pages.	The script is used for the fast loading and collection of the statistics of the booking engine. The head-script is added with head tag. The script matches the website language version.
2	The search form should be integrated on all pages of the website, except for the Booking page	The search form is essential marketing element on any website especially if there is no other call-to-action. This is why it is very important to integrate the search form on each page of the website. The search form is not stretched to the full width of the screen, but matches the width of the main content. The search form is placed above the fold. The search form fields are clickable.
3	Correct display of the booking page if the booking engine is integrated on a separate page of the website	The page has a tibee, it serves as a means of navigation for the user, without it the page looks unfinished. We recommend providing key words in the tibee of the booking page with the <tibee> tag. This improves SEO rankings in search results and makes the website more user-friendly. For example, <tibee>Booking in MMM Hotel, New York - official site</tibee On the booking page, there are no distracting elements (links to social media accounts, maps, rooms and promotions blocks, large blocks of contact details, etc.). Such elements can distract users from the booking process and cover the booking engine navigation buttons. There is no search form on the booking page. There is only one booking page on the site. The booking page opens in the current tab, which ensures the convenience of using the site.
4	Correct redirect from the search form and booking buttons to the booking page	By default, the path /booking/ is used in the booking engine settings for the booking page. If your page URL does not coincide with the search form URL, provide the correct URL of the booking engine page to your Exely manager. If the “Book now” buttons lead to different booking engines, this can mislead users. All buttons/links of room and special offer booking redirect to the booking engine. Unclickable or empty “Book now” buttons may give the impression of a low-quality website and undermine the website’s credibility. Room-type/special-offer parameters, equal to the room/rate IDs in Exely Suite, are registered in the links of room/rate booking buttons. If several values of the room-type/special-offer parameter correspond to one room/rate, we recommend that you enter them separated by commas without spaces.
5	Display when adapting to different screens is correct: 320x480 768x1024 800x1280 1280x600 1366x768 1920x1080	We recommend checking to make sure that your website is viewable on all devices. This will maximize the reach of your audience and help avoid conversion loss. Booking engine can’t be cut off (~320px). Search form and booking engine must have left and right indents.
6	Display is correct when adapting to browsers: Google Chrome Mozilla Firefox Opera Microsoft Edge Safari	We recommend checking to make sure that your website is viewable and consistent in different browsers. This will maximize the reach of your audience and help avoid conversion loss.
7	The search form and booking engine adhere to the design and location of the form	Our company specialists have designed the integrated form to ensure the highest conversion for the website in terms of appearance and location of the call to action. We recommend following our design template/ recommendations.
8	Correspondence of language versions of forms and site, if the site is multilingual	The presence of booking elements that do not match the current language version cause users to mistrust a resource and may be incomprehensible to foreign users of the website. The search form and booking engine must match the language version of the website. Redirection of the “Book now” button should also be in the correct language (for example, in an English version of a website, the booking button should not lead to the German version of the booking engine page)
9	Correct display of forms if the site is on the WIX website	When opening the calendar, the search form should not appear with a vertical scroll bar in the mobile version. The search form in the mobile version should be displayed in full size (without a scroll bar), and the element with the booking engine is not too small.

Inform your Exely manager, when you complete the Exely Booking Engine integration so that our Testing Team can quickly verify the quality of the integration and report errors if there are any.

If you experience difficulties with the integration process, contact us and we will help you.

In case you want Exely team to set up Exely Booking Engine on your website, provide us with CMS and FTP access with administrator rights. We will perform the integration quickly and for free, so that you profit from the website as soon as possible.

Need More Help? Contact Support

CONTACT SUPPORT