WooCommerce：将自定义 Metabox 添加到管理订单页面

我目前已成功向我的 WooCommerce 产品页面添加一个字段，该字段显示值：

• 在购物车（前端）中，
• 在结账页面（前端），
• 在订单页面（前端），
• 并在管理个人订单页面（后端）中。

问题：它没有在管理订单“自定义字段”Metabox 中显示为自定义字段及其内部值，而只是在订单页面中显示为文本。

这是我的工作代码：

// Add the field to the product
add_action('woocommerce_before_add_to_cart_button', 'my_custom_checkout_field');

function my_custom_checkout_field() {
    echo '<div id="my_custom_checkout_field"><h3>'.__('My Field').'</h3>';
    echo  '<label>fill in this field</label> <input type="text" name="my_field_name">';
    echo '</div>';
}

// Store custom field
function save_my_custom_checkout_field( $cart_item_data, $product_id ) {
    if( isset( $_REQUEST['my_field_name'] ) ) {
        $cart_item_data[ 'my_field_name' ] = $_REQUEST['my_field_name'];
        /* below statement make sure every add to cart action as unique line item */
        $cart_item_data['unique_key'] = md5( microtime().rand() );
    }
    return $cart_item_data;
}
add_action( 'woocommerce_add_cart_item_data', 'save_my_custom_checkout_field', 10, 2 );

// Render meta on cart and checkout
function render_meta_on_cart_and_checkout( $cart_data, $cart_item = null ) {
    $custom_items = array();
    /* Woo 2.4.2 updates */
    if( !empty( $cart_data ) ) {
        $custom_items = $cart_data;
    }
    if( isset( $cart_item['my_field_name'] ) ) {
        $custom_items[] = array( "name" => 'My Field', "value" => $cart_item['my_field_name'] );
    }
    return $custom_items;
}
add_filter( 'woocommerce_get_item_data', 'render_meta_on_cart_and_checkout', 10, 2 );

// This is what I think needs changing?

function subscription_order_meta_handler( $item_id, $values, $cart_item_key ) {
    if( isset( $values['my_field_name'] ) ) {
        wc_add_order_item_meta( $item_id, "My Field", $values['my_field_name'] );
    }
}
add_action( 'woocommerce_add_order_item_meta', 'subscription_order_meta_handler', 1, 3 );

我认为需要更改的是最后一段代码。它当前显示订单项下的文本，所以也许我需要调整wc_add_order_item_meta到别的东西？

我已经尝试了一切，但似乎不起作用。当我的字段位于结帐页面上时，我可以让它工作，但当我从产品页面上拉出它时，它就不行了。

也许我缺少结账流程片段？

2023 年更新 （在 Woocommerce 3+ 中仍然有效）

首先，我已经让一切按预期进行，除了获取值 for my_field_slug在订单页面后端“自定义字段”Metabox 中。

然后在经历了一场真正的噩梦之后，我找到了一个非常好的工作解决方案， 比以前好。在后端，您现在有一个带有自定义字段的自定义元框my_field_slug显示正确的值，如以下屏幕截图所示：

我的代码分为两部分。

1. The 订单页面中的后端 Metabox，其中一个可编辑字段显示来自产品页面（前端）上的自定义字段的正确值：

// Adding Meta container admin shop_order pages
add_action( 'add_meta_boxes', 'add_shop_order_meta_boxes' );
if ( ! function_exists( 'add_shop_order_meta_boxes' ) )
{
    function add_shop_order_meta_boxes()
    {
        add_meta_box( 'custom_other_field', __('My Field','woocommerce'), 'add_custom_other_field_content', 'shop_order', 'side', 'core' );
    }
}

