Description
Bookings Calendar for WooCommerce shows the free and the taken slots of your WooCommerce Bookings products on one calendar, so your customers see what is open at a glance — how many spots are left, what is sold out, when the next free slot is — and book it in a click.
Add it with the Bookings Calendar block, in the editor and in block themes, or with the [wbc-calendar] shortcode.
Attention: this plugin is an add-on for the official WooCommerce Bookings extension. It provides the calendar on your pages, not the booking functionality or the bookable product types.
Free features:
- A Bookings Calendar block for the editor and block themes, and the
[wbc-calendar]shortcode — day, week, month and list views - The spots left on each slot (“3 spots left”), and a full slot shown as “Sold out”
- The calendar opens on the first day with a free slot, and a “Next available” button jumps to the next one
- On a phone, the calendar shows as a list
- An information tooltip on each slot: its description and the spots left (a Premium feature until 1.1.0)
- A fast month view: the slots are kept for a few minutes and worked out again as soon as a booking comes in
- A click on a slot opens its product with that date and time already chosen
- Your colours, time format, language, first day of the week and start date; slots that cannot be booked shown greyed out, hidden or as usual
Premium version features:
- Book from the calendar — a click on a slot opens a booking window with that date and time already chosen: one more click and it is in the cart (view demo)
- Upcoming slots — the next free slots of your products in a short list, each with a Book button, as the “Upcoming Bookable Slots” block or the
[wbc-upcoming]shortcode (view demo) - The price on each slot, beside the spots left, and in its tooltip
- Allow to define product-specific colors view demo
- Allow to add availability calendar as widget using drag and drop (view demo)
- Allow to filter by specified product and categories in plugin settings, the shortcode and the block
- Reverse calendar logic to display only taken slots (view demo)
- Perform calendar search using AJAX without page reload view demo
- Support for WooCommerce Booking Accommodations
Get the PRO version here.
Installation
- Upload
woo-bookings-calendar.zipto the/wp-content/plugins/directory - Activate the plugin through the ‘Plugins’ menu in WordPress
- It’s done. Now you can go to the Settings to configure what you want
FAQ
Why my calendar events taking so much time to load?
When it happens the most common issue is the user is viewing calendar in Month mode, and bookable products are divided by small blocks of days, hours or minutes. This cause heavy CPU load to calculate events availability, and the solution is to set higher Booking duration blocks, or/and limit the calendar to display only in Day or/and Week mode.
Developer hooks
PHP filters (add_filter):
wbc_fullcalendar_options— the FullCalendar 6 options (array)wbc_calendar_start_date— the date the calendar opens on (Y-m-d)wbc_event_row— one event before it goes to the calendar ($event,$post,$product,$availables)wbc_build_events_array— all the events of one request ($events,$products,$start,$end)wbc_booking_products_args— the query of the products the calendar listswbc_bookable_product_types— the product types it lists (defaultarray( 'booking' )) — since 1.0.42wbc_available_colors— the colours of the available slots, one per product ($colors,$product) — since 1.0.42wbc_color_available/wbc_color_unavailable— one product’s colour ($product; return a CSS colour)wbc_calendar_class— the calendar element’s CSS classeswbc_shortcode_html— the calendar’s HTML ($html, and since 1.0.42 the shortcode’s$atts)shortcode_atts_wbc-calendar— WordPress’s own filter of the[wbc-calendar]attributes — since 1.0.42wbc_frontend_vars— the values handed to the calendar script (WBCVARS)
JavaScript events (jQuery, on document):
wbc_calendar_options(options,$el) — the FullCalendar options, before the calendar is created: callbacks go here — since 1.0.42wbc_events_request(postData,info) — the AJAX request for the events, before it is sent — since 1.0.42wbc_events_loaded(events,info) — the events the server sent, before they are drawn — since 1.0.42wbc_calendar_loaded($el,calendar) — the calendar is drawn; it is alsowindow.wbcCalendarwbc_event_click(event,jsEvent), andwbc_event_render(event,$element) ondocument.body
Screenshots







