Bookings Snippets: Tips and Tweaks

In this document, you will find many useful snippets for customizing the functionality of WooCommerce Bookings. To use a snippet, you can copy the contained code into your child theme‘s functions.php file.

Note:

This is a Developer level doc. If you are unfamiliar working with code and resolving potential conflicts, we recommend you work with a Woo Agency Partner for larger projects, or find a WooCommerce developer on Codeable for smaller customizations. We are unable to provide support for customizations under our Support Policy.

Snippets

↑ Back to top

Make calendar default to first available booking

↑ Back to top

By default the current month will be shown on the Bookings calendar for performance reasons. This will default it to the month with the first available block:

	/**
	* Will make the Bookings calender default to the month with the first available booking.
	*/
	add_filter( 'wc_bookings_calendar_default_to_current_date', '__return_false' );

view raw wc-bookings-bookings_calendar_default_to_first_available.php hosted with ❤ by GitHub

Modify the date in a booking’s summary

↑ Back to top

A booking’s date in its summary is able to be modified with the wc_bookings_summary_list_date filter. This filter passes three arguments, the original date string, the timestamp for the start, and the timestamp for the end.

This example will modify the date so that only the start date is returned for the summary:

	/**
	* wc_bookings_summary_list_date is used to filter a booking's summary date.
	* This example removes the end date for a multi-day booking.
	*
	* @param string $booking_date The formatted date that is displayed by default.
	* @param int $booking_start Timestamp for the booking start time/date.
	* @param int $booking_end Timestamp for the booking end time/date.
	* @return string The modified date string.
	*/
	function modify_summary_date_20170821( $booking_date, $booking_start, $booking_end ) {
	return date( 'F j, Y', $booking_start );
	}
	add_filter( 'wc_bookings_summary_list_date', 'modify_summary_date_20170821', 10, 3 );

view raw wc-bookings-summary-list-date hosted with ❤ by GitHub

Modify when In Cart bookings expire

↑ Back to top

When bookings are added to the cart, they are immediately created. This allows for blocks to be properly reserved on the calendar. By default, these bookings expire after 60 minutes and are deleted by a WP Cron event.

The woocommerce_bookings_remove_inactive_cart_time filter allows you to increase or decrease this time. The example below reduces the time to 30 minutes:

	<?php // do not copy this line

	/**
	* Will change the minutes it takes an In Cart booking to expire.
	* This example reduces the number from 60 to 30.
	*
	* @param int $minutes 60 is the default passed
	* @return int The amount of minutes you'd like to have In Cart bookings expire on.
	*/
	function change_incart_bookings_expiry_minutes_20170825( $minutes ) {
	return 30;
	}
	add_filter( 'woocommerce_bookings_remove_inactive_cart_time', 'change_incart_bookings_expiry_minutes_20170825' );

view raw change_incart_bookings_expiry_minutes.php hosted with ❤ by GitHub

Note: If this time is reduced to just a few minutes, then it is possible a booking may be removed from a customer’s cart before they complete checkout. The lowest recommended time is 15 minutes.

Enable Big Selects to fix MAX_JOIN_SIZE errors

↑ Back to top

Sometimes shared hosts have a low threshold for MAX_JOIN_SIZE, which causes problems with WooCommerce Bookings and WordPress in general. This example fixes that in most cases:

	/**
	* Will enable big selects when the host has a low threshold for MAX_JOIN_SIZE.
	* This is sometimes the case with shared hosting.
	*/
	function enable_big_selects_for_bookings_20170825() {
	global $wpdb;
	$wpdb->query( 'SET SQL_BIG_SELECTS=1' );
	}
	add_action( 'init', 'enable_big_selects_for_bookings_20170825' );

view raw wc-bookings-enable-big-selects-for-bookings.php hosted with ❤ by GitHub

Automatically confirm bookings purchased via COD

↑ Back to top

