¿Cómo puedo obtener una lista de usuarios por su rol?

¿Cómo puedo obtener una lista de todos los usuarios que están en WordPress por su rol o capacidades?

Por ejemplo:

• Mostrar all subscribers listen WordPress.
• Mostrar all authors listen WordPress.
• Mostrar all editors listen WordPress.

Puede haber alguna forma diferente de hacerlo, pero la forma más adecuada de hacerlo es seguir.

<?php

$args = array(
    'role'    => 'Your desired role goes here.',
    'orderby' => 'user_nicename',
    'order'   => 'ASC'
);
$users = get_users( $args );

echo '<ul>';
foreach ( $users as $user ) {
    echo '<li>' . esc_html( $user->display_name ) . '[' . esc_html( $user->user_email ) . ']</li>';
}
echo '</ul>';

?>

Aquí el enfoque simple para agrupar roles.

$wp_roles = wp_roles();
$result   = count_users();

foreach ( $result['avail_roles'] as $role => $count )
{
    if ( 0 == $count )
        continue; //pass role none

    $args = array(
        'role' => $role
    );

    $users = get_users( $args );
    $user  = array();
    for ( $i = 0; $i < $count ; $i++ )
        $user[] = esc_html( $users[ $i ]->display_name ); //show display name

    //output
    echo wp_sprintf( '<h2>%1$s</h2><ul><li>%2$s</li></ul>',
        esc_html( $wp_roles->role_names[ $role ] ),
        implode( '</li><li>', $user )
    );
}

Cuando encuentre usuarios con Roles de complementos para miembros finales, debe agregar "um_" al valor de su rol. Por ejemplo, creó el nombre de rol "Cliente" en el Complemento de membresía final, luego $ args sería

$args = array(
    'role'    => 'um_client',
    'orderby' => 'user_nicename',
    'order'   => 'ASC'
);

Ampliando la respuesta de Raja, también podría escribir una función auxiliar que maneje esto por usted:

<?php
# This goes in functions.php
function get_users_by_role($role, $orderby, $order) {
    $args = array(
        'role'    => $role,
        'orderby' => $orderby,
        'order'   => $order
    );

    $users = get_users( $args );

    return $users;
}
?>

Luego, para lograr que los usuarios asuman un rol específico, simplemente puede hacer:

<?php $users = get_users_by_role('Your role', 'user_nicename', 'ASC'); ?>