get_users
В WordPress get_users
применяется для получения списка пользователей из базы данных. Эта функция возвращает массив объектов WP_User
, представляющих каждого пользователя, и вы можете указать различные критерии для фильтрации результатов.
Синтаксис функции get_users
:
$args
— массив или строка параметров, которые вы можете использовать для отбора результатов. Некоторые из наиболее часто используемых параметров следующие:
role
: Роль пользователей, которые необходимо получить (например, ‘администратор’, ‘редактор’, ‘автор’, ‘автор’, ‘вкладчик’ или ‘подписчик’).
meta_key
: Имя поля метаданных пользователя для поиска.
meta_value: Значение поля метаданных пользователя для поиска.
orderby
: Поле, по которому следует упорядочить результаты (например, ‘login’, ‘nicename’, ’email’, ‘url’, ‘registered’ или ‘display_name’).
порядок: Направление сортировки результатов (‘ASC’ или ‘DESC’).
Пример использования функции get_users
:
Код позволит получить всех пользователей с ролью «подписчик», а затем просмотреть результаты и вывести их имена.
Обратите внимание, что функция get_users является мощным инструментом для получения данных о пользователях, но она может быть достаточно медленной, если вы работаете с большим количеством пользователей. Если вам нужно получить конкретного пользователя по ID, вместо нее можно использовать функцию get_user_by
.