Upcoming tours bookable widget

Upcoming Tours Bookable Widget

The Upcoming Tours Bookable Widget searches for and lists upcoming tours or activities based on the widget attributes. Unlike the standard Upcoming Tours Widget, this widget enables users to book tours directly from the widget, with bookings added directly to the cart.

Key Features

1. Dynamic Tour Search Searches for upcoming tours based on product catalog IDs, date range, and grouping preferences.

2. Integrated Booking Allows users to book tours directly from the widget.

3. Customizable Display Configure grouping by day or month, compact views, and status badges for tours with limited capacity.

How to Use

Add the widget to your webpage using the HTML snippet below. Replace the product-catalog-ids and other attributes with the desired values.

Example Usage:

<bilberry-upcoming-tours-bookable
    product-catalog-ids="120,121,122,113"
    number-of-days="50"
    few-left="10"
    title-text-customization-key="upcomingTours"
    disable-title="yes"
    group-by="month"
></bilberry-upcoming-tours-bookable>

Widget Properties

Property	Description	Default Value	Required
product-catalog-ids	Comma-separated list of product catalog IDs to search for.	N/A	Yes
number-of-days	Number of days ahead to search for tours.	7	No
start-date	First date to show tours for. Use a valid date string.	Today	No
few-left	Displays a “few left” badge if capacity is less than this number.	5	No
show-remaining	Shows actual remaining capacity when it’s less than or equal to few-left.	no	No
group-by	Group tours by their day (day) or month (month).	day	No
disable-title	Hides the heading above the list when set to yes.	no	No
hide-description	Hides the tour description for a more compact view when set to yes.	no	No
hide-read-more	Hides the read more link when set to yes.	no	No
day-selector-style	Controls how dates are displayed. Options: dates (full dates), weekdays (day names), both (day names and dates), or auto (Based on the ‘number-of-day’ attribute. It will show weekdays when 7 or less. It will show dates when 8 or more).	auto	No
lazy-load	Set to yes to defer loading the widget content until it is visible in the viewport. Options: yes, no.	no	No

Text Customization Properties

Property	Description	Default Value
title-text-customization-key	Text of the heading above the list.	Unset

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/WixBilberryUpcomingToursBookable.js
   • Tag Name: wix-bilberry-upcoming-tours-bookable

Tips for Effective Integration

1. Highlight Key Tours: Use this widget to showcase important upcoming tours or activities.
2. Brand Alignment: Customize the title and layout for a cohesive visual experience.
3. Utilize Limited Capacity Alerts: Use the few-left and show-remaining properties to create urgency and highlight tours with limited availability.

By integrating the Upcoming Tours Bookable Widget, you can provide an intuitive and engaging experience for users to explore and book tours.