本文介绍如何在 WooCommerce「我的账户 > 订单」页面的订单表格中新增一列，动态显示每笔订单的总重量（含单位），基于商品权重与数量自动计算，无需手动设置元数据。
本文介绍如何在 woocommerce「我的账户 > 订单」页面的订单表格中新增一列，动态显示每笔订单的总重量（含单位），基于商品权重与数量自动计算，无需手动设置元数据。
在 WooCommerce 默认的「我的账户 > 订单」页面中，订单列表仅展示订单号、日期、状态、总额和操作按钮等基础信息，而客户常需快速了解所购商品的总重量（例如用于物流预估或环保参考）。本文提供一套轻量、可靠且兼容最新 WooCommerce 版本（8.x+）的解决方案，通过钩子机制扩展订单表格，不依赖数据库写入或自定义元字段，而是实时计算并渲染每笔订单的总毛重。
✅ 实现原理简述
核心逻辑分为两步：
- 插入新列：利用 woocommerce_my_account_my_orders_columns 过滤器，在指定位置（如“订单总额”之后）注入名为“Order Weight”的新列；
- 动态渲染数据：通过 woocommerce_my_account_my_orders_column_{column_key} 动作钩子，遍历订单内所有商品项，获取单个商品权重（$product->get_weight()）、乘以购买数量，并累加得出总重量，最后拼接系统配置的重量单位（如 kg、lbs）输出。
? 完整代码实现
将以下代码添加至您子主题的 functions.php 文件（强烈推荐使用子主题，避免更新覆盖）：
/**
* 在「我的账户 > 订单」表格中添加「订单总重量」列
* 位置：插入在 'order-total' 列之后
*/
add_filter( 'woocommerce_my_account_my_orders_columns', 'ecommercehints_weight_column_my_account_orders_table', 10, 1 );
function ecommercehints_weight_column_my_account_orders_table( $columns ) {
$new_columns = [];
foreach ( $columns as $key => $name ) {
$new_columns[ $key ] = $name;
if ( 'order-total' === $key ) {
$new_columns['order-weight'] = __( '订单总重量', 'woocommerce' ); // 中文列标题
}
}
return $new_columns;
}
/**
* 渲染每笔订单的总重量（自动计算 + 单位）
*/
add_action( 'woocommerce_my_account_my_orders_column_order-weight', 'ecommercehints_get_order_weight', 10, 1 );
function ecommercehints_get_order_weight( $order ) {
$weight_unit = get_option( 'woocommerce_weight_unit', 'kg' );
$total_weight = 0.0;
foreach ( $order->get_items() as $item ) {
$product = $item->get_product();
if ( ! $product ) continue;
$quantity = (int) $item->get_quantity();
$product_weight = floatval( $product->get_weight() );
$total_weight += $product_weight * $quantity;
}
// 格式化输出：保留小数点后两位，避免 .00 显示为整数（可选优化）
$formatted_weight = is_float( $total_weight ) && floor( $total_weight ) == $total_weight
? intval( $total_weight )
: number_format( $total_weight, 2, '.', '' );
echo esc_html( $formatted_weight . ' ' . $weight_unit );
}⚠ 注意事项与最佳实践
- 权重字段必须已设置：确保后台商品编辑页的「产品数据 > 常规 > 重量（kg/lbs）」已填写有效数值，空值或非数字将导致该项贡献为 0；
- 单位自动适配：代码自动读取 WooCommerce → 设置 → 商品 → 常规 → 计量单位中的「重量单位」，无需硬编码；
- 性能友好：仅在订单列表页触发，不增加首页或产品页负载；
- 兼容性保障：使用 $order->get_items() 和 $item->get_product() 等现代 WC API，兼容 WC 6.0+ 及 PHP 8.x；
- 安全输出：使用 esc_html() 防止 XSS，floatval() 和 number_format() 确保数值健壮性；
- 列键唯一性：示例中使用 'order-weight' 作为列键（而非原问题中的 'order-items'），避免与已有列冲突——若您已占用该键，请同步修改两处钩子中的键名。
✅ 效果验证
启用后，访问前台用户「我的账户 > 订单」页面，即可看到新增的「订单总重量」列，每行显示对应订单所有商品的加权总重（如 3.25 kg 或 7.1 lbs），清晰直观，提升用户体验与信息透明度。
