Skip to content
Bilberry Widget Docs

Accommodation Calendar Search

Accommodation Calendar Search Widget

The Accommodation Calendar Search Widget allows users to search for available accommodations based on their desired criteria. It simplifies the booking process by integrating room selection, guest details, and date range availability into a single, seamless experience.

Key Features

  1. Room and Guest Selection Users specify the number of rooms, as well as the number of adults and children per room.

  2. Availability Calendar A calendar displays only the dates that accommodate the selected number of rooms and guests. Users can select a date range for check-in and check-out.

  3. Accommodation Listing After selecting dates, the widget lists available accommodations for the specified dates. Users can add desired accommodations directly to their cart from this list.

  4. Seamless Booking Experience The widget integrates with supported providers to deliver real-time availability and booking capabilities.

Widget in Action

Supported Providers

The widget currently supports the following booking providers:

  • Bilberry Accommodations: Native support for Bilberry-powered accommodations.
  • Visbook: A widely used accommodation booking system.

How to Use

Add the widget to your webpage using the HTML snippet below. Specify the desired provider and additional options as needed.

Basic Example:

<bilberry-accommodation-calendar-search provider="visbook"></bilberry-accommodation-calendar-search>

Advanced Example:

For Bilberry accommodations, you must provide a comma-separated list of product IDs to limit the search to specific accommodations.

<bilberry-accommodation-calendar-search
    provider="bilberry"
    product-ids="1,2,3"
></bilberry-accommodation-calendar-search>

Widget Properties

PropertyDescriptionDefault ValueRequired
providerSpecifies the booking provider to use. Options: bilberry or visbook.visbookYes
product-idsComma-separated list of product IDs for Bilberry accommodations. Only required if provider="bilberry".N/ANo
lazy-loadSet to yes to defer loading the widget content until it is visible in the viewport. Options: yes, no.noNo

Notes:

  • For Bilberry, the product-ids attribute limits the search to specific products. This attribute is not required for Visbook.
  • The default provider is visbook if no provider is specified.

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/WixBilberryAccommodationCalendarSearch.js
    • Tag Name: wix-bilberry-accommodation-calendar-search

Tips for Effective Integration

  1. Simplify the User Experience: Use descriptive labels and hints to guide users when selecting rooms, guests, and dates.
  2. Test with Your Data: Ensure the widget works as expected by testing it with real accommodation data from your provider.
  3. Use the Right Provider: Choose the provider (bilberry or visbook) based on your accommodation booking setup.
  4. Mobile Responsiveness: Verify that the widget displays correctly on mobile devices for a seamless user experience.

By following these steps and tips, you can integrate the Accommodation Calendar Search Widget into your website to enhance your users’ booking experience.