如何修复WooCommerce过滤器与自定义代码的兼容性问题

1. 主题中阻碍自定义函数执行的代码部分 #

以下主题代码是导致自定义方案失效的核心原因：

• 全局禁用购买功能的过滤器：

  add_filter('woocommerce_is_purchasable', 'tema_woocommerce_is_purchasable', 10, 2);
  function tema_woocommerce_is_purchasable($is_purchasable, $product) {
          return false;
  }
  

  该过滤器直接全局返回false，覆盖了针对特定分类的购买权限设置，无论自定义逻辑如何，所有产品都会被标记为不可购买。

• 主题自定义的Catalog模式动作：

  add_action('woocommerce_single_product_summary', 'tema_catalog_mode_product',30);
  

  该动作在产品摘要区域以优先级30执行，会输出主题自定义的Catalog内容，即使移除了默认的加入购物车按钮，主题仍会添加替代内容。

• 全局移除价格/按钮的动作：
  主题中针对catalog_mode_prices选项的全局remove_action操作（如移除产品页面价格、循环列表价格），会干扰针对特定分类的精准控制逻辑，且这些操作的执行时机早于自定义代码，导致自定义移除动作无效。

2. 兼容主题的自定义代码修改方案 #

以下代码会针对指定分类（fontaneria、herramientas）隐藏价格和购买按钮，同时绕过主题的全局限制：

// 针对指定分类，调整产品可购买状态
add_filter('woocommerce_is_purchasable', 'custom_purchasable_for_category', 20, 2);
function custom_purchasable_for_category($is_purchasable, $product) {
    $hide_categories = array('fontaneria', 'herramientas');
    if (has_term($hide_categories, 'product_cat', $product->get_id())) {
        return false; // 指定分类下产品不可购买
    }
    return $is_purchasable; // 其他分类保持原有状态
}

// 隐藏指定分类的价格，并移除主题的Catalog内容
add_filter('woocommerce_get_price_html', 'custom_hide_price_for_category', 20, 2);
function custom_hide_price_for_category($price, $product) {
    $hide_categories = array('fontaneria', 'herramientas');
    if (has_term($hide_categories, 'product_cat', $product->get_id())) {
        $price = ''; // 清空价格显示
        
        // 移除主题添加的Catalog模式内容
        remove_action('woocommerce_single_product_summary', 'tema_catalog_mode_product', 30);
        
        // 移除默认的价格和加入购物车按钮
        remove_action('woocommerce_single_product_summary', 'woocommerce_template_single_price', 10);
        remove_action('woocommerce_single_product_summary', 'woocommerce_template_single_add_to_cart', 30);
        
        // 添加自定义提示文本
        add_action('woocommerce_single_product_summary', function() {
            echo '<p>Este producto no está disponible para la venta en esta categoría.</p>';
        }, 30);
    }
    return $price;
}

// 在产品循环列表中隐藏指定分类的价格
add_action('woocommerce_before_shop_loop_item', 'custom_hide_loop_price_for_category', 10);
function custom_hide_loop_price_for_category() {
    global $product;
    $hide_categories = array('fontaneria', 'herramientas');
    if (has_term($hide_categories, 'product_cat', $product->get_id())) {
        remove_action('woocommerce_after_shop_loop_item_title', 'woocommerce_template_loop_price', 10);
    }
}

代码说明： #

• 提高过滤器优先级至20，确保在主题全局过滤器之后执行，覆盖主题设置。
• 针对指定分类单独控制woocommerce_is_purchasable返回值，而非全局修改。
• 移除主题添加的catalog_mode_product动作，避免输出额外干扰内容。
• 同时处理产品详情页和循环列表的价格隐藏逻辑。
• 添加自定义提示文本，替代原有价格与按钮区域。

内容的提问来源于stack exchange，提问作者unity-student