如何在 WooCommerce 我的账户订单列表中添加订单总重量列-php教程-PHP中文网

如何在 WooCommerce 我的账户订单列表中添加订单总重量列

本文介绍如何在 woocommerce「我的账户 > 订单」页面的订单表格中新增一列，动态显示每笔订单的总重量（含单位），基于商品权重与数量自动计算，无需手动设置元数据。

本文介绍如何在 woocommerce「我的账户 > 订单」页面的订单表格中新增一列，动态显示每笔订单的总重量（含单位），基于商品权重与数量自动计算，无需手动设置元数据。

在 WooCommerce 默认的「我的账户 > 订单」页面中，订单列表仅展示订单号、日期、状态、总额和操作按钮等基础信息，而客户常需快速了解所购商品的总重量（例如用于物流预估或环保参考）。本文提供一套轻量、可靠且兼容最新 WooCommerce 版本（8.x+）的解决方案，通过钩子机制扩展订单表格，不依赖数据库写入或自定义元字段，而是实时计算并渲染每笔订单的总毛重。

✅ 实现原理简述

核心逻辑分为两步：

OfoxAI

OfoxAI是一款AI大模型工具，统一大模型 API 聚合网关。

下载

插入新列：利用 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'），避免与已有列冲突——若您已占用该键，请同步修改两处钩子中的键名。