array( 'label' => __( 'First name', 'woocommerce' ), 'show' => false, ), 'last_name' => array( 'label' => __( 'Last name', 'woocommerce' ), 'show' => false, ), 'company' => array( 'label' => __( 'Company', 'woocommerce' ), 'show' => false, ), 'address_1' => array( 'label' => __( 'Address line 1', 'woocommerce' ), 'show' => false, ), 'address_2' => array( 'label' => __( 'Address line 2', 'woocommerce' ), 'show' => false, ), 'city' => array( 'label' => __( 'City', 'woocommerce' ), 'show' => false, ), 'postcode' => array( 'label' => __( 'Postcode / ZIP', 'woocommerce' ), 'show' => false, ), 'country' => array( 'label' => __( 'Country / Region', 'woocommerce' ), 'show' => false, 'class' => 'js_field-country select short', 'type' => 'select', 'options' => array( '' => __( 'Select a country / region…', 'woocommerce' ) ) + WC()->countries->get_countries(), ), 'state' => array( 'label' => __( 'State / County', 'woocommerce' ), 'class' => 'js_field-state select short', 'show' => false, ), 'email' => array( 'label' => __( 'Email address', 'woocommerce' ), ), 'phone' => array( 'label' => __( 'Phone', 'woocommerce' ), ), ), $order, $context ); } /** * Get shipping fields for the meta box. * * @param \WC_Order $order Order object. * @param string $context Context of fields (view or edit). * @return array */ protected static function get_shipping_fields( $order = false, $context = 'edit' ) { /** * Provides an opportunity to modify the list of order shipping fields displayed on the admin. * * @since 1.4.0 * * @param array Shipping fields. * @param WC_Order|false $order Order object. * @param string $context Context of fields (view or edit). */ return apply_filters( 'woocommerce_admin_shipping_fields', array( 'first_name' => array( 'label' => __( 'First name', 'woocommerce' ), 'show' => false, ), 'last_name' => array( 'label' => __( 'Last name', 'woocommerce' ), 'show' => false, ), 'company' => array( 'label' => __( 'Company', 'woocommerce' ), 'show' => false, ), 'address_1' => array( 'label' => __( 'Address line 1', 'woocommerce' ), 'show' => false, ), 'address_2' => array( 'label' => __( 'Address line 2', 'woocommerce' ), 'show' => false, ), 'city' => array( 'label' => __( 'City', 'woocommerce' ), 'show' => false, ), 'postcode' => array( 'label' => __( 'Postcode / ZIP', 'woocommerce' ), 'show' => false, ), 'country' => array( 'label' => __( 'Country / Region', 'woocommerce' ), 'show' => false, 'type' => 'select', 'class' => 'js_field-country select short', 'options' => array( '' => __( 'Select a country / region…', 'woocommerce' ) ) + WC()->countries->get_countries(), ), 'state' => array( 'label' => __( 'State / County', 'woocommerce' ), 'class' => 'js_field-state select short', 'show' => false, ), 'phone' => array( 'label' => __( 'Phone', 'woocommerce' ), ), ), $order, $context ); } /** * Init billing and shipping fields we display + save. Maintained for backwards compat. */ public static function init_address_fields() { self::$billing_fields = self::get_billing_fields(); self::$shipping_fields = self::get_shipping_fields(); } /** * Whether an order has no persisted shipping method. * * A shipping line is order-time fulfillment evidence that remains stable when a * merchant later changes the ordered catalog products. Orders that retain one, * including Store API local pickup orders, must keep showing shipping details. * * @param WC_Order $order Order object. * @return bool */ private static function order_has_no_shipping( $order ) { return 0 === count( $order->get_shipping_methods() ); } /** * Whether every resolvable product line on an order is currently virtual. * * This check is used only when no persisted shipping method provides historical * fulfillment evidence. It intentionally reflects current, filterable catalog * semantics, so product edits can change the summary for no-line orders. Empty * or unresolved product sets remain visible because suppressing their persisted * shipping details would be ambiguous. * * Reading live catalog state is a deliberate, bounded departure from PR #66488's * principle that suppression should rest on order-time evidence immune to later * catalog edits. This fallback runs only for orders with no persisted shipping line * (guaranteed by order_has_no_shipping() earlier in the gate's && chain), which is * exactly the population that carries no such order-time evidence, so the catalog * read is the only available signal and can never override a persisted shipping line. * The accepted tradeoff: reclassifying a product as virtual can later re-hide a * no-line order that genuinely shipped. That recurrence is display-only, admin-only, * filterable, and pinned as intended by * test_hides_shipping_details_after_physical_product_without_shipping_line_becomes_virtual(). * * The aggregation and fallback here are deliberately local rather than reusing * WC_Order::needs_shipping() or the shipping-label helpers: needs_shipping() * short-circuits on the global shipping setting and, like those helpers, does not * default unresolved or product-less orders to the conservative "keep visible" * outcome this summary requires. * * @param WC_Order $order Order object. * @return bool */ private static function order_has_only_virtual_products( $order ) { $items = $order->get_items(); if ( empty( $items ) ) { return false; } foreach ( $items as $item ) { if ( ! $item instanceof WC_Order_Item_Product ) { return false; } $product = $item->get_product(); if ( ! $product instanceof WC_Product || $product->needs_shipping() ) { return false; } } return true; } /** * Whether an order's shipping address is still the billing-derived copy. * * Store API checkout copies the billing address into the shipping address for * backwards compatibility when a purchase needs no fulfillment. There is no persisted * marker for that copy, so the shipping address is treated as billing-derived only * while every copied field still matches billing. Once a merchant or integration edits * the shipping fields to diverge, the values are explicit and must be shown. * Individual getters use the edit context instead of get_address() so view filters * cannot make distinct persisted values appear equal. * * @param WC_Order $order Order object. * @return bool */ private static function order_shipping_matches_billing( $order ) { $copied_fields = array( 'first_name', 'last_name', 'company', 'address_1', 'address_2', 'city', 'state', 'postcode', 'country', 'phone' ); foreach ( $copied_fields as $field ) { if ( $order->{"get_shipping_$field"}( 'edit' ) !== $order->{"get_billing_$field"}( 'edit' ) ) { return false; } } return true; } /** * Output the metabox. * * @param WP_Post|WC_Order $post Post or order object. */ public static function output( $post ) { global $theorder; OrderUtil::init_theorder_object( $post ); $order = $theorder; if ( WC()->payment_gateways() ) { $payment_gateways = WC()->payment_gateways->payment_gateways(); } else { $payment_gateways = array(); } $payment_method = $order->get_payment_method(); $order_type_object = get_post_type_object( $order->get_type() ); wp_nonce_field( 'woocommerce_save_data', 'woocommerce_meta_nonce' ); ?>

labels->singular_name ), esc_html( $order->get_order_number() ) ); ?>

