在嵌套自定义查询提供器中无法访问父循环对象的问题

问题背景 #

使用Bricks Builder的自定义查询构建 threaded comment 系统，父评论查询正常，但嵌套的回复评论查询无法获取父评论ID，导致无结果返回。当前\Bricks\Query::get_loop_object()在子查询处理函数中返回null。

核心原因 #

bricks/query/run钩子的执行时机是查询初始化阶段，此时嵌套查询还未关联到父循环的当前迭代对象，因此\Bricks\Query::get_loop_object()无法获取父循环数据。需要在循环渲染阶段传递父评论ID到子查询。

解决方案 #

步骤1：确保父查询返回标准WP_Comment对象 #

父评论处理函数直接返回get_comments()的完整WP_Comment实例，不要返回自定义格式化数组，这样Bricks能正确管理循环上下文：

function gna_comments_query_handler() {
    global $post;
    $post_id = $post->ID;
    
    return get_comments([
        'post_id' => $post_id,
        'parent' => 0,
        'status' => 'approve',
        'fields' => 'all' // 强制返回完整WP_Comment对象
    ]);
}

步骤2：在父循环渲染时设置全局评论变量 #

通过Bricks的bricks/loop/before_render动作，将当前父评论设置为全局$comment变量，供子查询读取：

add_action('bricks/loop/before_render', 'gna_set_global_parent_comment', 10, 2);
function gna_set_global_parent_comment($loop_object, $query_obj) {
    // 仅针对父评论查询生效
    if ($query_obj->object_type === 'gna_comments' && $loop_object instanceof WP_Comment) {
        global $comment;
        $comment = $loop_object;
    }
}

步骤3：修改子查询处理函数读取全局评论ID #

子查询直接从全局$comment变量中获取父评论ID，执行回复查询：

function gna_comment_replies_query_handler() {
    global $comment;
    $parent_id = isset($comment->comment_ID) ? $comment->comment_ID : 0;
    
    // 无有效父ID时返回空数组
    if (empty($parent_id)) {
        return [];
    }
    
    return get_comments([
        'parent' => $parent_id,
        'status' => 'approve',
        'fields' => 'all'
    ]);
}

步骤4：清理全局变量（可选） #

为避免全局变量污染其他循环，在父循环结束后清空$comment：

add_action('bricks/loop/after_render', 'gna_clear_global_comment', 10, 2);
function gna_clear_global_comment($loop_object, $query_obj) {
    if ($query_obj->object_type === 'gna_comments') {
        global $comment;
        if ($comment instanceof WP_Comment && $comment->comment_ID === $loop_object->comment_ID) {
            $comment = null;
        }
    }
}

完整代码整合 #

// 注册自定义查询类型
add_filter('bricks/setup/control_options', 'gna_register_query_types');
function gna_register_query_types($control_options) {
    $control_options['queryTypes']['gna_comments'] = 'Comments';
    $control_options['queryTypes']['gna_comment_replies'] = 'Comment Replies';
    return $control_options;
}

// 执行自定义查询
add_filter('bricks/query/run', 'gna_run_custom_query', 10, 2);
function gna_run_custom_query($results, $query_obj) {
    if ($query_obj->object_type === 'gna_comments') {
        $results = gna_comments_query_handler();
    }
    if ($query_obj->object_type === 'gna_comment_replies') {
        $results = gna_comment_replies_query_handler();
    }
    return $results;
}

// 父评论查询处理
function gna_comments_query_handler() {
    global $post;
    $post_id = $post->ID;
    
    return get_comments([
        'post_id' => $post_id,
        'parent' => 0,
        'status' => 'approve',
        'fields' => 'all'
    ]);
}

// 子评论回复查询处理
function gna_comment_replies_query_handler() {
    global $comment;
    $parent_id = isset($comment->comment_ID) ? $comment->comment_ID : 0;
    
    if (empty($parent_id)) {
        return [];
    }
    
    return get_comments([
        'parent' => $parent_id,
        'status' => 'approve',
        'fields' => 'all'
    ]);
}

// 设置全局父评论变量
add_action('bricks/loop/before_render', 'gna_set_global_parent_comment', 10, 2);
function gna_set_global_parent_comment($loop_object, $query_obj) {
    if ($query_obj->object_type === 'gna_comments' && $loop_object instanceof WP_Comment) {
        global $comment;
        $comment = $loop_object;
    }
}

// 清理全局评论变量
add_action('bricks/loop/after_render', 'gna_clear_global_comment', 10, 2);
function gna_clear_global_comment($loop_object, $query_obj) {
    if ($query_obj->object_type === 'gna_comments') {
        global $comment;
        if ($comment instanceof WP_Comment && $comment->comment_ID === $loop_object->comment_ID) {
            $comment = null;
        }
    }
}

验证方法 #

1. 确保Bricks结构中，子查询容器直接嵌套在父查询容器内部
2. 在子查询的循环中添加动态数据绑定（比如评论内容），测试是否能正常渲染回复

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