使用woocommerce_hidden_order_itemmeta钩子时，如何访问订单项？

核心问题解答 #

• 可以直接访问订单项：这个钩子本身会传递当前订单项对象，无需依赖全局变量。钩子的完整参数如下：
  1. $hidden_meta：当前标记为隐藏的元键数组（可修改后返回）
  2. $item：当前的WC_Order_Item对象（直接用于获取订单项的所有数据）
  3. $order：当前的WC_Order对象（可选，用于获取订单级别的关联数据）

条件隐藏元字段的代码示例 #

以下是根据订单项元字段、关联产品属性实现条件隐藏的具体代码：

add_filter( 'woocommerce_hidden_order_itemmeta', 'conditional_hide_order_item_meta', 10, 3 );
function conditional_hide_order_item_meta( $hidden_meta, $item, $order ) {
    // 获取订单项关联的产品（仅针对产品类型的订单项有效）
    $product = $item->get_product();
    
    // 示例1：根据订单项自定义元字段值隐藏目标元键
    $custom_meta_val = $item->get_meta( '_custom_check_meta' );
    if ( $custom_meta_val === 'need_hide' ) {
        $hidden_meta[] = '_target_meta_key';
    }
    
    // 示例2：根据产品属性隐藏目标元键
    if ( $product && $product->get_attribute( 'pa_size' ) === 'xl' ) {
        $hidden_meta[] = '_size_related_meta';
    }
    
    return $hidden_meta;
}

方案合理性说明 #

你选择这个钩子处理订单项级的元字段隐藏是完全正确的——它是WooCommerce官方提供的标准钩子，专门用于控制订单项元字段的显示/隐藏，无需修改模板文件，符合插件扩展的最佳实践。如果你的需求仅为隐藏特定元字段，这就是最优方案；若需要更复杂的显示定制（比如修改元字段输出内容而非单纯隐藏），再考虑修改模板或使用前端渲染类钩子。

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