get_title() : $payment_method ) ); $transaction_id = $order->get_transaction_id(); if ( $transaction_id ) { $to_add = null; if ( isset( $payment_gateways[ $payment_method ] ) ) { $url = $payment_gateways[ $payment_method ]->get_transaction_url( $order ); if ( $url ) { $to_add .= ' (' . esc_html( $transaction_id ) . ')'; } } $to_add = $to_add ?? ' (' . esc_html( $transaction_id ) . ')'; $payment_method_string .= $to_add; } $meta_list[] = $payment_method_string; } if ( $order->get_date_paid() ) { $meta_list[] = sprintf( /* translators: 1: date 2: time */ __( 'Paid on %1$s at %2$s', 'woocommerce' ), wc_format_datetime( $order->get_date_paid() ), wc_format_datetime( $order->get_date_paid(), get_option( 'time_format' ) ) ); } $ip_address = $order->get_customer_ip_address(); if ( $ip_address ) { $meta_list[] = sprintf( /* translators: %s: IP address */ __( 'Customer IP: %s', 'woocommerce' ), '' . esc_html( $ip_address ) . '' ); } echo wp_kses_post( implode( '. ', $meta_list ) ); ?>

get_date_created() ) ? $order->get_date_created()->getOffsetTimestamp() : ''; ?> ‎ :