When an order is placed for a booking via COD it remains in Unpaid status. Some store owners may want to have these bookings moved to Confirmed status, this example will do that:

	/**
	* Will put bookings into a Confirmed status if they were paid for via COD.
	*
	* @param int $order_id The order id
	*/
	function set_cod_bookings_confirmed_20170825( $order_id ) {

	// Get the order, then make sure its payment method is COD.
	$order = wc_get_order( $order_id );
	if ( 'cod' !== $order->get_payment_method() ) {
	return;
	}
	// Call the data store class so we can get bookings from the order.
	$booking_data = new WC_Booking_Data_Store();
	$booking_ids = $booking_data->get_booking_ids_from_order_id( $order_id );
	// If we have bookings go through each and update the status.
	if ( is_array( $booking_ids ) && count( $booking_ids ) > 0 ) {
	foreach ( $booking_ids as $booking_id ) {
	$booking = get_wc_booking( $booking_id );
	$booking->update_status( 'confirmed' );
	}
	}
	}
	add_action( 'woocommerce_order_status_processing', 'set_cod_bookings_confirmed_20170825', 20 );

view raw wc-bookings-automatically-confirm-cod-bookings.php hosted with ❤ by GitHub

Show Dependencies tab for Bookable products with WooCommerce Product Dependencies

↑ Back to top

WooCommerce Product Dependencies is a great little extension that allows you to require one product if another is purchased. In order to get the Dependencies tab to show for Bookable products, a filter needs to be used:

	/**
	* Will make it so the Dependencies tab shows on a Bookable product.
	*
	* @param array $tabs The list of tabs in a product's settings.
	*/
	function add_bookable_product_to_dependencies( $tabs ) {
	// Check to see if the class exists and if the tab is set.
	if ( class_exists( 'WC_Product_Dependencies' ) && isset( $tabs['dependencies'] ) ) {
	// If so, add our class for the JS hooks.
	$tabs['dependencies']['class'][] = 'show_if_booking';
	}
	return $tabs;
	}
	add_filter( 'woocommerce_product_data_tabs', 'add_bookable_product_to_dependencies', 999 );

view raw wc-bookable-product-to-dependencies.php hosted with ❤ by GitHub

Change date format when calendar picker is not used in front end

↑ Back to top

By default the fields used for a customer to enter a date if the calendar picker is not used are in MM/DD/YYYY format. If you would like to update this to DD/MM/YYYY format, this snippet can be used:

	/**
	* Will make it so that the date format when the calendar is not used is DD/MM/YYYY on a Bookable product.
	*/
	add_filter( 'woocommerce_bookings_mdy_format' , '__return_false' );

view raw wc-bookings-mdy-format.php hosted with ❤ by GitHub

Additionally, Bookings has templates that can be overridden for a more customized approach.

Forward Booking Details to External Site Upon Confirmation

↑ Back to top

To forward booking details to an external site upon confirmation, you’ll need to make an API call to create a post on the external site. There is a WooCommerce Bookings hook to make these API calls. Please note that here we do not cover the specifics of making API calls to external sites.

The woocommerce_booking_{new_status} hook can be utilized to send booking details to an external site. This hook includes two parameters: $booking_id and the $booking object. It is triggered whenever a booking status changes.

Here’s an example of how to use this hook to pass the booking ID and booking object to a function, which can then be used to make an API call to create a post on the external site:

add_action( 'woocommerce_booking_confirmed', 'add_booking_to_other_site', 10, 2 );

function add_booking_to_other_site( $booking_id, $booking ) {
    // API call here based on the received $booking_id and $booking
    ...
}

Use Custom Application from Google Developer’s Console for Calendar Integration

↑ Back to top

To use the Bookings Google Calendar Integration it is necessary to grant permissions to the official WooCommerce app in order to give your store access to your Google Calendar. If you wish to use your own app setup in the Google Developer’s Console you can do so by updating the Google client’s ID and secret with this snippet:

	<?php

	/**
	* Update Google client with your own application's cliend ID and secret from the Google Developer's Console.
	*/
	add_action(
	'woocommerce_bookings_update_google_client',
	function ( Google_Client $client ) {
	$client->setClientId( 'YourClientIDFromGoogleDevelopersConsole' );
	$client->setClientSecret( 'YourClientIDFromGoogleDevelopersConsole' );
	}
	);

view raw functions.php hosted with ❤ by GitHub