BuddyPress自定义成员循环：预排序用户ID的分页排序问题

问题场景 #

我在BuddyPress中实现了一个带分页（每页最多25条）的自定义成员循环，希望基于自定义表中预排序好的用户ID列表展示成员。该用户ID列表来自我的自定义表，已按指定列完成排序。

原实现代码：

add_filter( 'bp_after_has_members_parse_args', 'my_custom_users' );
function my_custom_users( $args ) {
    $per_page_setting = 25;
    $page = 1;
    if ( isset( $_REQUEST['vpage'] ) ) {
        $page = absint( $_REQUEST['vpage'] );
    }
    
    global $wpdb;
    $user_ids = $wpdb->get_col('SELECT user_id FROM some_table WHERE some_condition = ' . bp_loggedin_user_id() . ' ORDER BY column DESC');
    
    # @see bp_has_members()
    $args['page']     = $page;
    $args['per_page'] = $per_page_setting;
    $args['max']      = count($user_ids);
    $args['include']  = $user_ids;

    return $args;
}

遇到的问题 #

所有功能正常，仅排序异常：bp_has_members()、bp_core_get_users()和BP_User_Query()不会保留传入的ID列表顺序，即便它们本可以直接对预排序的ID列表分页。

尝试用array_slice截取分页后的ID列表传入include，但会破坏分页逻辑（BuddyPress会认为传入的是完整用户ID列表，导致分页计数错误）：

$args['include']  = array_slice($visitor_ids, ($page-1)*$per_page_setting, $per_page_setting);

正确处理方式 #

核心思路是：保留完整预排序ID列表以保证分页计数正确，同时强制BuddyPress按照该ID顺序排序结果。

修改后的完整代码 #

add_filter( 'bp_after_has_members_parse_args', 'my_custom_users' );
function my_custom_users( $args ) {
    $per_page_setting = 25;
    $page = 1;
    if ( isset( $_REQUEST['vpage'] ) ) {
        $page = absint( $_REQUEST['vpage'] );
    }
    
    global $wpdb;
    $user_ids = $wpdb->get_col('SELECT user_id FROM some_table WHERE some_condition = ' . bp_loggedin_user_id() . ' ORDER BY column DESC');
    
    // 保留分页参数与完整预排序ID列表，确保分页计数正确
    $args['page']     = $page;
    $args['per_page'] = $per_page_setting;
    $args['max']      = count($user_ids);
    $args['include']  = $user_ids;
    // 禁用BuddyPress默认排序规则，避免干扰自定义排序
    $args['type'] = 'none';

    // 绑定排序过滤器，仅对当前自定义查询生效
    add_filter( 'bp_user_query_pre_query', function( $users, $query ) use ( $user_ids ) {
        // 确保只处理当前的自定义成员查询
        if ( ! empty( $query->query_vars['include'] ) && $query->query_vars['include'] === $user_ids ) {
            // 将用户对象转为ID为键的数组，提升排序效率
            $user_map = array();
            foreach ( $users as $user ) {
                $user_map[$user->ID] = $user;
            }
            // 按照预排序的ID列表重新排列用户对象
            $sorted_users = array();
            foreach ( $user_ids as $user_id ) {
                if ( isset( $user_map[$user_id] ) ) {
                    $sorted_users[] = $user_map[$user_id];
                }
            }
            $users = $sorted_users;
        }
        return $users;
    }, 10, 2 );

    return $args;
}

关键说明 #

1. 禁用默认排序：设置$args['type'] = 'none'，避免BuddyPress默认的排序规则（如活跃时间、注册时间）覆盖自定义排序。
2. 自定义排序逻辑：通过bp_user_query_pre_query过滤器，在查询得到用户对象列表后，按照预排序的ID数组重新排列结果，完全匹配自定义表的排序顺序。
3. 高效排序实现：先将用户对象转为以ID为键的映射数组，再按ID顺序提取，比嵌套循环效率更高，适合用户数量较多的场景。
4. 查询隔离：过滤器内增加判断条件，仅处理当前的自定义成员查询，不会影响其他BuddyPress成员循环。

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