// Adding Meta field in the meta container on admin shop_order pages
if ( ! function_exists( 'add_custom_other_field_content' ) )
{
    function add_custom_other_field_content( $post )
    {
        $order = wc_get_order($post->ID); // Get the WC_Order object

        printf('<p style="border-bottom:solid 1px #eee;padding-bottom:13px;">
            <input type="hidden" name="custom_other_field_nonce" value="%s">
            <input type="text" style="width:250px;" name="my_field_slug" placeholder="%s" value="%s">
            </p>',
            wp_create_nonce(),
            __('some placeholder text', 'woocommerce'),
            $order->get_meta('_my_field_slug')
        );

    }
}
// Save the Meta field value
add_action( 'woocommerce_process_shop_order_meta', 'save_custom_metabox_field_value', 10, 2 );
if ( ! function_exists( 'save_custom_metabox_field_value' ) )
{
    function save_custom_metabox_field_value( $order_id, $post) {
        // Check if our nonce is set.
        if ( ! isset($_REQUEST['custom_other_field_nonce']) && ! wp_verify_nonce($_REQUEST['custom_other_field_nonce']) ) {
            return $order_id;
        }

        $order = wc_get_order($order_id); // Get the WC_Order object

        // Sanitize text input value and update the meta field in the database.
        $order->update_meta_data('_my_field_slug', sanitize_text_field($_POST['my_field_slug']));
        $order->save();
    }
}

2. 前端/后端：

Note:我们只允许购物车中包含一件商品，因为产品字段值填充订单 Metabox 字段。

• 产品页面自定义字段（前端）。
• 在购物车、结帐和订单（前端）上显示此数据。电子邮件通知也是如此。
• 在订单页面（后端）显示数据

// Display a text field on single product pages
add_action('woocommerce_before_add_to_cart_button', 'display_custom_field_on_single_product');
function display_custom_field_on_single_product() {
    echo '<div id="my_custom_field">
        <label>' . __( 'My Field') . ' </label>
        <input type="text" name="my_field_slug" value="">
    </div><br>';
}

// Allow only one item in cart
add_filter( 'woocommerce_add_to_cart_validation', 'allow_only_one_cart_item', 10, 3 );
function allow_only_one_cart_item( $passed, $product_id, $quantity ) {
    if( ! WC()->cart->is_empty() ) {
        WC()->cart->empty_cart();
    }
    return $passed;
}

// Store custom field value
add_filter( 'woocommerce_add_cart_item_data', 'add_custom_field_as_custom_cart_item_data', 10, 2 );
function add_custom_field_as_custom_cart_item_data( $cart_item_data, $product_id ) {
    if( isset( $_REQUEST['my_field_slug'] ) ) {
        $cart_item_data[ 'my_field_slug' ] = sanitize_text_field($_REQUEST['my_field_slug']);
        // below statement make sure every add to cart action as unique line item
        $cart_item_data['unique_key'] = md5( microtime().rand() );
    }
    return $cart_item_data;
}

// Render the field value on cart and checkout
add_filter( 'woocommerce_get_item_data', 'render_meta_on_cart_and_checkout', 10, 2 );
function render_meta_on_cart_and_checkout( $cart_data, $cart_item = null ) {
    $custom_items = array();

    if( !empty( $cart_data ) ) {
        $custom_items = $cart_data;
    }

    if( isset( $cart_item['my_field_slug'] ) ) {
        $custom_items[] = array( 
            'name'  => __('My Field'), 
            'value' => $cart_item['my_field_slug'] 
        );
    }
    return $custom_items;
}

// Save the the custom field value as order custom meta
add_action( 'woocommerce_checkout_create_order', 'save_custom_field_as_order_meta', 10, 2 );
function save_custom_field_as_order_meta( $order, $data ) {
    $items = WC()->cart->get_cart();
    $item  = reset($items);

    if ( isset($item['my_field_slug']) ) {
        $order->update_meta_data( '_my_field_slug', $item['my_field_slug'] );
    }
}

// Save the the custom field value as order item custom meta
add_action( 'woocommerce_checkout_create_order_line_item', 'save_custom_field_as_order_item_meta', 10, 4 );
function save_custom_field_as_order_item_meta( $item, $cart_item_key, $values, $order ) {
    if ( isset($values['my_field_slug']) ) {
        $item->update_meta_data( 'my_field_slug', $values['my_field_slug'] );
    }
}

 // Add readable "meta key" label name replacement
 add_filter('woocommerce_order_item_display_meta_key', 'filter_wc_order_item_display_meta_key', 10, 3 );
 function filter_wc_order_item_display_meta_key( $display_key, $meta, $item ) {
     if( $display_key === 'my_field_slug' ) {
         $display_key = __('My field', 'woocommerce');
     }
     return $display_key;
 }

现在一切都按预期进行。