本文教你如何将两种 woocommerce 按钮文本定制逻辑（指定商品固定显示“去结算”，其余商品根据是否已在购物车中动态切换“加入购物车”/“✓ 已选中”）安全合并为一个健壮的过滤器函数，避免冲突与白屏。
在 WooCommerce 主题或子主题的 functions.php 文件中，直接叠加多个 woocommerce_product_single_add_to_cart_text 过滤器会导致逻辑覆盖或执行顺序不可控，进而引发 PHP 错误甚至网站白屏。正确的做法是将所有业务逻辑整合进单一过滤器函数中，并辅以清晰、可复用的工具函数进行状态判断。
以下是经过优化、生产环境验证的完整解决方案：
// 工具函数：判断指定商品 ID 是否已在购物车中
function is_product_in_cart( $product_id ) {
if ( ! WC()->cart || ! is_numeric( $product_id ) ) {
return false;
}
foreach ( WC()->cart->get_cart() as $cart_item ) {
// 同时检查 product_id 和 variation_id（兼容变体商品）
if ( $cart_item['product_id'] == $product_id ||
( ! empty( $cart_item['variation_id'] ) && $cart_item['variation_id'] == $product_id ) ) {
return true;
}
}
return false;
}
// 主过滤器：统一控制单产品页“加入购物车”按钮文本
add_filter( 'woocommerce_product_single_add_to_cart_text', 'woo_custom_cart_button_text' );
function woo_custom_cart_button_text() {
$current_product_id = get_the_ID();
// ✅ 步骤1：定义需特殊处理的商品 ID 列表（请按需修改）
$special_products = array( 82, 74 ); // 示例：商品 ID 82 和 74 显示“去结算”
// ✅ 步骤2：优先判断是否为特殊商品
if ( in_array( $current_product_id, $special_products ) ) {
// 特殊商品：始终显示“去结算”，无论是否已在购物车中
return __( 'go to checkout', 'woocommerce' );
}
// ✅ 步骤3：普通商品 —— 根据是否在购物车中动态切换文本
if ( is_product_in_cart( $current_product_id ) ) {
return __( '✓ already selected', 'woocommerce' );
}
// 默认状态：普通商品且未在购物车中
return __( 'Add to Cart', 'woocommerce' );
}
? 关键优化说明：
- 使用 WC()->cart 替代已弃用的 $woocommerce->cart（兼容 WooCommerce 3.0+）；
- is_product_in_cart() 函数增强鲁棒性：增加空值校验，并支持变体商品（通过 variation_id 匹配）；
- 逻辑分层清晰：先识别特殊商品（高优级），再处理通用逻辑，避免条件嵌套混乱；
- 所有字符串均通过 __() 翻译函数包裹，确保多语言兼容性。
⚠️ 注意事项：
- 请将 $special_products 数组中的数字替换为你实际要设置为“去结算”的商品 ID；
- 若使用了缓存插件（如 WP Super Cache、LiteSpeed Cache），修改后请清空对象缓存与页面缓存；
- 建议在子主题中添加该代码，避免主题更新时丢失；
- 如遇 PHP 报错，请启用 WP_DEBUG 查看具体错误行，并确认 WooCommerce 已激活且版本 ≥ 3.0。
通过以上结构化实现，你既能保留原有功能，又能无缝扩展新需求，同时大幅提升代码可维护性与稳定性。