# booking/11.6.1/includes/booking_modes/booking_modes-setup.php Booking Calendar, version 11.6.1. 259 lines. - Page: https://pluginprobe.com/plugins/booking/11.6.1/code/includes/booking_modes/booking_modes-setup.php - Raw: https://pluginprobe.com/plugins/booking/11.6.1/raw/includes/booking_modes/booking_modes-setup.php - Modified: 2026-08-04T08:52:12+00:00 Line numbers below start at 1. Link to a line or a range by appending a fragment to the page URL, for example `https://pluginprobe.com/plugins/booking/11.6.1/code/includes/booking_modes/booking_modes-setup.php#L10-L20`. ```php > Setup choices keyed by mode ID. */ function wpbc_booking_modes_get_setup_mode_choices() { $registered_modes = wpbc_booking_modes_get_registered_modes(); $allowed_mode_ids = wpbc_booking_modes_get_allowed_mode_ids(); $choice_definitions = array( 'appointment' => array( 'title' => __( 'Appointments and services', 'booking' ), 'description' => __( 'Customers choose a Service, Provider, date, and start time.', 'booking' ), 'preference_title' => __( 'Appointment preferences', 'booking' ), 'allowed_booking_types' => array( 'time_slots_appointments' ), 'default_booking_type' => 'time_slots_appointments', 'fixed_appointment_type' => 'durationtime', ), 'rental' => array( 'title' => __( 'Properties and rentals', 'booking' ), 'description' => __( 'Guests reserve properties or other resources for one or more dates.', 'booking' ), 'preference_title' => __( 'Rental preferences', 'booking' ), 'allowed_booking_types' => array( 'full_days_bookings', 'changeover_multi_dates_bookings' ), 'default_booking_type' => 'full_days_bookings', ), 'classic' => array( 'title' => __( 'Classic Booking Calendar', 'booking' ), 'description' => __( 'Keep the traditional Booking Calendar terminology and configuration.', 'booking' ), 'preference_title' => __( 'Choose booking behavior', 'booking' ), 'allowed_booking_types' => array( 'full_days_bookings', 'time_slots_appointments', 'changeover_multi_dates_bookings' ), 'default_booking_type' => 'full_days_bookings', ), ); $setup_choices = array(); foreach ( $choice_definitions as $mode_id => $choice_definition ) { if ( ! isset( $registered_modes[ $mode_id ] ) || ! in_array( $mode_id, $allowed_mode_ids, true ) ) { continue; } $setup_choices[ $mode_id ] = array_merge( array( 'id' => $mode_id, 'fixed_appointment_type' => '', ), $choice_definition ); } return $setup_choices; } /** * Resolve the administration mode associated with a Setup Wizard booking type. * * The Setup Wizard remains authoritative for booking-form and availability * configuration. This mapping changes only the owner-scoped administration * presentation selected after that configuration is saved. * * @param string $booking_type Sanitized Setup Wizard booking type identifier. * @param string $requested_mode_id Optional explicit mode selected in Step 4. * * @return string Allowed Booking Modes identifier, or an empty string when the * booking type must not change the current selection. */ function wpbc_booking_modes_get_setup_mode_id( $booking_type, $requested_mode_id = '' ) { $booking_type = is_scalar( $booking_type ) ? sanitize_key( (string) $booking_type ) : ''; $requested_mode_id = is_scalar( $requested_mode_id ) ? sanitize_key( (string) $requested_mode_id ) : ''; if ( '' !== $requested_mode_id ) { return in_array( $requested_mode_id, wpbc_booking_modes_get_allowed_mode_ids(), true ) ? $requested_mode_id : ''; } $mode_map = array( 'full_days_bookings' => 'rental', 'time_slots_appointments' => 'appointment', 'changeover_multi_dates_bookings' => 'rental', ); /** * Filter the Setup Wizard booking-type to administration-mode mapping. * * @param array $mode_map Mode identifiers keyed by Setup Wizard booking type. * @param string $booking_type Sanitized booking type currently being resolved. */ $mode_map = apply_filters( 'wpbc_booking_modes_setup_booking_type_map', $mode_map, $booking_type ); if ( ! is_array( $mode_map ) || ! isset( $mode_map[ $booking_type ] ) ) { return ''; } $mode_id = is_scalar( $mode_map[ $booking_type ] ) ? sanitize_key( (string) $mode_map[ $booking_type ] ) : ''; return in_array( $mode_id, wpbc_booking_modes_get_allowed_mode_ids(), true ) ? $mode_id : ''; } /** * Persist the presentation mode selected indirectly by the Setup Wizard. * * This handler runs only after the wizard has validated, applied, and stored * its booking-type configuration. It deliberately does not run QuickStart or * mutate bookings, resources, Services, pages, availability, or prices. * * @param array $cleaned_data Validated Setup Wizard booking-type data. * * @return bool|WP_Error True when saved, false when no mapping applies, or a * storage error returned by the Booking Modes API. */ function wpbc_booking_modes_apply_setup_booking_type( $cleaned_data ) { if ( ! is_array( $cleaned_data ) || empty( $cleaned_data['wpbc_swp_booking_types'] ) ) { return false; } $requested_mode_id = isset( $cleaned_data['wpbc_swp_booking_mode'] ) ? $cleaned_data['wpbc_swp_booking_mode'] : ''; $mode_id = wpbc_booking_modes_get_setup_mode_id( $cleaned_data['wpbc_swp_booking_types'], $requested_mode_id ); if ( '' === $mode_id ) { return false; } return wpbc_booking_modes_set_selected_mode_id( $mode_id ); } add_action( 'wpbc_setup_wizard_booking_type_saved', 'wpbc_booking_modes_apply_setup_booking_type' ); /** * Add one published page to a Setup Wizard test-link collection. * * @param array $page_links Page-link collection passed by reference. * @param string $page_url Public page URL. * @param string $label Button label. * * @return void */ function wpbc_booking_modes_add_setup_test_page_link( &$page_links, $page_url, $label ) { $page_url = is_scalar( $page_url ) ? esc_url_raw( (string) $page_url ) : ''; $label = is_scalar( $label ) ? sanitize_text_field( (string) $label ) : ''; if ( '' === $page_url || '' === $label ) { return; } foreach ( $page_links as $page_link ) { if ( isset( $page_link['url'] ) && $page_url === $page_link['url'] ) { return; } } $page_links[] = array( 'url' => $page_url, 'label' => $label, ); } /** * Get published booking pages suitable for the active Setup Wizard mode. * * This is a read-only discovery operation. It reuses QuickStart ownership and * shortcode discovery when available, but never creates, republishes, or edits * site content. Classic mode falls back to the plugin's published activation * pages because it intentionally has no QuickStart operation. * * @param string $mode_id Optional mode ID. Empty uses the current selection. * * @return array Published page links. */ function wpbc_booking_modes_get_setup_test_page_links( $mode_id = '' ) { $mode_id = is_scalar( $mode_id ) ? sanitize_key( (string) $mode_id ) : ''; $mode_id = '' !== $mode_id ? $mode_id : wpbc_booking_modes_get_selected_mode_id(); $page_links = array(); if ( 'appointment' === $mode_id ) { $test_url = function_exists( 'wpbc_booking_modes_get_quickstart_test_url' ) ? wpbc_booking_modes_get_quickstart_test_url( 'appointment' ) : ''; if ( '' === $test_url && function_exists( 'wpbc_booking_modes_quickstart_find_page' ) ) { $appointment_page = wpbc_booking_modes_quickstart_find_page( 'appointment_booking', '[booking_appointment' ); if ( $appointment_page instanceof WP_Post && 'publish' === $appointment_page->post_status ) { $test_url = get_permalink( $appointment_page->ID ); } } wpbc_booking_modes_add_setup_test_page_link( $page_links, $test_url, __( 'Test Appointment Page', 'booking' ) ); } elseif ( 'rental' === $mode_id ) { $test_url = function_exists( 'wpbc_booking_modes_get_quickstart_test_url' ) ? wpbc_booking_modes_get_quickstart_test_url( 'rental' ) : ''; if ( '' === $test_url && function_exists( 'wpbc_booking_modes_quickstart_find_page' ) ) { $property_page = wpbc_booking_modes_quickstart_find_page( 'rental_property_booking', '[booking resource_id=' ); if ( $property_page instanceof WP_Post && 'publish' === $property_page->post_status ) { $test_url = get_permalink( $property_page->ID ); } } wpbc_booking_modes_add_setup_test_page_link( $page_links, $test_url, __( 'Test Property Page', 'booking' ) ); if ( function_exists( 'wpbc_booking_modes_quickstart_find_page' ) ) { $search_page = wpbc_booking_modes_quickstart_find_page( 'rental_availability_search', '[bookingsearch' ); if ( $search_page instanceof WP_Post && 'publish' === $search_page->post_status ) { wpbc_booking_modes_add_setup_test_page_link( $page_links, get_permalink( $search_page->ID ), __( 'Test Availability Search', 'booking' ) ); } } } elseif ( 'classic' === $mode_id ) { if ( function_exists( 'wpbc_booking_modes_quickstart_find_page' ) ) { foreach ( array( '[booking ', '[booking]' ) as $classic_shortcode_match ) { $classic_page = wpbc_booking_modes_quickstart_find_page( 'classic_booking_page', $classic_shortcode_match ); if ( $classic_page instanceof WP_Post && 'publish' === $classic_page->post_status ) { wpbc_booking_modes_add_setup_test_page_link( $page_links, get_permalink( $classic_page->ID ), __( 'Test Booking Page', 'booking' ) ); } } } if ( function_exists( 'wpbc_get_published_activation_booking_pages' ) ) { foreach ( wpbc_get_published_activation_booking_pages() as $published_page ) { if ( ! is_array( $published_page ) ) { continue; } $page_url = isset( $published_page['url'] ) ? $published_page['url'] : ''; $page_label = isset( $published_page['button_title'] ) ? $published_page['button_title'] : __( 'Test Booking Page', 'booking' ); wpbc_booking_modes_add_setup_test_page_link( $page_links, $page_url, $page_label ); } } } /** * Filter published booking-page links shown in the Setup Wizard bar. * * @param array $page_links Published page links with URL and button label. * @param string $mode_id Active Booking Modes identifier. */ $page_links = apply_filters( 'wpbc_booking_modes_setup_test_page_links', $page_links, $mode_id ); return is_array( $page_links ) ? $page_links : array(); } ```