WordPress用户角色筛选与查询指南

// 获取所有角色为'student'的用户
$students = get_users( array( 'role' => 'student' ) );

// 遍历并输出用户邮箱（示例）
if ( ! empty( $students ) ) {
    foreach ( $students as $user ) {
        echo $user->user_email . '<br>';
    }
}

// 获取所有角色为'student'或'teacher'的用户
$users = get_users( array( 'role__in' => array( 'student', 'teacher' ) ) );

// 遍历用户（示例）
if ( ! empty( $users ) ) {
    foreach ( $users as $user ) {
        echo $user->display_name . ' (Role: ' . implode(', ', $user->roles) . ')<br>';
    }
}

// 获取所有学生用户，按用户昵称升序排列
$students_sorted = get_users( array(
    'role'    => 'student',
    'orderby' => 'user_nicename',
    'order'   => 'ASC'
) );

// 创建一个新的WP_User_Query实例，查询角色为'Student'的用户
$user_query = new WP_User_Query( array( 'role' => 'Student' ) );

// 获取查询结果
$users = $user_query->get_results();

// 遍历用户（示例）
if ( ! empty( $users ) ) {
    foreach ( $users as $user ) {
        echo $user->user_email . '<br>';
    }
}

// 假设要查询所有学生，但排除邮箱包含'@yourdomain.com'的用户
$user_query = new WP_User_Query( array(
    'role'       => 'student',
    'meta_query' => array(
        'relation' => 'AND', // 如果有多个条件，可以使用AND/OR
        array(
            'key'     => 'user_email', // 实际上用户邮箱是wp_users表字段，不能直接用meta_query查询
                                       // 这里只是示例meta_query的用法，邮箱过滤需另行处理
            'value'   => '@yourdomain.com',
            'compare' => 'NOT LIKE',
        ),
        // 如果要查询自定义的用户meta_key，例如'first_name'
        array(
            'key'     => 'first_name',
            'value'   => 'John',
            'compare' => '=',
        )
    )
) );
// 注意：用户邮箱是wp_users表字段，不是wp_usermeta表，
// 因此不能直接通过meta_query来过滤user_email。
// 对于user_email的过滤，通常需要在获取结果后进行PHP层面的二次过滤，
// 或者使用更底层的SQL查询。

// 正确的邮箱过滤方式 (如果邮箱包含特定字符串，可以使用search)
// 但更精确的'NOT LIKE'需要PHP层面过滤或直接SQL
$user_query = new WP_User_Query( array(
    'role' => 'student',
    // 'search' => '*@yourdomain.com*', // 这种方式是LIKE，不是NOT LIKE
    // 'search_columns' => array( 'user_email' ),
) );

$users = $user_query->get_results();

$filtered_users = array();
if ( ! empty( $users ) ) {
    foreach ( $users as $user ) {
        // 在PHP层面进行邮箱过滤
        if ( strpos( $user->user_email, '@yourdomain.com' ) === false ) {
            $filtered_users[] = $user;
        }
    }
}
// $filtered_users 包含了符合条件的用户

// 此函数通常放在主题的 functions.php 文件中
function get_users_by_role_custom( $role, $orderby = 'ID', $order = 'ASC' ) {
    $args = array(
        'role'    => $role,
        'orderby' => $orderby,
        'order'   => $order
    );

    $users = get_users( $args );

    return $users;
}

// 使用自定义函数
$student_users = get_users_by_role_custom( 'student', 'user_nicename', 'ASC' );
// 现在 $student_users 包含了所有学生用户，按昵称升序排列

SELECT
    u.ID,
    u.user_nicename,
    u.user_email
FROM
    wp_users AS u
INNER JOIN
    wp_usermeta AS um ON u.ID = um.user_id
WHERE
    um.meta_key = 'wp_capabilities' AND um.meta_value LIKE '%student%'
ORDER BY
    u.user_nicename;

global $wpdb;

$role_name = 'student';
$sql = $wpdb->prepare( "
    SELECT
        u.ID,
        u.user_nicename,
        u.user_email
    FROM
        {$wpdb->users} AS u
    INNER JOIN
        {$wpdb->usermeta} AS um ON u.ID = um.user_id
    WHERE
        um.meta_key = '{$wpdb->prefix}capabilities' AND um.meta_value LIKE %s
    ORDER BY
        u.user_nicename
", '%' . $wpdb->esc_like( $role_name ) . '%' ); // 使用 $wpdb->prepare 和 $wpdb->esc_like 防止SQL注入

$users_from_sql = $wpdb->get_results( $sql );

if ( ! empty( $users_from_sql ) ) {
    foreach ( $users_from_sql as $user ) {
        echo $user->user_email . '<br>';
    }
}