get_user_id() ) { $user_id = absint( $order->get_user_id() ); $user = Users::get_user_in_current_site( $user_id ); if ( ! is_wp_error( $user ) ) { $customer = new WC_Customer( $user_id ); /* translators: 1: user display name 2: user ID 3: user email */ $found_users = array( $user_id => sprintf( /* translators: 1: customer name, 2 customer id, 3: customer email */ esc_html__( '%1$s (#%2$s – %3$s)', 'woocommerce' ), $customer->get_first_name() . ' ' . $customer->get_last_name(), $customer->get_id(), $customer->get_email() ), ); } else { // print customer not available in the current site. $found_users = array( $user_id => esc_html__( '(Not available)', 'woocommerce' ) ); } } ?>

get_user_id() ); $details_not_available_message = __( 'Details are not available for this customer as this user does not exist in the current site.', 'woocommerce' ); // If the user is not a guest and is not a valid user in the current site, print details not available. if ( $order->get_user_id() !== 0 && is_wp_error( $user ) ) { echo '

' . esc_html( $details_not_available_message ) . '

'; } else { if ( $order->get_formatted_billing_address() ) { echo '

' . wp_kses( $order->get_formatted_billing_address(), array( 'br' => array() ) ) . '

'; } else { echo '

' . esc_html__( 'No billing address set.', 'woocommerce' ) . '

'; } $billing_fields = self::get_billing_fields( $order, 'view' ); foreach ( $billing_fields as $key => $field ) { if ( isset( $field['show'] ) && false === $field['show'] ) { continue; } $field_name = 'billing_' . $key; if ( isset( $field['value'] ) ) { $field_value = $field['value']; } elseif ( is_callable( array( $order, 'get_' . $field_name ) ) ) { $field_value = $order->{"get_$field_name"}( 'edit' ); } else { $field_value = $order->get_meta( '_' . $field_name ); } if ( 'billing_phone' === $field_name ) { $field_value = wc_make_phone_clickable( $field_value ); } elseif ( 'billing_email' === $field_name ) { $normalized_email = is_string( $field_value ) ? trim( $field_value ) : ''; $field_value = '' === $normalized_email ? '' . esc_html__( 'No email address set.', 'woocommerce' ) . '' : '' . esc_html( $normalized_email ) . ''; } else { $field_value = make_clickable( esc_html( $field_value ) ); } if ( $field_value || '0' === $field_value ) { echo '

' . esc_html( $field['label'] ) . ': ' . wp_kses_post( $field_value ) . '

'; } } } ?>
$field ) { if ( ! isset( $field['type'] ) ) { $field['type'] = 'text'; } if ( ! isset( $field['id'] ) ) { $field['id'] = '_billing_' . $key; } $field_name = 'billing_' . $key; // Check if the user is a valid user in the current site. // If not, set the value to an empty string. // This is to prevent the user from being able to view the billing address of a user that does not exist. // If the user is not a guest and is not a valid user in the current site, print details not available. if ( $order->get_user_id() !== 0 && is_wp_error( $user ) ) { $field['value'] = ''; } elseif ( ! isset( $field['value'] ) ) { if ( is_callable( array( $order, 'get_' . $field_name ) ) ) { $field['value'] = $order->{"get_$field_name"}( 'edit' ); } else { $field['value'] = $order->get_meta( '_' . $field_name ); } } switch ( $field['type'] ) { case 'select': woocommerce_wp_select( $field, $order ); break; case 'checkbox': woocommerce_wp_checkbox( $field, $order ); break; default: woocommerce_wp_text_input( $field, $order ); break; } } ?>

'_transaction_id', 'label' => __( 'Transaction ID', 'woocommerce' ), 'value' => $order->get_transaction_id( 'edit' ), ), $order ); ?>

