WordPress pre_get_users仅筛选users.php用户表格结果实现方法

数据老陈

2026-8-28

WordPress用户列表页自定义筛选作用域问题

场景说明

在WordPress后台users.php用户管理页，通过挂载pre_get_users钩子开发自定义筛选功能，规则为按「客户绑定的对应经理」过滤用户列表。目前已经完成筛选栏的经理下拉选择框开发，下拉框会自动拉取所有经理角色用户供管理员选择，正常展示效果如下：
筛选下拉框正常展示效果

问题描述

现有实现未对查询来源做区分，筛选逻辑会作用于当前页面触发的所有用户查询：

当筛选结果为0个用户，或是筛选结果集中不包含经理角色用户时，筛选下拉框本身拉取经理列表的查询也会被自定义规则拦截修改
最终导致筛选下拉框内容为空，无法正常切换筛选条件

异常效果如下：
筛选下拉框为空的异常效果

初始实现代码

$screen = get_current_screen();

if (!is_admin() || !$screen || 'users' !== $screen->base) {
    return $query;
}

if (!isset($_GET['filter_by_assigned_manager']) || !intval($_GET['filter_by_assigned_manager'])) {
    return $query;
}

// 自定义筛选拼接逻辑...

临时规避方案

目前临时通过全局计数器实现效果：仅对页面加载时触发的第一个用户查询（即用户表格的主列表查询）应用筛选规则，代码片段如下：

add_filter('pre_get_users', 'filter_users_manager_id');
function filter_users_manager_id($query) {
  global $counter_users_query;
  // 前置权限、页面判断逻辑...
  if (++$counter_users_query != 1) return $query;
  // 自定义筛选拼接逻辑...
}