Booking search form widget

Booking Search Form Widget

The Booking Search Form Widget lets you add only the form portion of the Booking Search Widget to your page. Instead of displaying the search results directly, users are redirected to another page containing the full Booking Search Widget to view the search results.

Key Features

1. Streamlined Search Interface Embeds a compact and focused search form without displaying results on the same page.

2. Customizable Fields Allows you to hide specific search fields, tailor the search experience, or filter results by product IDs and locations.

3. Seamless Navigation Redirects users to a dedicated page for search results, keeping the form page clean and user-friendly.

How to Use

Add the widget to your webpage using the HTML snippet below. Replace the url with the path or URL to the page where the full Booking Search Widget is located.

Example:

<bilberry-booking-search-form url="/activities"></bilberry-booking-search-form>

Widget Properties

Property	Description	Default Value	Required
url	The URL to the page where the full Booking Search Widget is located. Redirects users to this page upon submission.	N/A	Yes
hide-difficulty	Hides the difficulty field in the search form. Options: yes, no.	no	No
hide-duration	Hides the duration field in the search form. Options: yes, no.	no	No
hide-quantities	Hides the quantities field in the search form. Options: yes, no.	no	No
limit-to-products	Comma-separated list of product IDs to limit the search to.	All products	No
exclude-products	Comma-separated list of product IDs to exclude from the search. Ignored if limit-to-products is set.	All products	No
locations	Comma-separated list of locations to limit the search to. Hides the field and searches all locations if unset. Locations must match defined locations in Bilberry Backoffice	All locations	No
lazy-load	Set to yes to defer loading the widget content until it is visible in the viewport. Options: yes, no.	no	No

Setting Up on Wix

If you’re using Wix as your website builder, follow these steps to configure the widget:

1. Access the Configuration Guide: Refer to the relevant guide in these docs for general widget setup on Wix.
2. Use the Following Values:
   • Server URL: https://bilberry-widgets.b-cdn.net/v4/wix-wrappers/WixBilberryBookingSearchForm.js
   • Tag Name: wix-bilberry-booking-search-form

Tips for Effective Integration

1. Choose a Relevant Redirect URL: Ensure the url points to a page where the booking-search widget is present.
2. Customize the Form: Use the hide-* properties to tailor the form fields to your users’ needs.
3. Filter Results: Apply limit-to-products or locations to focus the search on specific items or areas.
4. Test Navigation: Verify that users are seamlessly redirected to the results page upon form submission.
5. Mobile-Friendly Design: Ensure the form looks and works well on mobile devices.

By integrating the Booking Search Form Widget, you can streamline the search process, improve navigation, and provide a tailored experience for your users.