添加WooCommerce购物车计数器至页头时钩子使用错误求助

问题根源 #

你当前的代码问题出在两个地方：

• 条件判断没有排除结账页面，导致在结账流程中也触发了cart对象的调用，干扰了支付环节的状态初始化，进而导致支付选项置灰。
• after_body_open_tag不属于WooCommerce专属钩子，在结账这类特殊页面触发时，可能和WC的内部流程冲突。

正确的实现方式 #

方案1：用WooCommerce页头专属钩子插入

如果要在页头区域插入隐藏的购物车计数，推荐使用woocommerce_before_header钩子，同时修正条件判断，明确排除结账页和后台：

function d_cart_counter() {
    // 排除结账页、后台，只在产品页、商店页、单页/文章页显示
    if ( !is_admin() && !is_checkout() && (is_single() || is_page() || is_product() || is_shop()) ) {
        $cartcount = WC()->cart->get_cart_contents_count();
        echo '<span id="d-cart-count" style="display:none;">'.$cartcount.'</span>';
    }
}
add_action('woocommerce_before_header', 'd_cart_counter', 99 );

方案2：用wp_footer钩子插入（更安全）

如果只是需要一个隐藏的计数元素供jQuery读取，放在页脚完全可以，不会干扰任何页面的初始化流程：

function d_cart_counter() {
    if ( !is_admin() && !is_checkout() ) {
        $cartcount = WC()->cart->get_cart_contents_count();
        echo '<span id="d-cart-count" style="display:none;">'.$cartcount.'</span>';
    }
}
add_action('wp_footer', 'd_cart_counter', 99 );

关键说明 #

• 用WC()函数代替全局$woocommerce，这是WooCommerce推荐的调用方式，避免全局变量的冲突问题。
• 必须排除is_checkout()页面，结账流程中WC的cart对象处于锁定或特殊状态，此时调用cart相关方法会破坏支付流程。

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