get_user_id() !== 0 && is_wp_error( $user ) ) { echo '

' . esc_html( $details_not_available_message ) . '

'; } else { $hide_core_shipping_details = 'store-api' === $order->get_created_via() && self::order_has_no_shipping( $order ) && self::order_has_only_virtual_products( $order ) && self::order_shipping_matches_billing( $order ); /** * Filters whether billing-derived shipping details are hidden in the order admin summary. * * @param bool $hide_core_shipping_details Whether core shipping details are hidden. * @param WC_Order $order Order object. * * @since 11.1.0 */ $hide_core_shipping_details = apply_filters( 'woocommerce_hide_order_admin_shipping_details', $hide_core_shipping_details, $order ); $shipping_address = $hide_core_shipping_details ? '' : $order->get_formatted_shipping_address(); if ( $shipping_address ) { echo '

' . wp_kses( $shipping_address, array( 'br' => array() ) ) . '

'; } else { echo '

' . esc_html__( 'No shipping address set.', 'woocommerce' ) . '

'; } $shipping_fields = self::get_shipping_fields( $order, 'view' ); if ( ! empty( $shipping_fields ) ) { foreach ( $shipping_fields as $key => $field ) { if ( $hide_core_shipping_details && 'phone' === $key && ! isset( $field['value'] ) ) { continue; } if ( isset( $field['show'] ) && false === $field['show'] ) { continue; } $field_name = 'shipping_' . $key; if ( isset( $field['value'] ) ) { $field_value = $field['value']; } elseif ( is_callable( array( $order, 'get_' . $field_name ) ) ) { $field_value = $order->{"get_$field_name"}( 'edit' ); } else { $field_value = $order->get_meta( '_' . $field_name ); } if ( 'shipping_phone' === $field_name ) { $field_value = wc_make_phone_clickable( $field_value ); } if ( $field_value || '0' === $field_value ) { echo '

' . esc_html( $field['label'] ) . ': ' . wp_kses_post( $field_value ) . '

'; } } } if ( apply_filters( 'woocommerce_enable_order_notes_field', 'yes' === get_option( 'woocommerce_enable_order_comments', 'yes' ) ) && $order->get_customer_note() ) { // phpcs:ignore WooCommerce.Commenting.CommentHooks.MissingHookComment echo '

' . esc_html( __( 'Customer provided note:', 'woocommerce' ) ) . ' ' . wp_kses( nl2br( esc_html( wc_wptexturize_order_note( $order->get_customer_note() ) ) ), array( 'br' => array() ) ) . '

'; } } ?>
$field ) { if ( ! isset( $field['type'] ) ) { $field['type'] = 'text'; } if ( ! isset( $field['id'] ) ) { $field['id'] = '_shipping_' . $key; } $field_name = 'shipping_' . $key; // Check if the user is a valid user in the current site. // If not, set the value to an empty string. // This is to prevent the user from being able to view the shipping address of a user that does not exist. // If the user is not a guest and is not a valid user in the current site, print details not available. if ( $order->get_user_id() !== 0 && is_wp_error( $user ) ) { $field['value'] = ''; } elseif ( ! isset( $field['value'] ) ) { if ( is_callable( array( $order, 'get_' . $field_name ) ) ) { $field['value'] = $order->{"get_$field_name"}( 'edit' ); } else { $field['value'] = $order->get_meta( '_' . $field_name ); } } switch ( $field['type'] ) { case 'select': woocommerce_wp_select( $field, $order ); break; case 'checkbox': woocommerce_wp_checkbox( $field, $order ); break; default: woocommerce_wp_text_input( $field, $order ); break; } } } /** * Allows 3rd parties to alter whether the customer note should be displayed on the admin. * * @since 2.1.0 * * @param bool TRUE if the note should be displayed. FALSE otherwise. */ if ( apply_filters( 'woocommerce_enable_order_notes_field', 'yes' === get_option( 'woocommerce_enable_order_comments', 'yes' ) ) ) : ?>

payment_gateways(); WC()->shipping(); // Get order object. $order = wc_get_order( $order_id ); $props = array(); // Create order key. if ( ! $order->get_order_key() ) { $props['order_key'] = wc_generate_order_key(); } // Update customer. $customer_id = isset( $_POST['customer_user'] ) ? absint( $_POST['customer_user'] ) : 0; $selected_customer = Users::get_user_in_current_site( $customer_id ); // Only update the customer ID if it's a guest (0) or if it's a different customer that exists in the current site. // If the customer doesn't exist in the current site (is_wp_error), we won't update the customer ID. $is_valid_guest_or_new_customer = $customer_id !== $order->get_customer_id() && ( 0 === $customer_id || ! is_wp_error( $selected_customer ) ); if ( $is_valid_guest_or_new_customer ) { $props['customer_id'] = $customer_id; } // Update billing fields. $billing_fields = self::get_billing_fields( $order, 'edit' ); // Only update billing fields if the order is for a valid user in the current site. // This is to prevent the user from being able to update the billing address of a user that does not exist in the current site. $save_metadata_for_guest_user_or_a_valid_user = 0 === $customer_id || ! is_wp_error( $selected_customer ); if ( ! empty( $billing_fields ) && $save_metadata_for_guest_user_or_a_valid_user ) { foreach ( $billing_fields as $key => $field ) { if ( ! isset( $field['id'] ) ) { $field['id'] = '_billing_' . $key; } if ( ! isset( $_POST[ $field['id'] ] ) ) { continue; } $value = wc_clean( wp_unslash( $_POST[ $field['id'] ] ) ); // Update a field if it includes an update callback. if ( isset( $field['update_callback'] ) ) { call_user_func( $field['update_callback'], $field['id'], $value, $order ); } elseif ( is_callable( array( $order, 'set_billing_' . $key ) ) ) { $props[ 'billing_' . $key ] = $value; } else { $order->update_meta_data( $field['id'], $value ); } } } // Update shipping fields. $shipping_fields = self::get_shipping_fields( $order, 'edit' ); // Only update shipping fields if the order is for a valid user in the current site. // This is to prevent the user from being able to update the shipping address of a user that does not exist in the current site. if ( ! empty( $shipping_fields ) && $save_metadata_for_guest_user_or_a_valid_user ) { foreach ( $shipping_fields as $key => $field ) { if ( ! isset( $field['id'] ) ) { $field['id'] = '_shipping_' . $key; } if ( ! isset( $_POST[ $field['id'] ] ) ) { continue; } $value = isset( $_POST[ $field['id'] ] ) ? wc_clean( wp_unslash( $_POST[ $field['id'] ] ) ) : ''; // Update a field if it includes an update callback. if ( isset( $field['update_callback'] ) ) { call_user_func( $field['update_callback'], $field['id'], $value, $order ); } elseif ( is_callable( array( $order, 'set_shipping_' . $key ) ) ) { $props[ 'shipping_' . $key ] = $value; } else { $order->update_meta_data( $field['id'], $value ); } } } if ( isset( $_POST['_transaction_id'] ) ) { $props['transaction_id'] = wc_clean( wp_unslash( $_POST['_transaction_id'] ) ); } // Payment method handling. if ( $order->get_payment_method() !== wc_clean( wp_unslash( $_POST['_payment_method'] ) ) ) { $methods = WC()->payment_gateways->payment_gateways(); $payment_method = wc_clean( wp_unslash( $_POST['_payment_method'] ) ); $payment_method_title = $payment_method; if ( isset( $methods ) && isset( $methods[ $payment_method ] ) ) { $payment_method_title = $methods[ $payment_method ]->get_title(); } if ( 'other' === $payment_method ) { $payment_method_title = esc_html__( 'Other', 'woocommerce' ); } $props['payment_method'] = $payment_method; $props['payment_method_title'] = $payment_method_title; } // Update date. if ( empty( $_POST['order_date'] ) ) { $date = time(); } else { if ( ! isset( $_POST['order_date_hour'] ) || ! isset( $_POST['order_date_minute'] ) || ! isset( $_POST['order_date_second'] ) ) { throw new Exception( __( 'Order date, hour, minute and/or second are missing.', 'woocommerce' ), 400 ); } // phpcs:ignore WordPress.Security.ValidatedSanitizedInput $date = gmdate( 'Y-m-d H:i:s', strtotime( $_POST['order_date'] . ' ' . (int) $_POST['order_date_hour'] . ':' . (int) $_POST['order_date_minute'] . ':' . (int) $_POST['order_date_second'] ) ); } $props['date_created'] = $date; // Set created via prop if new post. if ( isset( $_POST['original_post_status'] ) && OrderStatus::AUTO_DRAFT === $_POST['original_post_status'] ) { $props['created_via'] = 'admin'; } // Customer note. if ( isset( $_POST['customer_note'] ) ) { $props['customer_note'] = sanitize_textarea_field( wp_unslash( $_POST['customer_note'] ) ); } // Save order data. $order->set_props( $props ); $order->set_status( wc_clean( wp_unslash( $_POST['order_status'] ) ), '', true ); $order->save(); // phpcs:enable WordPress.Security.NonceVerification.Missing } }