tobook Hotel Booking Engine

Installation

For Designers and Developers:

Installation et déploiement.

• Install the plugin via the WordPress admin dashboard as usual
• Include the calender shortcode tbengine_calendar anywhere you would like to place a booking calendar in your navigation or landing page.
• Alternatively you may skip this step, and provide your own preferred calendars to link to the booking cart.
• Create a page with a permalink for the search and cart frontend, including the frontend via shortcode: [tbengine_offerlist/]
• Create a page with a permalink for the booking form frontend, including the frontend via shortcode: [tbengine_makebooking/]
• Go to the settings page for the plugin in the admin dashboard under: Settings -> tbengine plugin
• Add the permalink (full URL including domain) for the cart frontend with shortcode tbengine_offerlist under « Cart Permalink »
• Add the permalink (full URL including domain) for the booking form frontend with shortcode tbengine_makebooking under « Booking Form Permalink »
• Add the property’s tobook HotelID (integer) under « tobook HotelID », or use HotelID 100 for testing purposes (you may make test bookings under this HotelID).
• Done!

Autres Paramètres

• Exiger CVC  (entier – 0 ou 1) obliger les clients à fournir CVC sur le formulaire de réservation – par défaut 1.
• Default LangID: (integer from 1 to 9) default language on all frontend elements – default 1 (en).

Calendar shortcode tbengine_calendar query parameters (optional):

• LangID: (integer) – frontend language

Calendar shortcode tbengine_calendar attributes (optional):

• langID: (integer) sets the LangID of the calendar widgets, overrides any other settings
• open: (right|left|center) sets the horizontal opening positions of calendar popovers (default: right)
• drop: (down|up|auto) sets the vertical opening positions of calendar popovers (default: down)

Cart permalink optional query parameters:

The cart takes various optional query parameters such as langauge, arrival and departure dates, number of adults etc to
help you integrate the booking engine into your main site. Typically you would wish to at least have a form on your front
page with a pair of calendars linking to the cart permalink. The full list of cart query paramters is:

• Arr: (yyyy-MM-dd format) – arrival date
• Dep: (yyyy-MM-dd format) – departure date
• Adults: (integer) – number of adults
• Children: (integer) – number of children
• LangID: (integer) – frontend language
• CurrencyID: (integer) – user search currency

An example cart link using the default tobook demo cart permalink that includes passing in arrival and departure dates and number of adults would look like this:

https://www.tobook.com/wordpress/book-rooms/?Arr=2021-10-24&Dep=2021-10-27&Adults=2

Both of Arr and Dep must be supplied for them to have any effect, (otherwise the cart falls back to a one night search for today’s date).

List of supported LangIDs:

• 1 – English
• 2 – French
• 3 – German
• 4 – Italian
• 5 – Spanish
• 6 – Portugese
• 7 – Turkish
• 8 – Hungarian
• 9 – Dutch

Passing in CurrencyID as a paramater is a little unusual as it’s unlikely to exist as a separate parameter on your
main site. For the tbengine plugin, CurrencyID 1 is Euro, CurrencyID 2 is Dollar, contact us for a full list.

Layout customization:

Layout customization is performed via CSS tweaks and overrides in the files in the plugin directory:

tbengine/app-css/custom/engine.css (general settings)
tbengine/app-css/custom/calendar.css (calendar settings)
tbengine/app-css/custom/offer-list.css (cart settings)
tbengine/app-css/custom/make-booking.css (booking form settings)

où les développeurs peuvent librement étendre ou remplacer les classes parentes dans :

tbengine/app-css/engine.css
tbengine/app-css/calendar.css
tbengine/app-css/offer-list.css
tbengine/app-css/make-booking.css

sans restriction ni écrasé par les mises à jour.

Note that the current CSS classes are designed to work for an out of the box WordPress install with the
default « Twenty Sixteen » theme applied. For other themes and/or custom layout styles, adjustments under
tbengine/app-css/custom/ may be necessary, this is at the discretion of the own-site developers/designers
and we do not field support questions relating to site-specific CSS customization.