本文将指导您如何在 WooCommerce 管理订单详情页面的订单项目中显示产品元数据，并解决产品信息更新导致历史订单数据变更的问题。通过将元数据添加到订单项目，确保订单数据在产品信息变更后依然保持不变。
问题分析
原始代码直接从产品 post meta 中获取数据，导致修改产品信息时，历史订单中显示的信息也会随之改变。为了解决这个问题，我们需要在订单创建时将产品元数据保存到订单项目（order line item）中，这样即使产品信息更新，订单中的数据也不会受到影响。此外，原始代码存在尝试读取 null 属性的问题，需要进行修正。
解决方案
以下步骤展示了如何实现将产品元数据添加到订单项目，并在 WooCommerce 管理订单详情页面中显示。
1. 将产品元数据添加到订单项目
在订单创建时，使用 woocommerce_checkout_create_order_line_item 钩子将产品元数据添加到订单项目。
function action_woocommerce_checkout_create_order_line_item( $item, $cart_item_key, $values, $order ) {
// 获取 WC_Product 实例对象
$product = $item->get_product();
// 获取元数据值
$value = $product->get_meta( 'prefix-tempiconsegna' );
// 如果元数据值不为空
if ( ! empty ( $value ) ) {
$item->update_meta_data( 'prefix-tempiconsegna', $value );
}
}
add_action( 'woocommerce_checkout_create_order_line_item', 'action_woocommerce_checkout_create_order_line_item', 10, 4 );代码解释：
- woocommerce_checkout_create_order_line_item 钩子在创建订单项目时触发。
- $item 是 WC_Order_Item 对象，代表订单中的一个项目。
- $product 是 WC_Product 对象，代表订单项目对应的产品。
- $product->get_meta( 'prefix-tempiconsegna' ) 获取产品 prefix-tempiconsegna 元数据的值。
- $item->update_meta_data( 'prefix-tempiconsegna', $value ) 将元数据值添加到订单项目。
2. 在 WooCommerce 管理订单详情页面显示元数据
使用 woocommerce_admin_order_item_headers 和 woocommerce_admin_order_item_values 钩子在订单详情页面显示元数据。
// 添加表头
function action_woocommerce_admin_order_item_headers( $order ) {
// 设置列名
$column_name = __( 'Tempi Consegna', 'woocommerce' );
// 显示列名
echo '' . $column_name . ' ';
}
add_action( 'woocommerce_admin_order_item_headers', 'action_woocommerce_admin_order_item_headers', 10, 1 );
// 添加内容
function action_woocommerce_admin_order_item_values( $product, $item, $item_id ) {
// 仅针对 "line_item" 类型，避免错误
if ( ! $item->is_type('line_item') ) return;
// 获取元数据值
$value = $item->get_meta( 'prefix-tempiconsegna' );
// 如果元数据值不为空
if ( ! empty ( $value ) ) {
echo '' . $value . ' ';
} else {
echo 'Meta not found! ';
}
}
add_action( 'woocommerce_admin_order_item_values', 'action_woocommerce_admin_order_item_values', 10, 3 );代码解释：
- woocommerce_admin_order_item_headers 钩子用于添加表头。
- woocommerce_admin_order_item_values 钩子用于添加内容。
- $item->is_type('line_item') 检查当前项目是否为订单项目，避免在其他类型的项目（如运费）中出现错误。
- $item->get_meta( 'prefix-tempiconsegna' ) 获取订单项目中 prefix-tempiconsegna 元数据的值。
注意事项
- 确保将代码添加到你的主题的 functions.php 文件或自定义插件中。
- prefix-tempiconsegna 应该替换为你实际使用的元数据键名。
- 如果元数据值为空，可以根据需要显示不同的内容。
总结
通过将产品元数据添加到订单项目，可以确保历史订单数据在产品信息更新后依然保持不变。 这种方法避免了直接从产品 post meta 中获取数据导致的问题，并提供了更可靠的订单数据管理方式。 同时，修正了原始代码中可能出现的 null 属性读取错误，提高了代码的健壮性。
