WooCommerce订单自定义元数据无法显示在装箱单问题求助

问题根源 #

你现有的代码完成了结账字段添加、订单元数据保存，以及感谢页、后台订单详情、邮件中的显示，但没给装箱单（尤其是PDF类装箱单插件）添加对应的显示逻辑，所以装箱单无法读取并展示这个自定义元数据。

主流插件适配方案（以WooCommerce PDF Invoices & Packing Slips为例） #

这款是目前最常用的PDF装箱单插件，添加以下代码即可让What3Words字段显示在装箱单中：

/**
 * 在PDF装箱单中添加What3Words字段
 */
add_action( 'wpo_wcpdf_after_order_data', 'wiz_add_what3words_to_packing_slip', 10, 2 );
function wiz_add_what3words_to_packing_slip( $template_type, $order ) {
    // 仅在装箱单模板中显示该字段
    if ( $template_type == 'packing-slip' ) {
        $what3words = get_post_meta( $order->get_id(), '_what3words', true );
        if ( !empty( $what3words ) ) {
            echo '<tr class="what3words">
                    <th>What3words:</th>
                    <td>' . esc_html( $what3words ) . '</td>
                  </tr>';
        }
    }
}

通用适配方案（其他装箱单工具） #

如果使用的是其他插件或自定义装箱单模板，核心逻辑分为两步：

• 查阅插件文档，找到它提供的订单信息输出钩子
• 通过get_post_meta( $order->get_id(), '_what3words', true )获取字段值，再按照模板的HTML结构输出

比如部分自定义模板可能使用woocommerce_packing_slip_order_details钩子，代码可调整为：

add_action( 'woocommerce_packing_slip_order_details', 'wiz_add_what3words_custom_packing_slip' );
function wiz_add_what3words_custom_packing_slip( $order ) {
    $what3words = get_post_meta( $order->get_id(), '_what3words', true );
    if ( !empty( $what3words ) ) {
        echo '<p><strong>What3words:</strong> ' . esc_html( $what3words ) . '</p>';
    }
}

验证步骤 #

1. 确认元数据已保存：进入后台订单详情页，开启屏幕选项里的「自定义字段」，查看_what3words是否存在且有对应值
2. 清空缓存：部分PDF插件会缓存模板，添加代码后需清空插件或WordPress缓存
3. 更新插件版本：确保使用的装箱单插件为最新版本，避免因钩子名称变更导致失效

内容的提问来源于stack exchange，提问作者Merlin