WP_Users_List_Table::get_views()
Return an associative array listing all the views that can be used with this table.
Description
Provides a list of roles and user count for that role for easy Filtersing of the user table.
Return
(string[]) An array of HTML links keyed by their view.
Source
File: wp-admin/includes/class-wp-users-list-table.php
protected function get_views() { global $role; $wp_roles = wp_roles(); if ( $this->is_site_users ) { $url = 'site-users.php?id=' . $this->site_id; switch_to_blog( $this->site_id ); $users_of_blog = count_users( 'time', $this->site_id ); restore_current_blog(); } else { $url = 'users.php'; $users_of_blog = count_users(); } $total_users = $users_of_blog['total_users']; $avail_roles =& $users_of_blog['avail_roles']; unset( $users_of_blog ); $current_link_attributes = empty( $role ) ? ' class="current" aria-current="page"' : ''; $role_links = array(); $role_links['all'] = sprintf( '<a href="%s"%s>%s</a>', $url, $current_link_attributes, sprintf( /* translators: %s: Number of users. */ _nx( 'All <span class="count">(%s)</span>', 'All <span class="count">(%s)</span>', $total_users, 'users' ), number_format_i18n( $total_users ) ) ); foreach ( $wp_roles->get_names() as $this_role => $name ) { if ( ! isset( $avail_roles[ $this_role ] ) ) { continue; } $current_link_attributes = ''; if ( $this_role === $role ) { $current_link_attributes = ' class="current" aria-current="page"'; } $name = translate_user_role( $name ); $name = sprintf( /* translators: 1: User role name, 2: Number of users. */ __( '%1$s <span class="count">(%2$s)</span>' ), $name, number_format_i18n( $avail_roles[ $this_role ] ) ); $role_links[ $this_role ] = "<a href='" . esc_url( add_query_arg( 'role', $this_role, $url ) ) . "'$current_link_attributes>$name</a>"; } if ( ! empty( $avail_roles['none'] ) ) { $current_link_attributes = ''; if ( 'none' === $role ) { $current_link_attributes = ' class="current" aria-current="page"'; } $name = __( 'No role' ); $name = sprintf( /* translators: 1: User role name, 2: Number of users. */ __( '%1$s <span class="count">(%2$s)</span>' ), $name, number_format_i18n( $avail_roles['none'] ) ); $role_links['none'] = "<a href='" . esc_url( add_query_arg( 'role', 'none', $url ) ) . "'$current_link_attributes>$name</a>"; } return $role_links; }
Changelog
Version | Description |
---|---|
3.1.0 | Introduced. |
© 2003–2021 WordPress Foundation
Licensed under the GNU GPLv2+ License.
https://developer.wordpress.org/reference/classes/wp_users_list_table/get_views