FacetWP嵌套复选框条件渲染问题：无法隐藏三级复选框

你当前的代码无效，核心原因是facetwp_facet_html钩子接收的$output是已经渲染完成的HTML内容，修改$params['values']不会自动更新这个HTML。下面提供两种可行的解决方案：

方案1：推荐 - 修改FacetWP的values数据源（无需手动渲染HTML） #

使用facetwp_facet_values钩子，在FacetWP准备筛选器选项的阶段直接过滤values数组，后续渲染逻辑会自动使用过滤后的选项生成复选框，这是最符合插件设计逻辑的用法。

add_filter('facetwp_facet_values', 'custom_filter_category_facet_values', 10, 2);
function custom_filter_category_facet_values($values, $params) {
    // 仅针对名为"categories"的筛选器生效
    if ('categories' == $params['facet']['name']) {
        // 过滤掉depth=2的三级分类选项（FacetWP中depth从0开始计数：一级=0，二级=1，三级=2）
        $filtered_values = array_filter($values, function($value) {
            return $value['depth'] != 2;
        });
        // 重新索引数组，避免键不连续导致渲染异常
        return array_values($filtered_values);
    }
    return $values;
}

方案2：手动重新生成复选框HTML（适合需要自定义HTML结构的场景） #

如果必须使用facetwp_facet_html钩子，需要基于过滤后的values重新构建完整的复选框HTML，替换原有的$output：

add_filter('facetwp_facet_html', 'custom_hide_single_child_facets', 10, 2 );
function custom_hide_single_child_facets( $output, $params ) {
    if ( 'categories' == $params['facet']['name'] ) {        
        $values = $params['values'];
        $filtered = [];

        // 过滤掉三级分类选项
        foreach ($values as $value) {
            if ($value['depth'] != 2) {
                $filtered[] = $value;
            }
        }

        // 重新构建符合FacetWP默认样式的复选框HTML
        $output = '';
        foreach ($filtered as $value) {
            $selected = $value['selected'] ? ' checked' : '';
            $count = esc_attr($value['count']);
            $label = esc_html($value['label']);
            $value_attr = esc_attr($value['value']);
            
            $output .= '<div class="facetwp-checkbox">';
            $output .= '<input type="checkbox" id="facetwp-'.$params['facet']['name'].'-'.$value_attr.'" value="'.$value_attr.'"'.$selected.' data-count="'.$count.'">';
            $output .= '<label for="facetwp-'.$params['facet']['name'].'-'.$value_attr.'">'.$label.' <span class="facetwp-counter">('.$count.')</span></label>';
            $output .= '</div>';
        }
    }
    return $output;
}

注意事项 #

1. 确认depth值：FacetWP中分类的depth从0开始计数，一级分类depth=0，二级=1，三级=2，你的条件$value['depth'] != 2对应隐藏三级分类，是正确的。
2. 清理缓存：修改代码后，务必在WP后台的「FacetWP设置」中点击「Clear Cache」，避免旧的选项缓存导致修改不生效。
3. 自定义模板适配：如果使用了自定义的FacetWP筛选器模板，需要调整HTML结构以匹配你的模板样式。

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