In this document, you will find many useful snippets for customizing the functionality of Bookings.
About snippets
To use a snippet, you can copy the contained code into your child theme’s functions.php file.
Customization
Make calendar default to first available booking
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’ ); |
Modify the date in a booking’s summary
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 ); |
Modify when In Cart bookings expire
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’ ); |
Enable Big Selects to fix MAX_JOIN_SIZE errors
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’ ); |
Automatically confirm bookings purchased via COD
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 ); |
Show Dependencies tab for Bookable products with WooCommerce Product Dependencies
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 ); |
Change date format when calendar picker is not used in front end
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’ ); |
Additionally, Bookings has templates that can be overridden for a more customized approach.
Use Custom Application from Google Developer’s Console for Calendar Integration
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:
| /** | |
| * 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’ ); | |
| } | |
| ); |