Online Reception HTML Specification

Consider Wubook’s Javascript library

Before implementing Wubook’s engine via GET/POST, consider using the Javascript Library: it’s lite, simple and it covers a lot of other aspects like customization and Google Integration. See Online Reception: WuBook’s Javascript Library.

The online reception of WuBook can be opened with a simple GET or POST, which is certainly compatible with Iframe and way more possibilities of customization: you will find them in this section of the documentation.

Get/Post

We are gonna go out on a limb and assume you know one thing or two about HTTP get/post methods; you can learn more about it here.

There is a unique mandatory parameter you’ll have to define -called lcode- and it’s the Property Identifier Number; before opening the link given on the next sentence, please read the following instructions.

The URL of the Online Reception is https://wubook.net/wbkd/wbk/ and you’re gonna need to add a ?lcode= followed by your own lcode.

Warning

If you open the given link without the lcode, you’ll get an error message.

For instance, if your lcode is 1402584731, then the get/post call will be managed this way: https://wubook.net/wbkd/wbk/?lcode=1402584731. Try it!

Note that you have to add an & after the lcode if your intention is to use the following optional params. You can add as many params as you like, as long as you insert an & after each one of them.

  • dfrom: Arrival Date (EU format: 21/12/2012). Note that “today” is accepted as value.

  • dto: Departure Date (Eu format: 21/10/2012).

  • nights: Number of nights. Notice the nights params wins over the dto one (it takes priority over dto).

  • dcode: Discount code.

  • lang: the language (en,it,fr,uk,ru and so on). Auto detected if not specified.

  • sessionSeed: to track reservations (data can be retreived only via xmlrpc).

  • onlyrooms: a list of room IDs. When specified, all the other different rooms will not be sold (use bookrooms instead)

  • custom_colors: a JSON object, key-value structure, to customize the Online Reception colors

  • eurota: the eurota code to track the origin of the reservation.

  • currency: the user’s currency (EUR, USD…)

  • bookrooms: a list of rooms ID separated by commas (i.e 1,2,3). If specified, and if rooms are available for the selected dates, the Online Reception will be redirected to the last step, otherwise the Online Reception will show the date selection and all rooms available. If you use the bookrooms parameter, you can specify the desired board for your rooms. How? With the board_RID parameter. For instance: bookrooms=1,7&board_1=hb&board_7=bb. With this example, we assume you want to book the rooms identified by 1 and 7. Room 1 is required with an Half Board preference, while the room 7 is required with a Breakfast preference.

  • pid: book the package identified with the pid param (if dfrom is specified, One Click Booking will be possible)

  • occupancies: to specify the number of rooms and the number of adults and children (and their ages). Examples: occupancies=2 (1 room for 2 adults). occupancies=2,1 (1 room, 1 adult and 1 child, age= 1), occupancies=2,1,3 (1 room, 2 children, ages= 1 and 3). To indicate multiple rooms, just join strings with an underscore, like: 2, 1,2_2,4 (2 rooms: the first one has 2 adults and 2 children, ages= 1 and 2. The second one has 2 adults and 1 child, age= 4)

  • filters: for filtering the list of rooms showed in the first step of your booking engine. You can specify the total occupancy of rooms filtered as sum of adults and children or the number of adults. Examples: filters=1_1 (filter the list of roooms for occupancy 2, then show all rooms for 1 adult and 1 children and for 2 adults, note that this is equivalent to filters=2), occupancies=2,2_1 (filter the list of rooms for occupancy 2 - 2 adults or 1 adults and 1 children - and occupancy 3 - 3 adults or 2 adults and 1 children)

  • relink: a URL to redirect the user when the reservation process is over. In the Wubook thank you page will appear a button that clicked will redirect him

How to customize colors

if you want to customize your Online Reception colors, you can use the custom_colors. It is a JSON object that contains pairs of keys and values. The values are string of hexadecimal HTML colors

Warning

The colors must always be specified in hexdecimal, without the # character at the beginning. Example: a1b2c3.

Warning

We continously monitor colors customization to preserve quality and we reserve the possibility to block customizations we don’t like. We are sorry for such grey zone but we do want to ensure quality. Historically, customizations have been used in a too wild fashion and without preserving the minimum required standards.

The keys you can use are the following:

  • background: Customize the background color of the online reception, with this you can use a solid color.

  • address_background: The background color of the online reception header where there are the name and address.

  • address_text: The text color of the online reception header.

  • top_bar: Override the background color of the title bar (basically the h2 elements).

  • top_bar_text: The text color used in the title bar.

  • button_background: Customize the color of the booking buttons.

  • button_text: The text color of the booking buttons.

  • amenity: Customize the color of the amenities inside the rooms.

  • promo_background: The background color of the labels that contain the “Special offer” text.

  • promo_text: The text color of the labels above.

  • continue_button_background: The background color of the continue buttons visible when you choose a room.

  • continue_button_text: The text color of the above buttons.

  • rooms_text: The text color of the room titles.

  • virtuals_text: The text color of the virtual room titles.

  • prices_text: The text color of prices.

  • offers_text: The text color of special offers titles showed on first step, if there are.

  • boards_text: The text color of the name of the boards

  • calendar_endpoint_background: The color of placeholder used in the calendar.

  • calendar_between_background: The color used for marking the dates between a range.

for example, if you want customize the the h2 background and text you will create this JSON object: {“top_bar”: “47476b”, “top_bar_text”: “ffffff”}.