Booking form

You will use the booking form shortcode or bloc to display a search/booking form. The reservation process has different steps and some redirection can be implemented at the following steps:

• Search results: once the guest has indicated his dates, number of guests and number of accommodation. This redirection can be implemented for global search only.

• Customer/Reservations details form: once the guest has selected the accommodation type.

• Thank you and Summary: at the last reservation step, once the confirmation screen is shown.

Shortcode [hb_booking_form]

Use the [hb_booking_form] shortcode to display a booking form on your website.

Parameters for the search type

With HBook, you can either have a global search (search for all accommodation types) or a specific search (for one type of accommodation only).

Default behavior:

• Within an accommodation type page, be it an HBook Accommodation Type or on the page set as Display option, the search is specific to this accommodation type, by default.

• Within any other page, the search is by default global, for all accommodation types.

Parameters:

• all_accom: when displayed on an accommodation page, the search form will only look for that accommodation. If you want the search form to look for all accommodation, set the all_accom parameter to yes.

• accom_id: use this parameter to make the search form to only look for a specific accommodation type. You will find the accommodation ID in the accommodation type post right under the title.

Parameters for the redirection

Default behavior:

• The booking process has various steps, and by default, there is no redirection.

Parameters:

• search_only: use this parameter to display a search form only. Once they have clicked on the “Search” button, customers will be redirected to the page whose URL is entered in the redirection_url parameter.

This parameter can only be used in global searched, not when used on an accommodation page or with the “accom_id”.

• redirection_url: add this parameter if you use the search_only parameter, or if you use the shortcode on an accommodation page. This parameter must contain the URL of your main booking page (this page will have a [hb_booking_form] shortcode).

• thank_you_page_url: this parameter is useful if you wish to redirect the customer to a different page for the reservation confirmation screen, usually called “Thank you page”. On that “Thank you page”, you need to have a [hb_reservation_summary] shortcode or a bloc “Reservation summary”.

If you use the “redirection_url” parameter, then you should include this parameter only in the booking form shortcode on the page to which your customer is redirected.

Parameters for design and customization

Default behavior:

• By default, HBook does not display the thumbnail and the description if there is only one accommodation type set, or if the search is for a specific accommodation type.

Parameters:

• force_display_thumb: add this parameter if you wish to display the accommodation thumbnail when the search is for a specific accommodation type. You can set this parameter to yes, and the thumbnail will be displayed.

• force_display_desc: add this parameter if you wish to display the Description displayed in the search results when the search is for a specific accommodation type. You can set this parameter to yes, and the description will be displayed.

• search_form_placeholder: this parameter is useful if you wish to override the general setting for using labels or placeholders for the search form. You can find the general setting in HBook > Search Form.

• form_id: add this parameter to be able to set the identifier of the form to your desired ID. This can be useful if you wish for example to style differently one specific form or have specific JS interacting with this form.

Examples

Booking form block - Gutenberg

1. Select for which accommodation type the booking form is

2. Indicate if you wish to display a Search only booking form. With “Search only” parameter enabled, you need to indicate the Redirection page below. Your customer enter dates and number of guests searched. Once they have clicked on the “Search” button, they will be redirected to the page indicated in the parameter Redirection below. This parameter can only be used in global searched, not when used for a search for a specific accommodation type.

3. Indicate the Redirection page. You can use this combined with “Search only” parameter above enabled or disabled. When used alone, your customers will enter the dates and number of guests searched for, then select the accommodation. They will be redirected to the page indicated in this parameter to enter their customer details.

4. Indicate the Thank you page. You can use this parameter to redirect your customers to a specific page at the “Thank you” step, which is when the reservation confirmation screen is displayed, with the summary and the thanks messages.