定制WordPress默认的用户搜索

Question

今天想给本站添加一个用户搜索的功能，于是想到了WordPress自带的 get_users 函数，在参数里面配置 search 字段，就可以搜索用户了，但是使用的时候非常奇怪，只有输入用户的全称才能找到用户，而输入一些模糊的字段，基本都找不到。

WordPress用户搜索默认是基于用户的 user_login 和 user_nicename 进行搜索的，但是这样的搜索内容并没有很大的用处，我在主题里面显示用户的中文名是采用的 display_name，还有WordPress默认的描述字段，我都希望能够通过关键字搜索到这些字段。

通过查找相关的API文档，我们可以使用 pre_user_query 的 action，定制 get_users 函数的参数，从而实现我们想要的内容：

add_action( 'pre_user_query', 'wt_user_query', 9 );
function wt_user_query($query){
    if(!empty($query->query_vars['search'])){
        global $wpdb;
        $keyword = $query->query_vars['search'];
        $keyword = str_replace('*','',$keyword);
        $query->query_where = $wpdb->prepare(" WHERE 1=1 AND (user_login LIKE %s OR user_email LIKE %s OR user_nicename LIKE %s OR display_name LIKE %s OR UM.meta_value LIKE  %s) AND UM.meta_key='nickname'","%".$keyword."%","%".$keyword."%","%".$keyword."%","%".$keyword."%","%".$keyword."%");
        $query->query_fields .= " ,$wpdb->users.display_name, UM.meta_value as nickname";
        $query->query_from .= " left join $wpdb->usermeta UM on ($wpdb->users.ID=UM.user_id) ";
    }
}

将上面的代码添加到我们的主题的 functions.php 文件即可，这个方法针对于小网站小数据，如果你的网站数据量很大，那么这个方法并不适合你，原因就是用到了MySQL的LIKE语句。

下面是相关搜索代码：

$args = array(
    'search' => $_GET['s'], //匹配搜索词
    'number' => 5, //显示用户数量
);
$blogusers = get_users($args);