#[AllowDynamicProperties]
class WP_User_Query {
    public $query_vars = array();
    private $results;
    private $total_users = 0;
    public $meta_query = false;
    public $request;
    
    // SQL clause properties
    public $query_fields;
    public $query_from;
    public $query_where;
    public $query_orderby;
    public $query_limit;
}

public function __construct( null|string|array $query = null )

$query = new WP_User_Query( array(
    'role' => 'author',
    'orderby' => 'registered',
    'order' => 'DESC',
) );

$users = $query->get_results();

// Users with author role
'role' => 'author'

// Users with author OR editor role
'role__in' => array( 'author', 'editor' )

// Users with both roles (rare, but possible)
'role' => array( 'author', 'premium_member' )

// Users who can edit posts
'capability' => 'edit_posts'

// Exclude administrators
'role__not_in' => array( 'administrator' )

// Search all relevant columns
'search' => '*john*'

// Search specific columns
'search' => 'john',
'search_columns' => array( 'user_login', 'display_name' )

// Email search (auto-detected)
'search' => '[email protected]'

'meta_query' => array(
    'relation' => 'AND',
    array(
        'key'     => 'last_login',
        'value'   => strtotime( '-30 days' ),
        'compare' => '>',
        'type'    => 'NUMERIC',
    ),
    array(
        'key'     => 'subscription_status',
        'value'   => 'active',
    ),
)

'orderby' => array(
    'display_name' => 'ASC',
    'ID' => 'DESC',
)

// Page 2, 20 per page
'number' => 20,
'paged'  => 2,

// Just IDs
'fields' => 'ID'

// Specific fields
'fields' => array( 'ID', 'user_email', 'display_name' )

// Users with published posts
'has_published_posts' => true

// Users with published posts in specific types
'has_published_posts' => array( 'post', 'page' )

public function prepare_query( string|array $query = array() ): void

public function query(): void

public function get_results(): array

public function get_total(): int

public function get( string $query_var ): mixed

public function set( string $query_var, mixed $value ): void

public static function fill_query_vars( string|array $args ): array

do_action_ref_array( 'pre_get_users', array( &$this ) );

add_action( 'pre_get_users', function( $query ) {
    if ( ! is_admin() ) {
        $query->set( 'role', 'subscriber' );
    }
} );

do_action_ref_array( 'pre_user_query', array( &$this ) );

add_action( 'pre_user_query', function( $query ) {
    // Modify SQL directly
    $query->query_where .= " AND user_status = 0";
} );

$results = apply_filters_ref_array( 'users_pre_query', array( null, &$this ) );

$columns = apply_filters( 'user_search_columns', $columns, $search, $this );

$sql = apply_filters( 'found_users_query', 'SELECT FOUND_ROWS()', $this );

$args = array(
    'role'    => 'subscriber',
    'orderby' => 'registered',
    'order'   => 'DESC',
    'number'  => 10,
);

$user_query = new WP_User_Query( $args );

if ( ! empty( $user_query->get_results() ) ) {
    foreach ( $user_query->get_results() as $user ) {
        echo $user->display_name . '<br>';
    }
} else {
    echo 'No users found.';
}

$paged = get_query_var( 'paged' ) ? get_query_var( 'paged' ) : 1;
$per_page = 20;

$query = new WP_User_Query( array(
    'number' => $per_page,
    'paged'  => $paged,
) );

$total = $query->get_total();
$pages = ceil( $total / $per_page );

echo "Showing page {$paged} of {$pages} ({$total} users total)";

$query = new WP_User_Query( array(
    'meta_query' => array(
        'relation' => 'AND',
        'membership' => array(
            'key'     => 'membership_level',
            'value'   => array( 'gold', 'platinum' ),
            'compare' => 'IN',
        ),
        'active' => array(
            'key'     => 'last_login',
            'value'   => strtotime( '-90 days' ),
            'compare' => '>',
            'type'    => 'NUMERIC',
        ),
    ),
    'orderby' => 'membership',
    'order'   => 'DESC',
) );

$query = new WP_User_Query( array(
    'search'         => '*smith*',
    'search_columns' => array( 'user_login', 'user_email', 'display_name' ),
) );

$query = new WP_User_Query( array(
    'role'   => 'editor',
    'fields' => 'ID',
) );

$editor_ids = $query->get_results(); // [1, 5, 12, ...]

$query = new WP_User_Query( array(
    'blog_id' => 2,
    'role'    => 'author',
) );

$query = new WP_User_Query( array(
    'has_published_posts' => array( 'post' ),
    'orderby'             => 'post_count',
    'order'               => 'DESC',
    'number'              => 10,
) );

$query = new WP_User_Query( array(
    'exclude' => array( 1, 2, 3 ), // Exclude admin IDs
    'role__not_in' => array( 'administrator' ),
) );

$query = new WP_User_Query( array(
    'date_query' => array(
        array(
            'after'  => '2024-01-01',
            'before' => '2024-12-31',
        ),
    ),
) );