如何通过编程过滤WooCommerce产品标签，解决无效过滤器问题？

问题原因 #

你使用的woocommerce_product_get_tags并非WooCommerce官方提供的有效过滤器钩子，因此代码无法生效。WooCommerce获取产品标签依赖WordPress原生函数及官方提供的特定钩子，需使用正确的钩子实现标签隐藏需求。

解决方案一：全局过滤产品标签（推荐） #

使用WordPress原生的get_the_terms钩子，可覆盖所有获取产品标签的场景（包括产品页面元信息、自定义模板调用等），同时不影响后台标签管理与商品过滤分组功能：

function exclude_specific_product_tags($terms, $post_id, $taxonomy) {
    // 仅对产品标签分类及产品页面生效
    if ($taxonomy !== 'product_tag' || !is_product()) {
        return $terms;
    }

    // 定义需要排除的标签slug
    $excluded_slugs = array('shop-by-birthday-gift-tote-bag');

    // 过滤掉指定标签
    if (!empty($terms) && is_array($terms)) {
        $terms = array_filter($terms, function($term) use ($excluded_slugs) {
            return !in_array($term->slug, $excluded_slugs);
        });
    }

    return $terms;
}
add_filter('get_the_terms', 'exclude_specific_product_tags', 10, 3);

解决方案二：针对标签列表输出过滤 #

如果你的主题使用wc_get_product_tag_list函数输出产品标签，可使用WooCommerce官方提供的woocommerce_product_tag_list钩子，直接修改标签列表的HTML输出：

function exclude_tags_from_product_tag_list($tag_list, $product_id, $tags) {
    // 定义需要排除的标签slug
    $excluded_slugs = array('shop-by-birthday-gift-tote-bag');
    
    // 过滤标签数组
    $filtered_tags = array_filter($tags, function($tag) use ($excluded_slugs) {
        return !in_array($tag->slug, $excluded_slugs);
    });

    // 重新生成标签列表HTML
    if (!empty($filtered_tags)) {
        $tag_links = [];
        foreach ($filtered_tags as $tag) {
            $tag_links[] = sprintf(
                '<a href="%s" rel="tag">%s</a>',
                esc_url(get_term_link($tag)),
                esc_html($tag->name)
            );
        }
        $tag_list = implode(', ', $tag_links);
    } else {
        $tag_list = '';
    }

    return $tag_list;
}
add_filter('woocommerce_product_tag_list', 'exclude_tags_from_product_tag_list', 10, 3);

使用说明 #

1. 将上述代码添加到当前主题的functions.php文件或自定义功能插件中
2. 替换$excluded_slugs数组中的值为你实际需要隐藏的标签slug
3. 测试产品页面，确认目标标签已不再显示，同时后台标签管理、商品过滤分组功能不受影响

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