如何实现WooCommerce商品仅能加入购物车一次并隐藏对应按钮

没问题，我来帮你一步步实现这个需求。你提到的woocommerce_add_to_cart_validation钩子确实是核心环节，但我们还需要配合其他钩子完成加购验证、隐藏已加购商品的按钮、限制购物车数量修改这三个核心功能。下面是完整的代码实现和说明：

1. 阻止重复加购（核心验证） #

使用woocommerce_add_to_cart_validation钩子，在用户点击「加入购物车」时先检查该商品是否已经在购物车中，如果存在则阻止加购并给出提示：

add_filter( 'woocommerce_add_to_cart_validation', 'restrict_single_item_add_to_cart', 10, 3 );
function restrict_single_item_add_to_cart( $passed, $product_id, $quantity ) {
    // 遍历购物车中的所有商品
    foreach( WC()->cart->get_cart() as $cart_item_key => $cart_item ) {
        // 匹配当前要加购的商品ID（包含变体商品的ID）
        if ( $cart_item['product_id'] === $product_id || $cart_item['variation_id'] === $product_id ) {
            wc_add_notice( __( '这个商品已经在您的购物车里了，每个商品只能购买一件。', 'woocommerce' ), 'error' );
            $passed = false; // 阻止加购
            break;
        }
    }
    return $passed;
}

2. 隐藏已加购商品的「加入购物车」按钮 #

我们需要分别处理商品列表页（循环页）和单个商品详情页的按钮显示逻辑：

处理商品列表页的按钮 #

使用woocommerce_loop_add_to_cart_link过滤器，将已在购物车中的商品按钮替换为提示文字：

add_filter( 'woocommerce_loop_add_to_cart_link', 'hide_add_to_cart_for_in_cart_products', 10, 2 );
function hide_add_to_cart_for_in_cart_products( $button, $product ) {
    foreach( WC()->cart->get_cart() as $cart_item ) {
        if ( $cart_item['product_id'] === $product->get_id() || $cart_item['variation_id'] === $product->get_id() ) {
            // 替换按钮为提示，你也可以直接返回空字符串完全隐藏
            $button = '<span class="in-cart-notice" style="color: #666; padding: 8px 16px; border: 1px solid #ddd; border-radius: 4px;">该商品已在购物车中</span>';
            break;
        }
    }
    return $button;
}

处理单个商品详情页的按钮 #

通过移除默认的加购按钮钩子，替换为提示文字：

add_action( 'woocommerce_single_product_summary', 'replace_single_add_to_cart_button', 1 );
function replace_single_add_to_cart_button() {
    global $product;
    // 检查当前商品是否在购物车中
    foreach( WC()->cart->get_cart() as $cart_item ) {
        if ( $cart_item['product_id'] === $product->get_id() || $cart_item['variation_id'] === $product->get_id() ) {
            // 移除默认的加购按钮
            remove_action( 'woocommerce_single_product_summary', 'woocommerce_template_single_add_to_cart', 30 );
            // 添加自定义提示
            add_action( 'woocommerce_single_product_summary', 'in_cart_single_notice', 30 );
            break;
        }
    }
}

// 定义详情页的提示内容
function in_cart_single_notice() {
    echo '<p class="in-cart-notice" style="font-size: 16px; color: #555; padding: 10px; background: #f5f5f5; border-radius: 4px;">该商品已在您的购物车中，每个商品只能购买一件。</p>';
}

3. 限制购物车中商品数量不能超过1 #

防止用户在购物车页面手动修改商品数量大于1，使用woocommerce_cart_item_quantity_validation钩子：

add_filter( 'woocommerce_cart_item_quantity_validation', 'restrict_cart_item_quantity', 10, 4 );
function restrict_cart_item_quantity( $passed, $quantity, $cart_item_key, $cart_item ) {
    if ( $quantity > 1 ) {
        wc_add_notice( __( '每个商品最多只能购买一件。', 'woocommerce' ), 'error' );
        $passed = false;
    }
    return $passed;
}

代码使用说明 #

将上述所有代码添加到你的WordPress主题的functions.php文件中，或者创建一个自定义插件来存放这些代码（推荐后者，避免主题更新丢失代码）。

额外说明 #

• 上述代码支持简单商品和变体商品：如果是变体商品，每个不同的变体视为独立商品，各自只能加购一次；
• 你可以根据自己的需求修改提示文字的样式和内容；
• 如果需要针对特定商品分类或标签生效，可以在代码中添加额外的判断条件（比如if ( has_term( 'your-category', 'product_cat', $product_id ) )）。

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