# booking/11.9/includes/page-setup-wizard/step-review-setup/class-wpbc-setup-wizard-review-setup.php Booking Calendar, version 11.9. 1,024 lines. - Page: https://pluginprobe.com/plugins/booking/11.9/code/includes/page-setup-wizard/step-review-setup/class-wpbc-setup-wizard-review-setup.php - Raw: https://pluginprobe.com/plugins/booking/11.9/raw/includes/page-setup-wizard/step-review-setup/class-wpbc-setup-wizard-review-setup.php - Modified: 2026-10-03T20:32:36+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.9/code/includes/page-setup-wizard/step-review-setup/class-wpbc-setup-wizard-review-setup.php#L10-L20`. ```php $field_values Review-step field values. * @param array $consumer_context Validated values from earlier steps. * * @return array Review presentation data. */ public function get_context( array $field_values, array $consumer_context ) { $journey_id = $this->get_scalar_value( $consumer_context, 'customer_journey', 'customer_journey' ); $journeys = WPBC_Setup_Wizard_Step_Data::get_customer_journeys(); $journey = isset( $journeys[ $journey_id ] ) ? $journeys[ $journey_id ] : reset( $journeys ); $feedback_profile = array(); if ( WPBC_Setup_Wizard_Environment_Policy::allows_business_details() ) { $feedback_profile = $this->create_row( 'business_details', __( 'Business details', 'booking' ), $this->get_business_review( $consumer_context ) ); } return array( 'values' => $field_values, 'journey' => is_array( $journey ) ? $journey : array(), 'groups' => $this->get_review_groups( $consumer_context, $journey_id ), 'feedback_profile' => $feedback_profile, ); } /** * Return the ordered review groups for the current route. * * @param array $consumer_context Validated values from earlier steps. * @param string $journey_id Selected Customer Journey identifier. * * @return array>}> Review groups. */ private function get_review_groups( array $consumer_context, $journey_id ) { $general_rows = array(); $is_live_demo = WPBC_Setup_Wizard_Environment_Policy::is_live_demo(); $general_rows[] = $this->create_row( 'date_time_formats', __( 'Dates & times', 'booking' ), $this->get_date_time_review( $consumer_context ) ); $general_rows[] = $this->create_row( 'booking_experience', __( 'Terminology', 'booking' ), $this->get_booking_experience_review( $consumer_context ) ); $booking_rows = array(); if ( 'guided_appointment_flow' === $journey_id ) { $booking_rows[] = $this->create_row( 'services', __( 'Services', 'booking' ), $this->get_services_review( $consumer_context ) ); } if ( WPBC_Setup_Wizard_Customer_Journey_Policy::uses_booking_resources_configuration( $journey_id ) ) { $booking_rows[] = $this->create_row( 'booking_resources', __( 'Booking resources', 'booking' ), $this->get_booking_resources_review( $consumer_context ) ); } if ( WPBC_Setup_Wizard_Customer_Journey_Policy::uses_fixed_time_slots_configuration( $journey_id ) ) { $booking_rows[] = $this->create_row( 'fixed_time_slots', __( 'Fixed time slots', 'booking' ), $this->get_fixed_time_slots_review( $consumer_context ) ); } elseif ( WPBC_Setup_Wizard_Customer_Journey_Policy::uses_start_duration_configuration( $journey_id ) ) { $booking_rows[] = $this->create_row( 'start_duration_times', __( 'Start & duration times', 'booking' ), $this->get_start_duration_times_review( $consumer_context ) ); } elseif ( WPBC_Setup_Wizard_Customer_Journey_Policy::uses_start_end_configuration( $journey_id ) ) { $booking_rows[] = $this->create_row( 'start_end_times', __( 'Start & end times', 'booking' ), $this->get_start_end_times_review( $consumer_context ) ); } if ( WPBC_Setup_Wizard_Customer_Journey_Policy::uses_working_hours_configuration( $journey_id ) ) { $booking_rows[] = $this->create_row( 'working_hours', __( 'Working hours', 'booking' ), $this->get_working_hours_review( $consumer_context ) ); } $booking_rows[] = $this->create_row( 'days_off', __( 'Days off', 'booking' ), $this->get_days_off_review() ); $booking_rows[] = $this->create_row( 'date_selection', __( 'Date selection', 'booking' ), $this->get_date_selection_review( $consumer_context ) ); if ( WPBC_Setup_Wizard_Customer_Journey_Policy::uses_booking_form_and_appearance_route( $journey_id ) ) { $booking_rows[] = $this->create_row( 'booking_form_template', __( 'Booking form', 'booking' ), $this->get_booking_form_review( $consumer_context, $journey_id ) ); $booking_rows[] = $this->create_row( 'appearance', __( 'Appearance', 'booking' ), $this->get_appearance_review( $consumer_context ) ); } $groups = array( array( 'id' => 'business', 'label' => __( 'General settings', 'booking' ), 'rows' => $general_rows, ), array( 'id' => 'booking_experience', 'label' => __( 'Booking experience', 'booking' ), 'rows' => $booking_rows, ), ); if ( ! $is_live_demo && isset( $consumer_context['publish_integration'] ) ) { $groups[] = array( 'id' => 'publishing', 'label' => __( 'Publishing', 'booking' ), 'rows' => array( $this->create_row( 'publish_integration', __( 'Publish destination', 'booking' ), $this->get_publish_review( $consumer_context ) ), ), ); } return $groups; } /** * Create one stable review row. * * @param string $step_id Step edited by this row. * @param string $label Visible row label. * @param array $review Structured row presentation. * * @return array Review row. */ private function create_row( $step_id, $label, array $review ) { $details = array(); foreach ( isset( $review['details'] ) && is_array( $review['details'] ) ? $review['details'] : array() as $detail ) { if ( ! is_array( $detail ) || ! isset( $detail['label'], $detail['value'] ) ) { continue; } $normalized_detail = array( 'label' => sanitize_text_field( (string) $detail['label'] ), 'value' => sanitize_text_field( (string) $detail['value'] ), ); if ( ! empty( $detail['feedback_hidden'] ) ) { $normalized_detail['feedback_hidden'] = true; } if ( isset( $detail['feedback_value'] ) && is_scalar( $detail['feedback_value'] ) ) { $normalized_detail['feedback_value'] = sanitize_text_field( (string) $detail['feedback_value'] ); } if ( isset( $detail['url'] ) && is_scalar( $detail['url'] ) ) { $normalized_url = esc_url_raw( (string) $detail['url'] ); if ( '' !== $normalized_url ) { $normalized_detail['url'] = $normalized_url; } } $details[] = $normalized_detail; } $items = array(); foreach ( isset( $review['items'] ) && is_array( $review['items'] ) ? $review['items'] : array() as $item ) { if ( ! is_array( $item ) || ! isset( $item['label'], $item['value'] ) ) { continue; } $normalized_item = array( 'label' => sanitize_text_field( (string) $item['label'] ), 'value' => sanitize_text_field( (string) $item['value'] ), ); if ( ! empty( $item['feedback_hidden'] ) ) { $normalized_item['feedback_hidden'] = true; } if ( isset( $item['feedback_value'] ) && is_scalar( $item['feedback_value'] ) ) { $normalized_item['feedback_value'] = sanitize_text_field( (string) $item['feedback_value'] ); } $items[] = $normalized_item; } return array( 'step_id' => sanitize_key( $step_id ), 'label' => sanitize_text_field( $label ), 'summary' => isset( $review['summary'] ) ? sanitize_text_field( (string) $review['summary'] ) : '', 'details' => $details, 'items' => $items, 'items_label' => isset( $review['items_label'] ) ? sanitize_text_field( (string) $review['items_label'] ) : '', ); } /** * Describe Business details for the explicitly consented feedback email. * * Business details intentionally remain absent from the visible Review plan. * Keeping this record separate preserves the legacy feedback payload without * reintroducing the intentionally omitted Review row. * * @param array $consumer_context Earlier step values. * * @return array Structured review presentation. */ private function get_business_review( array $consumer_context ) { $values = isset( $consumer_context['business_details'] ) && is_array( $consumer_context['business_details'] ) ? $consumer_context['business_details'] : array(); $step_data = new WPBC_Setup_Wizard_Step_Data(); $business_name = isset( $values['business_name'] ) ? sanitize_text_field( (string) $values['business_name'] ) : ''; $business_stage = isset( $values['business_stage'] ) ? sanitize_key( (string) $values['business_stage'] ) : ''; $industry_id = isset( $values['industry'] ) ? sanitize_key( (string) $values['industry'] ) : ''; $industry_label = $this->find_grouped_option_label( $step_data->get_industry_groups(), $industry_id, __( 'Not selected', 'booking' ) ); $business_stages = $step_data->get_business_stages(); return array( 'summary' => '' !== $business_name ? $business_name : __( 'Business profile', 'booking' ), 'details' => array( $this->create_detail( __( 'Business name', 'booking' ), '' !== $business_name ? $business_name : __( 'Not configured', 'booking' ) ), $this->create_detail( __( 'Business stage', 'booking' ), isset( $business_stages[ $business_stage ] ) ? $business_stages[ $business_stage ] : __( 'Not selected', 'booking' ) ), $this->create_detail( __( 'Industry', 'booking' ), $industry_label ), $this->create_detail( __( 'Booking email', 'booking' ), isset( $values['booking_email'] ) ? sanitize_email( (string) $values['booking_email'] ) : '' ), $this->create_feedback_hidden_detail( __( 'Send setup details by email', 'booking' ), ! empty( $values['personalization_consent'] ) ? __( 'Enabled', 'booking' ) : __( 'Disabled', 'booking' ) ), ), ); } /** * Describe every selected date, time, language, and week-start choice. * * @param array $consumer_context Earlier step values. * * @return array Structured review presentation. */ private function get_date_time_review( array $consumer_context ) { $date_format = $this->get_scalar_value( $consumer_context, 'date_time_formats', 'date_format' ); $time_format = $this->get_scalar_value( $consumer_context, 'date_time_formats', 'time_format' ); $week_start = absint( $this->get_scalar_value( $consumer_context, 'date_time_formats', 'start_day_of_week' ) ); $weekdays = array( __( 'Sunday', 'booking' ), __( 'Monday', 'booking' ), __( 'Tuesday', 'booking' ), __( 'Wednesday', 'booking' ), __( 'Thursday', 'booking' ), __( 'Friday', 'booking' ), __( 'Saturday', 'booking' ), ); $sample_time = wp_date( in_array( $time_format, array( 'g:i a', 'g:i A', 'H:i' ), true ) ? $time_format : 'H:i', 48600, new DateTimeZone( 'UTC' ) ); $date_time_context = ( new WPBC_Setup_Wizard_Date_Time_Formats() )->get_context( isset( $consumer_context['date_time_formats'] ) && is_array( $consumer_context['date_time_formats'] ) ? $consumer_context['date_time_formats'] : array() ); $language = isset( $date_time_context['site_language'] ) && is_array( $date_time_context['site_language'] ) ? $date_time_context['site_language'] : array(); $sample_date = wp_date( '' !== $date_format ? $date_format : 'F j, Y', strtotime( '2027-03-24 12:00:00 UTC' ), new DateTimeZone( 'UTC' ) ); return array( /* translators: 1: Example date, 2: Example time. */ 'summary' => sprintf( __( '%1$s at %2$s', 'booking' ), $sample_date, $sample_time ), 'details' => array( $this->create_feedback_hidden_detail( __( 'Date format', 'booking' ), $date_format ), $this->create_feedback_hidden_detail( __( 'Time format', 'booking' ), $time_format ), $this->create_detail( __( 'Week starts', 'booking' ), $weekdays[ min( 6, $week_start ) ] ), $this->create_detail( __( 'Website language', 'booking' ), isset( $language['label'] ) ? $language['label'] : '' ), $this->create_detail( __( 'Translation source', 'booking' ), isset( $language['translation_source_label'] ) ? $language['translation_source_label'] : '' ), $this->create_feedback_hidden_detail( __( 'Translation status', 'booking' ), isset( $language['status_label'] ) ? $language['status_label'] : '' ), ), ); } /** * Describe the selected administration terminology mode. * * @param array $consumer_context Earlier step values. * * @return array Structured review presentation. */ private function get_booking_experience_review( array $consumer_context ) { $mode_id = $this->get_scalar_value( $consumer_context, 'booking_experience', 'booking_experience' ); $context = ( new WPBC_Setup_Wizard_Step_Data() )->get_step_context( 'booking_experience', $consumer_context ); $record = $this->find_record( isset( $context['experiences'] ) && is_array( $context['experiences'] ) ? $context['experiences'] : array(), 'id', $mode_id ); return array( 'summary' => isset( $record['title'] ) ? $record['title'] : __( 'Booking Calendar', 'booking' ), 'details' => array( $this->create_detail( __( 'Administration label', 'booking' ), isset( $record['toolbar_label'] ) ? $record['toolbar_label'] : '' ), $this->create_feedback_hidden_detail( __( 'Administration areas', 'booking' ), isset( $record['dashboard_uses'] ) ? $record['dashboard_uses'] : '' ), $this->create_feedback_hidden_detail( __( 'Best for', 'booking' ), isset( $record['best_for'] ) ? $record['best_for'] : '' ), ), ); } /** * Describe every proposed Service. * * @param array $consumer_context Earlier step values. * * @return array Structured review presentation. */ private function get_services_review( array $consumer_context ) { $services = isset( $consumer_context['services']['services'] ) && is_array( $consumer_context['services']['services'] ) ? array_values( $consumer_context['services']['services'] ) : array(); if ( empty( $services ) ) { return array( 'summary' => __( 'No Services selected', 'booking' ) ); } $services_context = ( new WPBC_Setup_Wizard_Services() )->get_context( array( 'services' => $services ) ); $show_price = ! empty( $services_context['pricing_available'] ); $currency_symbol = isset( $services_context['currency_symbol'] ) ? (string) $services_context['currency_symbol'] : '$'; $items = array(); foreach ( $services as $service_index => $service ) { $service = is_array( $service ) ? $service : array(); $service_title = isset( $service['title'] ) && '' !== trim( (string) $service['title'] ) ? (string) $service['title'] : sprintf( __( 'Service %d', 'booking' ), $service_index + 1 ); $parts = array(); /* translators: %d: Service duration in minutes. */ $parts[] = sprintf( __( '%d minutes', 'booking' ), isset( $service['duration_minutes'] ) ? absint( $service['duration_minutes'] ) : 0 ); /* translators: 1: Buffer before in minutes, 2: Buffer after in minutes. */ $parts[] = sprintf( __( 'Buffers: %1$d before, %2$d after', 'booking' ), isset( $service['buffer_before_minutes'] ) ? absint( $service['buffer_before_minutes'] ) : 0, isset( $service['buffer_after_minutes'] ) ? absint( $service['buffer_after_minutes'] ) : 0 ); if ( $show_price && isset( $service['base_cost'] ) && is_numeric( $service['base_cost'] ) ) { $parts[] = sprintf( '%1$s%2$s', $currency_symbol, number_format_i18n( (float) $service['base_cost'], 2 ) ); } $parts[] = isset( $service['status'] ) && 'active' === $service['status'] ? __( 'Active', 'booking' ) : __( 'Inactive', 'booking' ); $feedback_parts = $parts; if ( ! empty( $service['description'] ) ) { $parts[] = sprintf( __( 'Description: %s', 'booking' ), sanitize_textarea_field( (string) $service['description'] ) ); } $image_state = ! empty( $service['picture_url'] ) ? __( 'Image selected', 'booking' ) : __( 'No image', 'booking' ); $parts[] = $image_state; $feedback_parts[] = $image_state; $items[] = $this->create_feedback_value_detail( $service_title, implode( ' · ', $parts ), implode( ' · ', $feedback_parts ) ); } return array( /* translators: %d: Number of Services. */ 'summary' => sprintf( _n( '%d Service configured', '%d Services configured', count( $services ), 'booking' ), count( $services ) ), 'items' => $items, 'items_label' => __( 'Review configured Services', 'booking' ), ); } /** * Describe Booking Resources created or reused by the full-day route. * * @param array $consumer_context Earlier step values and verified results. * * @return array Structured review presentation. */ private function get_booking_resources_review( array $consumer_context ) { $resource_drafts = isset( $consumer_context['booking_resources']['booking_resources'] ) && is_array( $consumer_context['booking_resources']['booking_resources'] ) ? array_values( $consumer_context['booking_resources']['booking_resources'] ) : array(); $items = array(); foreach ( $resource_drafts as $resource_index => $resource_draft ) { $resource_draft = is_array( $resource_draft ) ? $resource_draft : array(); $title = isset( $resource_draft['title'] ) && '' !== trim( (string) $resource_draft['title'] ) ? (string) $resource_draft['title'] : sprintf( __( 'Booking Resource %d', 'booking' ), $resource_index + 1 ); $description = isset( $resource_draft['description'] ) ? sanitize_textarea_field( (string) $resource_draft['description'] ) : ''; $items[] = $this->create_detail( $title, '' !== $description ? $description : __( 'No description', 'booking' ) ); } if ( empty( $items ) ) { return array( 'summary' => __( 'Existing Booking Resources retained', 'booking' ) ); } return array( /* translators: %d: Number of Booking Resources created by Setup Wizard. */ 'summary' => sprintf( _n( '%d Booking Resource created', '%d Booking Resources created', count( $items ), 'booking' ), count( $items ) ), 'items' => $items, 'items_label' => __( 'Review created Booking Resources', 'booking' ), ); } /** * Describe the complete weekly Working Hours proposal. * * @param array $consumer_context Earlier step values. * * @return array Structured review presentation. */ private function get_working_hours_review( array $consumer_context ) { $working_hours = isset( $consumer_context['working_hours']['working_hours'] ) && is_array( $consumer_context['working_hours']['working_hours'] ) ? $consumer_context['working_hours']['working_hours'] : array(); $weekdays = isset( $working_hours['weekdays'] ) && is_array( $working_hours['weekdays'] ) ? $working_hours['weekdays'] : array(); $enabled_days = array_filter( $weekdays ); $time_format = $this->get_scalar_value( $consumer_context, 'date_time_formats', 'time_format' ); $time_format = in_array( $time_format, array( 'g:i a', 'g:i A', 'H:i' ), true ) ? $time_format : 'H:i'; $weekday_labels = array( 1 => __( 'Monday', 'booking' ), 2 => __( 'Tuesday', 'booking' ), 3 => __( 'Wednesday', 'booking' ), 4 => __( 'Thursday', 'booking' ), 5 => __( 'Friday', 'booking' ), 6 => __( 'Saturday', 'booking' ), 0 => __( 'Sunday', 'booking' ), ); $items = array(); foreach ( $weekday_labels as $day_number => $weekday_label ) { $intervals = isset( $weekdays[ $day_number ] ) && is_array( $weekdays[ $day_number ] ) ? $weekdays[ $day_number ] : array(); $labels = array(); foreach ( $intervals as $interval ) { if ( ! is_array( $interval ) || ! isset( $interval['start_second'], $interval['end_second'] ) ) { continue; } $labels[] = $this->format_time_second( $interval['start_second'], $time_format ) . '–' . $this->format_time_second( $interval['end_second'], $time_format ); } $items[] = $this->create_detail( $weekday_label, ! empty( $labels ) ? implode( ', ', $labels ) : __( 'Closed', 'booking' ) ); } return array( /* translators: %d: Number of working days. */ 'summary' => ! empty( $enabled_days ) ? sprintf( _n( '%d working day', '%d working days', count( $enabled_days ), 'booking' ), count( $enabled_days ) ) : __( 'No working hours selected', 'booking' ), 'details' => array( $this->create_detail( __( 'Schedule status', 'booking' ), isset( $working_hours['enabled'] ) && 'On' === $working_hours['enabled'] ? __( 'Enabled', 'booking' ) : __( 'Disabled', 'booking' ) ), ), 'items' => $items, 'items_label' => __( 'Review the weekly schedule', 'booking' ), ); } /** * Describe the ordered start and end choices without expanding long lists. * * @param array $consumer_context Earlier step values. * * @return array Structured review presentation. */ private function get_start_end_times_review( array $consumer_context ) { $time_choices = isset( $consumer_context['start_end_times']['start_end_times'] ) && is_array( $consumer_context['start_end_times']['start_end_times'] ) ? $consumer_context['start_end_times']['start_end_times'] : array(); $start_times = isset( $time_choices['start_times'] ) && is_array( $time_choices['start_times'] ) ? array_values( $time_choices['start_times'] ) : array(); $end_times = isset( $time_choices['end_times'] ) && is_array( $time_choices['end_times'] ) ? array_values( $time_choices['end_times'] ) : array(); $time_format = $this->get_scalar_value( $consumer_context, 'date_time_formats', 'time_format' ); $time_format = in_array( $time_format, array( 'g:i a', 'g:i A', 'H:i' ), true ) ? $time_format : 'H:i'; return array( /* translators: 1: Number of start-time choices, 2: Number of end-time choices. */ 'summary' => sprintf( __( '%1$d start times / %2$d end times', 'booking' ), count( $start_times ), count( $end_times ) ), 'details' => array( $this->create_detail( __( 'Start times', 'booking' ), $this->format_time_choice_summary( $start_times, $time_format ) ), $this->create_detail( __( 'End times', 'booking' ), $this->format_time_choice_summary( $end_times, $time_format ) ), ), ); } /** * Describe ordered start-time and duration choices without long output. * * @param array $consumer_context Earlier step values. * * @return array Structured review presentation. */ private function get_start_duration_times_review( array $consumer_context ) { $time_choices = isset( $consumer_context['start_duration_times']['start_duration_times'] ) && is_array( $consumer_context['start_duration_times']['start_duration_times'] ) ? $consumer_context['start_duration_times']['start_duration_times'] : array(); $start_times = isset( $time_choices['start_times'] ) && is_array( $time_choices['start_times'] ) ? array_values( $time_choices['start_times'] ) : array(); $duration_times = isset( $time_choices['duration_times'] ) && is_array( $time_choices['duration_times'] ) ? array_values( $time_choices['duration_times'] ) : array(); $time_format = $this->get_scalar_value( $consumer_context, 'date_time_formats', 'time_format' ); $time_format = in_array( $time_format, array( 'g:i a', 'g:i A', 'H:i' ), true ) ? $time_format : 'H:i'; $duration_labels = array(); $duration_service = new WPBC_Setup_Wizard_Start_Duration_Times(); foreach ( array_slice( $duration_times, 0, 5 ) as $duration_time ) { if ( ! is_scalar( $duration_time ) || ! preg_match( '/^(?:[01]\d|2[0-3]):[0-5]\d$|^24:00$/', (string) $duration_time ) ) { continue; } list( $hour, $minute ) = array_map( 'intval', explode( ':', (string) $duration_time ) ); $duration_labels[] = $duration_service->format_duration_label( ( $hour * 60 ) + $minute ); } $hidden_duration_count = count( $duration_times ) - count( $duration_labels ); if ( 0 < $hidden_duration_count ) { /* translators: %d: Number of additional duration choices omitted from the compact summary. */ $duration_labels[] = sprintf( _n( '%d more duration', '%d more durations', $hidden_duration_count, 'booking' ), $hidden_duration_count ); } return array( /* translators: 1: Number of start-time choices, 2: Number of duration choices. */ 'summary' => sprintf( __( '%1$d start times / %2$d durations', 'booking' ), count( $start_times ), count( $duration_times ) ), 'details' => array( $this->create_detail( __( 'Start times', 'booking' ), $this->format_time_choice_summary( $start_times, $time_format ) ), $this->create_detail( __( 'Durations', 'booking' ), ! empty( $duration_labels ) ? implode( ', ', $duration_labels ) : __( 'Not configured', 'booking' ) ), ), ); } /** * Describe ordered fixed time-slot ranges without expanding long lists. * * @param array $consumer_context Earlier step values. * * @return array Structured review presentation. */ private function get_fixed_time_slots_review( array $consumer_context ) { $fixed_time_slots = isset( $consumer_context['fixed_time_slots']['fixed_time_slots']['time_slots'] ) && is_array( $consumer_context['fixed_time_slots']['fixed_time_slots']['time_slots'] ) ? array_values( $consumer_context['fixed_time_slots']['fixed_time_slots']['time_slots'] ) : array(); $time_format = $this->get_scalar_value( $consumer_context, 'date_time_formats', 'time_format' ); $time_format = in_array( $time_format, array( 'g:i a', 'g:i A', 'H:i' ), true ) ? $time_format : 'H:i'; $slot_labels = array(); $slot_service = new WPBC_Setup_Wizard_Fixed_Time_Slots(); foreach ( array_slice( $fixed_time_slots, 0, 5 ) as $time_slot ) { if ( ! is_array( $time_slot ) || ! isset( $time_slot['start_time'], $time_slot['end_time'] ) ) { continue; } $start_label = $slot_service->format_time_label( (string) $time_slot['start_time'], $time_format ); $end_label = $slot_service->format_time_label( (string) $time_slot['end_time'], $time_format ); if ( '' !== $start_label && '' !== $end_label ) { $slot_labels[] = $start_label . '–' . $end_label; } } $hidden_slot_count = count( $fixed_time_slots ) - count( $slot_labels ); if ( 0 < $hidden_slot_count ) { /* translators: %d: Number of additional fixed time slots omitted from the compact summary. */ $slot_labels[] = sprintf( _n( '%d more slot', '%d more slots', $hidden_slot_count, 'booking' ), $hidden_slot_count ); } return array( /* translators: %d: Number of fixed time slots. */ 'summary' => sprintf( _n( '%d fixed time slot', '%d fixed time slots', count( $fixed_time_slots ), 'booking' ), count( $fixed_time_slots ) ), 'details' => array( $this->create_detail( __( 'Time slots', 'booking' ), ! empty( $slot_labels ) ? implode( ', ', $slot_labels ) : __( 'Not configured', 'booking' ) ), ), ); } /** * Describe all current canonical unavailable-date ranges. * * @return array Structured review presentation. */ private function get_days_off_review() { $state = ( new WPBC_Setup_Wizard_Days_Off() )->get_state(); if ( is_wp_error( $state ) || empty( $state['ranges'] ) || ! is_array( $state['ranges'] ) ) { return array( 'summary' => __( 'No upcoming unavailable date periods', 'booking' ) ); } $range_count = count( $state['ranges'] ); $items = array(); foreach ( $state['ranges'] as $range ) { if ( ! is_array( $range ) || empty( $range['label'] ) ) { continue; } $day_count = isset( $range['day_count'] ) ? absint( $range['day_count'] ) : 0; $scope = isset( $range['scope_label'] ) ? sanitize_text_field( (string) $range['scope_label'] ) : ''; /* translators: 1: Number of unavailable days, 2: Booking-item scope. */ $description = sprintf( _n( '%1$d day · %2$s', '%1$d days · %2$s', $day_count, 'booking' ), $day_count, $scope ); $items[] = $this->create_detail( $range['label'], $description ); } return array( /* translators: %d: Number of unavailable date periods. */ 'summary' => sprintf( _n( '%d unavailable date period', '%d unavailable date periods', $range_count, 'booking' ), $range_count ), 'items' => $items, 'items_label' => __( 'Review unavailable date periods', 'booking' ), ); } /** * Describe the complete customer-facing Date Selection policy. * * @param array $consumer_context Earlier step values. * * @return array Structured review presentation. */ private function get_date_selection_review( array $consumer_context ) { $values = isset( $consumer_context['date_selection'] ) && is_array( $consumer_context['date_selection'] ) ? $consumer_context['date_selection'] : array(); $mode_id = $this->get_scalar_value( $consumer_context, 'date_selection', 'date_selection_mode' ); $labels = array( 'single' => __( 'Single day', 'booking' ), 'multiple' => __( 'Multiple days', 'booking' ), 'dynamic' => __( 'Flexible range', 'booking' ), 'fixed' => __( 'Fixed range', 'booking' ), ); $details = array(); if ( 'fixed' === $mode_id ) { $details[] = $this->create_detail( __( 'Number of selected days', 'booking' ), isset( $values['date_selection_fixed_days'] ) ? absint( $values['date_selection_fixed_days'] ) : 0 ); $details[] = $this->create_detail( __( 'Booking can start on', 'booking' ), $this->format_weekday_selection( isset( $values['date_selection_fixed_weekdays'] ) ? $values['date_selection_fixed_weekdays'] : '' ) ); } elseif ( 'dynamic' === $mode_id ) { $details[] = $this->create_detail( __( 'Minimum days', 'booking' ), isset( $values['date_selection_dynamic_min'] ) ? absint( $values['date_selection_dynamic_min'] ) : 0 ); $details[] = $this->create_detail( __( 'Maximum days', 'booking' ), isset( $values['date_selection_dynamic_max'] ) ? absint( $values['date_selection_dynamic_max'] ) : 0 ); $details[] = $this->create_detail( __( 'Specific selectable lengths', 'booking' ), ! empty( $values['date_selection_dynamic_specific'] ) ? $values['date_selection_dynamic_specific'] : __( 'Any length within the range', 'booking' ) ); $details[] = $this->create_detail( __( 'Booking can start on', 'booking' ), $this->format_weekday_selection( isset( $values['date_selection_dynamic_weekdays'] ) ? $values['date_selection_dynamic_weekdays'] : '' ) ); } $changeover_enabled = isset( $values['date_selection_changeover_enabled'] ) && 'On' === $values['date_selection_changeover_enabled']; $details[] = $this->create_detail( __( 'Changeover days', 'booking' ), $this->format_toggle( $changeover_enabled ) ); if ( $changeover_enabled ) { $details[] = $this->create_detail( __( 'Check-in time', 'booking' ), isset( $values['date_selection_check_in_time'] ) ? $values['date_selection_check_in_time'] : '' ); $details[] = $this->create_detail( __( 'Check-out time', 'booking' ), isset( $values['date_selection_check_out_time'] ) ? $values['date_selection_check_out_time'] : '' ); $details[] = $this->create_detail( __( 'Show changeover days as triangles', 'booking' ), $this->format_toggle( isset( $values['date_selection_triangles'] ) && 'On' === $values['date_selection_triangles'] ) ); } $details[] = $this->create_detail( __( 'Use selected times for each booking date', 'booking' ), $this->format_toggle( isset( $values['date_selection_recurrent_time'] ) && 'On' === $values['date_selection_recurrent_time'] ) ); $details[] = $this->create_detail( __( 'Set check-out date as available', 'booking' ), $this->format_toggle( isset( $values['date_selection_checkout_available'] ) && 'On' === $values['date_selection_checkout_available'] ) ); $details[] = $this->create_detail( __( 'Calendar legend', 'booking' ), $this->format_toggle( isset( $values['date_selection_legend_enabled'] ) && 'On' === $values['date_selection_legend_enabled'] ) ); $legend_items = array(); foreach ( ( new WPBC_Setup_Wizard_Date_Selection() )->get_legend_items() as $legend_item ) { $legend_id = $legend_item['id']; $show_key = 'date_selection_legend_item_' . $legend_id; $text_key = 'date_selection_legend_text_' . $legend_id; $legend_text = ! empty( $values[ $text_key ] ) ? $values[ $text_key ] : $legend_item['placeholder']; $legend_items[] = $this->create_detail( $legend_item['label'], isset( $values[ $show_key ] ) && 'On' === $values[ $show_key ] ? sprintf( __( 'Shown as “%s”', 'booking' ), $legend_text ) : __( 'Hidden', 'booking' ) ); } $legend_items[] = $this->create_detail( __( 'Show date number', 'booking' ), $this->format_toggle( isset( $values['date_selection_legend_show_numbers'] ) && 'On' === $values['date_selection_legend_show_numbers'] ) ); $legend_items[] = $this->create_detail( __( 'Legend layout', 'booking' ), isset( $values['date_selection_legend_vertical'] ) && 'On' === $values['date_selection_legend_vertical'] ? __( 'Column', 'booking' ) : __( 'Row', 'booking' ) ); return array( 'summary' => isset( $labels[ $mode_id ] ) ? $labels[ $mode_id ] : __( 'Date selection', 'booking' ), 'details' => $details, 'items' => $legend_items, 'items_label' => __( 'Review Calendar legend items', 'booking' ), ); } /** * Summarize the selected Booking Form template and entry point. * * @param array $consumer_context Earlier step values. * @param string $journey_id Selected Customer Journey ID. * * @return array Structured review presentation. */ private function get_booking_form_review( array $consumer_context, $journey_id ) { $values = isset( $consumer_context['booking_form_template'] ) && is_array( $consumer_context['booking_form_template'] ) ? $consumer_context['booking_form_template'] : array(); $context = ( new WPBC_Setup_Wizard_Booking_Form_Templates() )->get_context( $values, $journey_id ); $template = isset( $context['selected_template'] ) && is_array( $context['selected_template'] ) ? $context['selected_template'] : array(); $title = isset( $template['title'] ) ? sanitize_text_field( (string) $template['title'] ) : __( 'Booking form', 'booking' ); $usage = isset( $values['booking_form_usage'] ) ? sanitize_key( (string) $values['booking_form_usage'] ) : ''; $usage_record = $this->find_record( isset( $context['usage_options'] ) && is_array( $context['usage_options'] ) ? $context['usage_options'] : array(), 'id', $usage ); $usage_label = isset( $usage_record['label'] ) ? $usage_record['label'] : __( 'Direct booking form', 'booking' ); return array( 'summary' => $title, 'details' => array( $this->create_detail( __( 'Entry point', 'booking' ), $usage_label ), $this->create_detail( __( 'Entry-point behavior', 'booking' ), isset( $usage_record['description'] ) ? $usage_record['description'] : '' ), $this->create_detail( __( 'Template category', 'booking' ), isset( $template['category'] ) ? $template['category'] : '' ), $this->create_feedback_hidden_detail( __( 'Template description', 'booking' ), isset( $template['description'] ) ? $template['description'] : '' ), ), ); } /** * Summarize the selected appearance style and accent. * * @param array $consumer_context Earlier step values. * * @return array Structured review presentation. */ private function get_appearance_review( array $consumer_context ) { $values = isset( $consumer_context['appearance'] ) && is_array( $consumer_context['appearance'] ) ? $consumer_context['appearance'] : array(); $appearance = new WPBC_Setup_Wizard_Appearance(); $style_id = isset( $values['booking_form_style'] ) ? sanitize_key( (string) $values['booking_form_style'] ) : ''; $accent = isset( $values['booking_form_accent_color'] ) ? sanitize_hex_color( (string) $values['booking_form_accent_color'] ) : ''; $style_label = $this->find_record_label( $appearance->get_starting_styles(), 'id', $style_id, __( 'Booking appearance', 'booking' ) ); $accent_label = $this->find_record_label( $appearance->get_accent_colors(), 'value', $accent, $accent ); $skin_value = isset( $values['booking_skin'] ) ? sanitize_text_field( (string) $values['booking_skin'] ) : ''; $skin_label = $this->find_grouped_record_label( $appearance->get_calendar_skin_groups(), 'value', $skin_value, $skin_value ); return array( 'summary' => $style_label, 'details' => array( $this->create_detail( __( 'Accent color', 'booking' ), trim( $accent_label . ( '' !== $accent ? ' (' . $accent . ')' : '' ) ) ), $this->create_detail( __( 'Calendar skin', 'booking' ), $skin_label ), $this->create_detail( __( 'Time choices', 'booking' ), isset( $values['booking_timeslot_picker'] ) && 'On' === $values['booking_timeslot_picker'] ? __( 'Time-slot picker', 'booking' ) : __( 'Standard time choices', 'booking' ) ), ), ); } /** * Summarize the saved publishing destination and verified operation result. * * @param array $consumer_context Earlier step values. * @return array Structured review presentation. */ private function get_publish_review( array $consumer_context ) { $values = isset( $consumer_context['publish_integration'] ) && is_array( $consumer_context['publish_integration'] ) ? $consumer_context['publish_integration'] : array(); $step_results = isset( $consumer_context['_step_results'] ) && is_array( $consumer_context['_step_results'] ) ? $consumer_context['_step_results'] : array(); $publish_result = isset( $step_results['publish_integration'] ) && is_array( $step_results['publish_integration'] ) ? $step_results['publish_integration'] : array(); $destination = isset( $values['publish_destination'] ) ? sanitize_key( (string) $values['publish_destination'] ) : ''; $labels = array( WPBC_Setup_Wizard_Publish_Integration::DESTINATION_CREATE_PAGE => __( 'Create a new page', 'booking' ), WPBC_Setup_Wizard_Publish_Integration::DESTINATION_EXISTING_PAGE => __( 'Use an existing page', 'booking' ), WPBC_Setup_Wizard_Publish_Integration::DESTINATION_MANUAL => __( 'Add it manually', 'booking' ), WPBC_Setup_Wizard_Publish_Integration::DESTINATION_LATER => __( 'Decide later', 'booking' ), ); $service = new WPBC_Setup_Wizard_Publish_Integration(); $journey_id = $this->get_scalar_value( $consumer_context, 'customer_journey', 'customer_journey' ); $form_slug = $this->get_scalar_value( $consumer_context, 'booking_form_template', 'booking_form_template' ); $content_options = $service->get_content_options( $journey_id, $form_slug ); $content_id = isset( $values['publish_page_content'] ) ? sanitize_key( (string) $values['publish_page_content'] ) : ''; if ( WPBC_Setup_Wizard_Publish_Integration::CONTENT_RECOMMENDED === $content_id ) { $content_id = $service->get_recommended_content_id( $journey_id ); } $content_record = $this->find_record( $content_options, 'id', $content_id ); $page_title = isset( $values['publish_page_title'] ) ? sanitize_text_field( (string) $values['publish_page_title'] ) : ''; $page_id = isset( $values['publish_existing_page_id'] ) ? absint( $values['publish_existing_page_id'] ) : 0; $page_label = ''; $page_url = ''; if ( WPBC_Setup_Wizard_Publish_Integration::DESTINATION_CREATE_PAGE === $destination ) { $page_id = $this->get_result_page_id( $publish_result, 'wp_page_created:' ); if ( $page_id && current_user_can( 'edit_post', $page_id ) ) { $permalink = get_permalink( $page_id ); $page_label = sanitize_text_field( get_the_title( $page_id ) ); $page_url = is_string( $permalink ) ? esc_url_raw( $permalink ) : ''; } else { $page_label = $page_title; $page_url = $service->get_new_page_url_preview( $page_title ); } } elseif ( WPBC_Setup_Wizard_Publish_Integration::DESTINATION_EXISTING_PAGE === $destination && $page_id && current_user_can( 'edit_post', $page_id ) ) { $permalink = get_permalink( $page_id ); $page_label = sanitize_text_field( get_the_title( $page_id ) ); $page_url = is_string( $permalink ) ? esc_url_raw( $permalink ) : ''; } $details = array( $this->create_detail( __( 'WordPress page', 'booking' ), '' !== $page_label ? $page_label : __( 'No page selected', 'booking' ) ), $this->create_link_detail( __( 'Page URL', 'booking' ), $page_url ), $this->create_detail( __( 'Page content', 'booking' ), isset( $content_record['label'] ) ? $content_record['label'] : __( 'Not applicable', 'booking' ) ), $this->create_detail( __( 'Booking shortcode', 'booking' ), isset( $content_record['shortcode'] ) ? $content_record['shortcode'] : __( 'Not applicable', 'booking' ) ), ); if ( isset( $publish_result['summary'] ) && is_scalar( $publish_result['summary'] ) && '' !== trim( (string) $publish_result['summary'] ) ) { $details[] = $this->create_detail( __( 'Save result', 'booking' ), (string) $publish_result['summary'] ); } return array( 'summary' => isset( $labels[ $destination ] ) ? $labels[ $destination ] : __( 'Publishing plan', 'booking' ), 'details' => $details, ); } /** * Resolve a verified WordPress page ID from one normalized save result. * * @param array $step_result Normalized progressive-save result. * @param string $id_prefix Expected server-owned identifier prefix. * * @return int Verified result page ID, or zero when absent. */ private function get_result_page_id( array $step_result, $id_prefix ) { $result_ids = array_merge( isset( $step_result['created_ids'] ) && is_array( $step_result['created_ids'] ) ? $step_result['created_ids'] : array(), isset( $step_result['updated_ids'] ) && is_array( $step_result['updated_ids'] ) ? $step_result['updated_ids'] : array() ); foreach ( $result_ids as $result_id ) { if ( ! is_scalar( $result_id ) || 0 !== strpos( (string) $result_id, $id_prefix ) ) { continue; } return absint( substr( (string) $result_id, strlen( $id_prefix ) ) ); } return 0; } /** * Create one label/value presentation record. * * @param mixed $label Visible detail label. * @param mixed $value Visible detail value. * * @return array{label:string,value:string} Presentation record. */ private function create_detail( $label, $value ) { return array( 'label' => is_scalar( $label ) ? (string) $label : '', 'value' => is_scalar( $value ) ? (string) $value : '', ); } /** * Create one label/value presentation record with an optional safe URL. * * The visible value remains available to the plain-text setup summary while * the Review template may render the same authorized URL as an external link. * Empty or invalid URLs intentionally fall back to ordinary text. * * @param mixed $label Visible detail label. * @param mixed $url Candidate destination URL and visible value. * * @return array{label:string,value:string,url?:string} Link presentation record. */ private function create_link_detail( $label, $url ) { $detail = $this->create_detail( $label, $url ); $normalized_url = is_scalar( $url ) ? esc_url_raw( (string) $url ) : ''; if ( '' !== $normalized_url ) { $detail['url'] = $normalized_url; } return $detail; } /** * Create a visible detail with a shorter feedback-email value. * * The Review page retains the complete value while the explicitly consented * feedback email omits long free-text descriptions. * * @param mixed $label Visible detail label. * @param mixed $value Complete visible value. * @param mixed $feedback_value Compact value used only by feedback email. * * @return array{label:string,value:string,feedback_value:string} Presentation record. */ private function create_feedback_value_detail( $label, $value, $feedback_value ) { $detail = $this->create_detail( $label, $value ); $detail['feedback_value'] = is_scalar( $feedback_value ) ? (string) $feedback_value : ''; return $detail; } /** * Create a visible detail that is intentionally omitted from feedback email. * * @param mixed $label Visible detail label. * @param mixed $value Complete visible value. * * @return array{label:string,value:string,feedback_hidden:bool} Presentation record. */ private function create_feedback_hidden_detail( $label, $value ) { $detail = $this->create_detail( $label, $value ); $detail['feedback_hidden'] = true; return $detail; } /** * Return a localized On or Off label. * * @param bool $is_enabled Whether the reviewed behavior is enabled. * * @return string Localized state label. */ private function format_toggle( $is_enabled ) { return $is_enabled ? __( 'On', 'booking' ) : __( 'Off', 'booking' ); } /** * Format one seconds-from-midnight value with the selected time format. * * @param mixed $raw_second Seconds from midnight. * @param string $time_format Validated WordPress time format. * * @return string Formatted time. */ private function format_time_second( $raw_second, $time_format ) { $second = min( DAY_IN_SECONDS, absint( $raw_second ) ); if ( DAY_IN_SECONDS === $second ) { return __( '24:00', 'booking' ); } return wp_date( $time_format, $second, new DateTimeZone( 'UTC' ) ); } /** * Format a bounded preview of one ordered `HH:MM` choice list. * * @param string[] $time_values Validated time values. * @param string $time_format Validated WordPress time format. * * @return string Localized compact list summary. */ private function format_time_choice_summary( array $time_values, $time_format ) { $visible_values = array_slice( $time_values, 0, 5 ); $labels = array(); foreach ( $visible_values as $time_value ) { if ( ! is_scalar( $time_value ) || ! preg_match( '/^(?:[01]\d|2[0-3]):[0-5]\d$/', (string) $time_value ) ) { continue; } list( $hour, $minute ) = array_map( 'intval', explode( ':', (string) $time_value ) ); $labels[] = wp_date( $time_format, ( ( $hour * 60 ) + $minute ) * MINUTE_IN_SECONDS, new DateTimeZone( 'UTC' ) ); } $hidden_count = count( $time_values ) - count( $visible_values ); if ( 0 < $hidden_count ) { /* translators: %d: Number of additional time choices omitted from the compact summary. */ $labels[] = sprintf( _n( '%d more time', '%d more times', $hidden_count, 'booking' ), $hidden_count ); } return ! empty( $labels ) ? implode( ', ', $labels ) : __( 'Not configured', 'booking' ); } /** * Format a stored weekday list through the Date Selection registry. * * @param mixed $raw_weekdays Comma-separated weekday numbers or `-1`. * * @return string Localized weekday summary. */ private function format_weekday_selection( $raw_weekdays ) { $weekday_records = ( new WPBC_Setup_Wizard_Date_Selection() )->get_weekdays(); $weekday_labels = array(); foreach ( $weekday_records as $weekday_record ) { if ( isset( $weekday_record['value'], $weekday_record['label'] ) ) { $weekday_labels[ (string) $weekday_record['value'] ] = (string) $weekday_record['label']; } } $weekday_ids = is_scalar( $raw_weekdays ) ? array_filter( array_map( 'trim', explode( ',', (string) $raw_weekdays ) ), 'strlen' ) : array(); if ( in_array( '-1', $weekday_ids, true ) || empty( $weekday_ids ) ) { return __( 'Any day', 'booking' ); } $selected_labels = array(); foreach ( $weekday_ids as $weekday_id ) { if ( isset( $weekday_labels[ $weekday_id ] ) ) { $selected_labels[] = $weekday_labels[ $weekday_id ]; } } return ! empty( $selected_labels ) ? implode( ', ', $selected_labels ) : __( 'Any day', 'booking' ); } /** * Find one complete record in a trusted presentation registry. * * @param array> $records Presentation records. * @param string $key Identity field. * @param string $expected Expected identity. * * @return array Matching record or an empty array. */ private function find_record( array $records, $key, $expected ) { foreach ( $records as $record ) { if ( is_array( $record ) && isset( $record[ $key ] ) && (string) $record[ $key ] === (string) $expected ) { return $record; } } return array(); } /** * Find an associative option label in grouped presentation records. * * @param array> $groups Group records. * @param string $expected Expected option value. * @param string $fallback_label Label used when no option matches. * * @return string Matching label or fallback. */ private function find_grouped_option_label( array $groups, $expected, $fallback_label ) { foreach ( $groups as $group ) { if ( isset( $group['options'][ $expected ] ) && is_scalar( $group['options'][ $expected ] ) ) { return sanitize_text_field( (string) $group['options'][ $expected ] ); } } return sanitize_text_field( (string) $fallback_label ); } /** * Find a label in grouped ordered presentation records. * * @param array> $groups Group records. * @param string $key Identity field. * @param string $expected Expected option value. * @param string $fallback_label Label used when no option matches. * * @return string Matching label or fallback. */ private function find_grouped_record_label( array $groups, $key, $expected, $fallback_label ) { foreach ( $groups as $group ) { $record = $this->find_record( isset( $group['options'] ) && is_array( $group['options'] ) ? $group['options'] : array(), $key, $expected ); if ( isset( $record['label'] ) ) { return sanitize_text_field( (string) $record['label'] ); } } return sanitize_text_field( (string) $fallback_label ); } /** * Find one translated label in a trusted presentation registry. * * @param array> $records Presentation records. * @param string $key Identity field. * @param string $expected Expected identity. * @param string $fallback_label Label used when no record matches. * * @return string Matching label or the fallback. */ private function find_record_label( array $records, $key, $expected, $fallback_label ) { foreach ( $records as $record ) { if ( isset( $record[ $key ], $record['label'] ) && (string) $record[ $key ] === (string) $expected ) { return sanitize_text_field( (string) $record['label'] ); } } return sanitize_text_field( (string) $fallback_label ); } /** * Read one scalar dependency value. * * @param array $consumer_context Dependency values keyed by step. * @param string $step_id Dependency step identifier. * @param string $field_id Field identifier. * * @return string Sanitized scalar value or an empty string. */ private function get_scalar_value( array $consumer_context, $step_id, $field_id ) { if ( ! isset( $consumer_context[ $step_id ][ $field_id ] ) || ! is_scalar( $consumer_context[ $step_id ][ $field_id ] ) ) { return ''; } return sanitize_text_field( (string) $consumer_context[ $step_id ][ $field_id ] ); } } ```