count_users()
Считает общее количество пользователей, разделяя их по ролям (администраторы, подписчики).
1 раз — 0.0375981 сек (тормоз) | 50000 раз — 1750.27 сек (тормоз) | PHP 7.3.12, WP 5.4
Хуки из функции
Возвращает
Массив
. Данные о количестве пользователей. Массив такого вида:
Array( [total_users] => 2 [avail_roles] => Array( [administrator] => 1 [subscriber] => 1 ) )
Использование
$counts = count_users( $strategy );
- $strategy(строка)
- Может быть:
time
илиmemory
.
По умолчанию: 'time' - $site_id(число) (c версии 4.9)
- ID сайта, для мультисайт режима.
По умолчанию: null
Примеры
#1 Что выводит функция
print_r( count_users() ); /* Array ( [total_users] => 474 [avail_roles] => Array ( [administrator] => 1 [subscriber] => 473 [none] => 0 ) ) */
#2 Пример, вывода записи о количестве пользователей в разрезе их ролей:
$result = count_users(); $roles = []; foreach( $result['avail_roles'] as $role => $count ){ $roles[] = "{$role} ({$count})"; } echo sprintf( 'На сайте пользователей - %s, среди которых: %s.', $result['total_users'], implode( ', ', $roles ) );
В результате мы получит такую надпись:
На сайте пользователей - 2, среди которых: administrator (1), subscriber (1).
Заметки
- Global. wpdb. $wpdb WordPress database abstraction object.
Список изменений
С версии 3.0.0 | Введена. |
С версии 4.4.0 | The number of users with no role is now included in the none element. |
С версии 4.9.0 | The $site_id parameter was added to support multisite. |