WooCommerce自定义cart_item_data不显示问题排查与解决

问题排查与解决方法 #

1. 代码层面的常见错误排查 #

• 确认$_POST['emaill']是否正确传递：
  先检查添加购物车的表单，输入字段的name属性是不是确实写的emaill（注意是两个l），别拼写错了。可以在plugin_add_cart_item_data函数里加临时调试代码，把$_POST内容写到日志里：

  function plugin_add_cart_item_data( $cart_item_data, $product_id, $variation_id ) {
    error_log( print_r( $_POST, true ) ); // 日志文件在wp-content/debug.log
    if( isset( $_POST['emaill'] ) ) {
      $cart_item_data['emaill'] = sanitize_text_field( $_POST['emaill'] );
      error_log( '成功添加emaill值：' . $cart_item_data['emaill'] );
    }
    return $cart_item_data;
  }
  

  开启WP_DEBUG后，查看日志就能知道值有没有传进来。

• 调整过滤器优先级：
  当前过滤器优先级是10，可能被其他插件或主题的同类型过滤器覆盖。试着把优先级调高，比如改成20：

  add_filter( 'woocommerce_get_item_data', 'plugin_republic_get_item_data', 20, 2 );
  

• 解决购物车重复行问题：
  你提到购物车显示同产品两行，说明每次添加都被当成了不同的购物车项。如果想让相同产品+相同emaill值的条目合并，可以在注入数据时加个唯一键：

  function plugin_add_cart_item_data( $cart_item_data, $product_id, $variation_id ) {
    if( isset( $_POST['emaill'] ) ) {
      $cart_item_data['emaill'] = sanitize_text_field( $_POST['emaill'] );
      // 添加唯一键，确保相同emaill的产品合并成一行
      $cart_item_data['unique_key'] = md5( microtime() . rand() );
    }
    return $cart_item_data;
  }
  

  这个和字段显示无关，但能解决重复行的问题。

2. Bricks主题冲突排查 #

• 切换默认主题测试：临时换成Storefront或者Twenty Twenty-One这类官方默认主题，看看自定义字段会不会显示。如果能显示，那就是Bricks主题修改了购物车的输出逻辑。
• 检查Bricks的购物车模板/模块：
  Bricks可能用了自定义的购物车模块，没有调用WooCommerce默认的wc_display_item_meta()函数（这个函数会触发woocommerce_get_item_data钩子输出附加数据）。你可以：
  • 找Bricks主题的WooCommerce模板文件（一般在bricks/woocommerce/cart/cart.php），看看有没有调用wc_display_item_meta()；
  • 如果是用Bricks可视化模块做的购物车，需要去模块设置里找是否有自定义元数据的输出选项，或者用Bricks的专属钩子手动添加字段输出。

3. 调试技巧 #

• 查看数据库存储：
  WooCommerce的购物车数据存在wp_options表中，找option_name以_woocommerce_session_开头的记录，里面是序列化后的购物车数据。可以用PHP的unserialize()函数解析，看看里面有没有emaill字段。
• 在控制台输出$cart_item_data：
  PHP变量不能直接输出到浏览器控制台，但可以在过滤器里把数据转成JSON后输出：

  function plugin_republic_get_item_data( $item_data, $cart_item_data ) {
    // 输出到浏览器控制台
    echo '<script>console.log('.json_encode($cart_item_data).');</script>';
    // 或者直接打印到页面（调试完要删掉）
    // echo '<pre>'; print_r($cart_item_data); echo '</pre>';
    if( isset( $cart_item_data['emaill'] ) ) {
      $item_data[] = array(
        'key' => __( 'Your name', 'plugin-republic' ),
        'value' => wc_clean( $cart_item_data['emaill'] )
      );
    }
    return $item_data;
  }
  

  调试完成后记得删掉这些代码，避免影响页面显示。

4. 后台订单页面显示字段的解决 #

woocommerce_get_item_data只作用于购物车页面，要让后台订单也显示这个字段，需要额外加两个钩子：

• 保存购物车数据到订单：

  function plugin_add_order_item_meta( $item_id, $cart_item_data ) {
    if( isset( $cart_item_data['emaill'] ) ) {
        wc_add_order_item_meta( $item_id, 'emaill', $cart_item_data['emaill'] );
    }
  }
  add_action( 'woocommerce_add_order_item_meta', 'plugin_add_order_item_meta', 10, 2 );
  

• 在后台订单页面显示字段：

  function plugin_display_order_item_meta( $item_id, $item, $order ) {
      $emaill = $item->get_meta('emaill');
      if( !empty($emaill) ) {
          echo '<div class="wc-item-meta"><strong>'.__( 'Your name', 'plugin-republic' ).':</strong> '.esc_html($emaill).'</div>';
      }
  }
  add_action( 'woocommerce_order_item_meta_start', 'plugin_display_order_item_meta', 10, 3 );
  

内容的提问来源于stack exchange，提问作者Jan D.M.