WooCommerce产品分类页小工具仅显示当前父类及子类隐藏其他分类

需求说明 #

• 站点设有男装、女装两个独立服装产品目录，侧边栏挂载WooCommerce产品分类小工具
• 预期效果：所有女装分类页及其下属子分类页中，隐藏小工具内的男装分类及所有子分类；所有男装分类页及其下属子分类页中，隐藏小工具内的女装分类及所有子分类

原代码失效原因 #

原代码加了条件判断后无法运行，核心问题有两个：

1. 钩子注册时机错误：WordPress的add_filter必须在请求执行的早期阶段完成注册，把钩子注册逻辑包裹在is_product_category()、has_term()的条件判断块内时，等这类条件标签能返回正确结果的执行节点，已经过了产品分类小工具过滤器的注册窗口期，过滤器根本没挂载成功，自然不会触发
2. 重复声明函数：两段判断块内定义了同名的organicweb_exclude_widget_category函数，即使时机正确也会触发PHP致命错误

方案对比 #

CSS隐藏方案 #

属于可用但不推荐的实现：

• 优点：写法简单，匹配body标签上的分类类名+对应分类列表项的ID选择器，就能快速实现视觉隐藏效果
• 缺点：仅做视觉层面的隐藏，对应分类的链接、名称仍然会被查询出来输出到页面源码中，既会产生无意义的页面输出，也存在样式加载异常时内容漏出、对搜索引擎不友好的问题，不是合规的最优实现

原生PHP过滤器实现（推荐） #

把条件判断逻辑放到过滤器回调内部，既可以保证钩子提前正常注册，又能在小工具查询分类前动态传入排除参数，对应分类不会被查询输出到前端，逻辑更严谨。
假设女装顶级分类ID为267，男装顶级分类ID为262，可直接使用如下代码：

// 提前注册过滤器，不要在外层加页面判断
add_filter( 'woocommerce_product_categories_widget_args', 'custom_exclude_cat_for_widget' );
function custom_exclude_cat_for_widget( $args ) {
    // 非产品分类页、非产品详情页直接返回原参数
    if ( ! is_product_category() && ! is_singular( 'product' ) ) {
        return $args;
    }

    $belong_cat_ids = [];
    // 分类归档页获取当前分类及所有父级分类ID
    if ( is_product_category() ) {
        $current_cat = get_queried_object();
        $belong_cat_ids[] = intval( $current_cat->term_id );
        $ancestor_ids = get_ancestors( $current_cat->term_id, 'product_cat' );
        $belong_cat_ids = array_merge( $belong_cat_ids, array_map( 'intval', $ancestor_ids ) );
    }
    // 产品详情页获取当前产品所属分类及父级分类ID
    if ( is_singular( 'product' ) ) {
        global $post;
        $product_cat_ids = wp_get_post_terms( $post->ID, 'product_cat', [ 'fields' => 'ids' ] );
        if ( ! is_wp_error( $product_cat_ids ) && ! empty( $product_cat_ids ) ) {
            $belong_cat_ids = array_merge( $belong_cat_ids, array_map( 'intval', $product_cat_ids ) );
            foreach ( $product_cat_ids as $cat_id ) {
                $ancestor_ids = get_ancestors( $cat_id, 'product_cat' );
                $belong_cat_ids = array_merge( $belong_cat_ids, array_map( 'intval', $ancestor_ids ) );
            }
        }
    }

    $belong_cat_ids = array_unique( $belong_cat_ids );
    $exclude = isset( $args['exclude'] ) ? (array)$args['exclude'] : [];

    // 属于女装分类体系的页面，排除男装分类
    if ( in_array( 267, $belong_cat_ids ) ) {
        $exclude[] = 262;
    }
    // 属于男装分类体系的页面，排除女装分类
    if ( in_array( 262, $belong_cat_ids ) ) {
        $exclude[] = 267;
    }

    $args['exclude'] = array_unique( $exclude );
    return $args;
}

代码说明：

• 自动识别当前分类的所有父级分类，访问任意层级的子分类页也能正确判断归属，不会出现子分类页判断失效的问题
• 兼容产品详情页，打开任意男装/女装商品详情页时，侧边栏分类也会对应隐藏另一性别的分类
• 直接修改分类查询的排除参数，被隐藏的分类不会从数据库读取、也不会输出到前端源码，比CSS隐藏更彻底

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