使用get_terms过滤器导致WordPress编辑文章页分类复选框未选中

嘿，我帮你梳理下这段WordPress分类筛选代码的问题——文章编辑页已关联分类能显示但无法勾选，大概率是代码里的几个细节逻辑踩坑了，咱们一步步来解决：

1. 未定义的isIn函数是隐形炸弹 #

你代码里用到了isIn()函数但没给出实现，如果这个自定义函数的判断逻辑有偏差（比如没正确匹配term_id，或者父级判断出错），会直接导致分类筛选异常，尤其是文章编辑页这种需要精准识别已选分类的场景。

建议直接替换成WordPress内置的in_array()函数，它更可靠且符合WP开发规范，比如把isIn($terms[$i]->term_id, $cats)改成in_array($terms[$i]->term_id, $cats)，父级判断同理。

2. 逻辑分支与冗余SQL的干扰 #

看你的代码结构，处理category或products分类时直接在if块内return了$filteredTerms，后面的"orphans"处理代码永远不会执行；更关键的是，你在SQL里用UNION SELECT ... post_tag完全没必要——你当前处理的是分类，混入标签的term_id会导致无效ID干扰筛选逻辑，这很可能是已选分类无法被识别的核心原因之一。

3. 缺少文章编辑页的上下文判断 #

文章编辑页的分类选择框，调用get_terms时会带上当前文章ID来标记已选中分类，你的代码一刀切筛选分类，破坏了已选分类的关联标记，导致显示了却无法勾选。

修正后的完整代码 #

我调整了逻辑，保留核心功能的同时修复了上述问题：

add_filter( 'get_terms', 'terms_filter', 10, 3 ); // 新增$args参数获取调用上下文
function terms_filter( $terms, $taxonomies, $args ) {
    $filteredTerms = [];

    // 仅处理category和products分类
    if ( in_array( 'category', $taxonomies ) || in_array( 'products', $taxonomies ) ) {
        global $wpdb;
        $user = wp_get_current_user();
        
        if ( $user->exists() ) {
            $role = $user->roles[0];
            // 移除冗余的post_tag UNION，仅获取当前角色允许的分类ID，同时用prepare防SQL注入
            $sql = "SELECT term_id FROM {$wpdb->prefix}catpermissions WHERE role = %s";
            $allowed_term_ids = $wpdb->get_col( $wpdb->prepare( $sql, $role ) );

            // 筛选允许的分类
            foreach ( $terms as $term ) {
                if ( in_array( $term->term_id, $allowed_term_ids ) ) {
                    // 处理父级：若父级不在允许列表，设为0避免分类层级断裂
                    if ( !in_array( $term->parent, $allowed_term_ids ) ) {
                        $term->parent = 0;
                    }
                    $filteredTerms[] = $term;
                }
            }

            // 文章编辑页专属逻辑：确保当前文章已关联的分类被保留（即使不在允许列表，可按需调整）
            if ( isset( $args['object_ids'] ) && !empty( $args['object_ids'] ) ) {
                $post_id = reset( $args['object_ids'] );
                $selected_term_ids = wp_get_object_terms( $post_id, $taxonomies, ['fields' => 'ids'] );
                
                foreach ( $terms as $term ) {
                    if ( in_array( $term->term_id, $selected_term_ids ) && !in_array( $term->term_id, wp_list_pluck( $filteredTerms, 'term_id' ) ) ) {
                        $filteredTerms[] = $term;
                    }
                }
            }

            return $filteredTerms;
        }
    }

    // 其他分类的孤儿节点处理逻辑
    foreach ( $terms as $term ) {
        $parent_exists = false;
        foreach ( $terms as $parent_term ) {
            if ( $parent_term->term_id === $term->parent ) {
                $parent_exists = true;
                break;
            }
        }
        if ( !$parent_exists ) {
            $term->parent = 0;
        }
        $filteredTerms[] = $term;
    }

    return $filteredTerms;
}

关键改进点说明 #

• 安全优化：用wpdb->prepare()处理SQL查询，避免注入风险；
• 上下文识别：通过$args['object_ids']判断是否在文章编辑页，强制保留已关联分类；
• 逻辑精简：移除无效的标签ID查询，避免干扰分类筛选；
• 可靠判断：替换自定义isIn为WP内置in_array，减少自定义函数的潜在问题；
• 层级修复：优化父级分类的判断逻辑，避免分类层级断裂导致的显示异常。

额外排查建议 #

• 检查浏览器控制台是否有JS错误：文章编辑页的分类勾选依赖JS，如果代码导致分类HTML结构异常（比如缺少checked属性），会直接导致无法勾选；
• 确认catpermissions表数据：确保当前用户角色对应的分类ID包含已选分类，或者根据业务需求调整逻辑（比如允许已选分类即使不在允许列表也能保留勾选状态）。

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