Skip to main content

How does the integration with a booking widget work?

Kay Endörfer
  • Updated

1. What is a Booking Widget?

The booking widget is an alternative for the operators already providing a detailed description of their offers. With the booking widget, only the booking procedures made through your ticketshop will be processed. The presentation of your offers will be left entirely to you and your website.
The booking widget will be, as the ticketshop, integrated in your website via iFrame and the check-out via lightbox. Its configuration is located in your Regiondo account:
Shop Configuration > Website Integration > Booking widget
Note
We have created a new Regiondo Booking Widget with the React JavaScript library. The new widget comes with multiple advantages. Click here to get more information.

2. What settings can I choose for the booking widget?

Please define the following settings before you generate your code:
  1. Settings - iFrame width: Fill in the desired width of the iFrame in pixels. (standard: 338, but adjustable to the website and the option between iFrame or Lightbox for the check-out process. The lightbox is set as default. 
  2. Cart button: If you activate this function, the customer has the possibility to use a shopping cart in your shop. The customer can add products to his shopping cart and keep shopping without being redirected to the payment process. If you decided on the shopping cart, you can adapt it visually to your shop. 
Note
There is the possibility to skip cart step and go directly to checkout. Please add the attribute data-skip-cart="true" to the widget code snippet.
Warning
A Lightbox is a JavaScript library that displays the check-out process by filling the screen, and dimming out the rest of the ticketshop and is also responsive. 
Tip
It is recommended to use the shopping cart option, as the customer will be able to stay longer in your shop, adding products to his cart.
Moreover, nowadays it is essential for customers to have the option to compare. With a shopping cart, they will be able to do so and shopping in your shop will be more pleasant for your future customers. 
  1. Select Product: Select the offer you want to set up the booking process as widget for.
  1. Your HTML Code: Under you can preview your Booking widget. 
    Copy the whole code and insert it in the desired spot into your website's source code, or create an HTML element where you can embed the code to integrate the widget. 
Loading animation for the booking widget:
You can disable the loading animation when you enter 
data-disable-loading-animation="1"
in your <iframe> part of the code.

For example: 
<iframe id="regiondo-booking-widget" data-width="340px" style="border:0;background:transparent;" data-disable-loading-animation="1"></iframe>
 
Tip
Structure of the booking widget's URL:

https://yoursubdomain.regiondo.com/bookingwidget/vendor/XXXX/id/ZZZZ
 
XXXX is your Vendor ID

ZZZZ ist the Product ID

Further possible URL's parameters

- Highlight ticket tab

https://yoursubdomain.regiondo.com/bookingwidget/vendor/XXXX/id/ZZZZ/type/ticket

- Highlight voucher tab

https://yoursubdomain.regiondo.com/bookingwidget/vendor/XXXX/id/ZZZZ/type/gift

- Preselect date

https://yoursubdomain.regiondo.com/bookingwidget/vendor/XXXX/id/ZZZZ/type/ticket/date/YYYY-MM-DD

- Preselect date and time

https://yoursubdomain.regiondo.com/bookingwidget/vendor/XXXX/id/ZZZZ/type/ticket/date/YYYY-MM-DD/time/HH-MM

- Add the affiliate tracking parameter

https://yoursubdomain.regiondo.com/bookingwidget/vendor/XXXX/id/ZZZZ/type/ticket?subid=123456

3. Customer's view

Example: http://www.kavaliersreisen.de/

The operator "Kavaliersreisen" already provides a detailed description of his offers on his website. The booking procedure will be processed through the Regiondo Booking Widget. 

4. Example of a shop with a booking widget and the shopping cart function

Related articles