![Premium: the next free slots in a short list, each with a Book button (the Upcoming Bookable Slots block or [wbc-upcoming])](https://ps.w.org/woo-bookings-calendar/assets/screenshot-8.png?rev=3798375)
Changelog
1.1.1
- Tested with WooCommerce 11.3 and WordPress 7.1
1.1.0
- New: a “Bookings Calendar” block for the editor and block themes — its opening view, products and start date in the block’s sidebar (the
[wbc-calendar]shortcode stays) - New: the spots left on each slot (“3 spots left”), and a full slot shown greyed out as “Sold out” (Settings: “Show the spots left on each slot”)
- New: the calendar opens on the first day with a free slot, and a “Next available” button jumps to the next one
- New: on a phone the calendar shows as a list, as long as its slots (not a box scrolling inside the page), and its toolbar wraps
- New: the information tooltip on each slot (its description, the spots left — now on by default) is now part of the free plugin
- New: a faster month view — the slots of a request are kept a few minutes (“Keep the calendar slots for this many minutes”, 5) and worked out again as soon as a booking or a product changes
- Changed: a tidier settings page — a long setting’s label sits on its own line over its field (it ran to four lines in the label column), and a group with one long label shows all its labels that way
- Changed: taller hours in the day and week views, so a slot shows its time, its name and its spots left
- Fixed: the information tooltip has its own box (without the Premium version it showed as bare text)
1.0.42
- New: developer hooks — the
wbc_bookable_product_typesandwbc_available_colorsfilters, the shortcode’s attributes through WordPress’sshortcode_atts_wbc-calendarfilter (and passed towbc_shortcode_html), and the JavaScript eventswbc_calendar_options,wbc_events_requestandwbc_events_loaded; all listed in the FAQ - Fixed: the “Display loading” overlay counted on WooCommerce’s blockUI already being on the page; it is now queued with the calendar (under WooCommerce’s current
wc-jquery-blockuihandle), and the plugin no longer registers a second copy of it - Hardened: the calendar script cleaned up, with no change in what it does — the duplicated retry timers and time-label selectors made one, no deprecated jQuery calls (
$.trim,.click(),.ajaxSuccess(),.ready()), no stray globals, and the wait for the booking form’s date picker stops after a minute instead of polling for ever
1.0.41
- Hardened: WordPress.org Plugin Check warnings — the settings save checks its own nonce too, the read-only requests (the dates a calendar link opens on, the event search, the calendar’s product list, the settings tab) are sanitized and marked as such, the settings script’s global is prefixed (
wbc_tab_current), and translations are left to WordPress (no moreload_plugin_textdomain())
1.0.39
- Changed: a cleaner Get PRO tab — the PRO features one per row with a check, a red YouTube “Watch demo” button for each feature video, and the buy button at the top and the bottom
- Fixed: a settings tab whose name has a space opened empty
- Changed: a cleaner settings page — the settings in a card, one row each with the label and its field aligned, on/off settings as switches, multiple choices as chips, a setting’s sub-options in a panel under it, and Reset set apart from Save
1.0.38
- Fixed: on phones the week and day views showed a strip of three hours (06:00–09:00) and hid the bookable slots below it; a narrow calendar is now taller and its time grid opens at the first slot (unless a scrollTime is set through the wbc_fullcalendar_options filter)
1.0.37
- Security: the [wbc-calendar] shortcode attributes (cat, product, default-view, startdate) are validated and escaped, and so is the event search field (CVE-2024-31117, Cross Site Scripting)
- Security: removed the debug output that any visitor could trigger, and the product ids and dates read from the request are validated
- Updated FullCalendar to 6.1.15 (the 3.x calendar placed time-grid events wrong in current browsers)
- Fixed slot exclusions that were never applied and slots built twice; bookings are read once per product
- The common classes carry the plugin’s prefix, so other MH plugins no longer clash with it
- Tested up to WordPress 7.1 and WooCommerce 11.2
- Renamed to Bookings Calendar for WooCommerce
- Compatible with WooCommerce Bookings 3.x (tested with 3.8.0), which lists the time slots by their start time: the calendar showed no event with it. 1.x still works
1.0.36
- Fixed duplicated events when option “Reverse calendar logic to display only taken slots” enabled
- Added
High-Performance order storagecompatibility - Added check to respect the minimum booking time when display events on calendar
1.0.35
- Fixed overlapping events display bug
1.0.34
- Added a quick prevention to avoid show duplicated events for edge cases
- Fixed plugin domain for translation of “Search events” string
- Added HTML5 close button to Search events field
- Fixed calendar week, month, day labels locale
1.0.33
- Added configuration to define the first day of the week
- Added new calendar shortcode attribute: startdate=”Y-m-d”
1.0.32
- Adding support for new booking date ranges configuration (days of week)
1.0.31
- Fixed PHP code warnings and notices
- Tested with WooCommerce 6.1.1 and WordPress 5.9
1.0.30
- Tested with WooCommerce 5.6.0 and WordPress 5.8
1.0.29
- Updating WooCommerce tested up tag to 5.2.2
- Fixed bug on backend that not showing events on certain conditions
- Respecting the correct minimum and maximum future booking date limits
- Compatibilize with Private Google Calendars plugin to show calendar correctly
1.0.28
- Preventing JS error when blockUI loading library not available
1.0.27
- Tested with WordPress version 5.5.1
- Added wbc_shortcode_html filter when needed to append or transform shortcode HTML
- Fix calendar display for Tabs widget
1.0.26
- Refactoring code for better maintainability
- Removing firstDay parameter in FullCalendar to display correct in Week view mode
1.0.25
- Removing unwanted admin notices
- Updated WooCommerce tested tag
1.0.24
- Added new configuration: Disable back button to the past time
- Added wbc_fullcalendar_options hook to add extra FullCalendar settings
- Added JS hook wbc_calendar_loaded after FullCalendar was constructed
1.0.23
- Fixed translation textdomain loader
1.0.22
- Alert user on admin when some required extension does not enabled
- Tested with latest WordPress and WooCommerce versions
- Added wbc_calendar_start_date and wbc_calendar_class filter hooks
1.0.21
- Removing deprecated PHP short_open_tag blocks
- Fixed incorrect translation words
- Added default-view optional parameter in shortcode
1.0.20
- Reversed changelog ordering to make it more standard
- Changed plugin notices to respect the guidelines
- Added new config option: Fixed calendar start date
1.0.19
- Added compatibility with Woo Ultimate PRO
- Ignoring timezone conversion when opening booking page link
1.0.18
- Fixed bug that not checking availability when booking not have resources
1.0.17
- Added compatibility support with WooCommerce 4.0.1
1.0.16
- Fixed incorrect calls to get booking resources
- Added action wbc_after_shortcode_script_queue
- Added filter wbc_always_get_availables
1.0.15
- Added option to attach calendar in single booking page
1.0.14
- Added support for other calendar languages
1.0.13
- Simplified calendar view config in admin frontend
- Updated WC tested up to tag
1.0.12
- Allow to define display colors for available and not available items
1.0.11
- Added new config to define the behavior when item is not bookable
1.0.10
- Better loading style while update calendar
- Calendar events filter box option
- Time format configuration
- Display full event title on mouse over
- Removing redundant time information when event is full day slot