Описание pre_get_users
— Action
Хук pre_get_users позволяет изменять параметры запроса пользователей перед его выполнением. Он срабатывает в момент, когда WordPress подготавливает запрос для получения списка пользователей, что дает возможность изменять критерии выборки, сортировку и другие параметры
Примеры использования
Пример фильтрации пользователей по роли:
add_action('pre_get_users', function($query) {
if (!is_admin() && $query->is_main_query()) {
$query->set('role', 'subscriber');
}
});
В этом примере мы выбираем только пользователей с ролью ‘subscriber’ на фронтенде сайта
Пример изменения порядка сортировки пользователей:
add_action('pre_get_users', function($query) {
if ($query->is_main_query()) {
$query->set('orderby', 'user_registered');
$query->set('order', 'DESC');
}
});
Здесь мы сортируем пользователей по дате регистрации в порядке убывания
Пример ограничения количества возвращаемых пользователей:
add_action('pre_get_users', function($query) {
if ($query->is_main_query()) {
$query->set('number', 5);
}
});
Мы ограничиваем выборку до 5 пользователей
— Лучшие практики
– Использование
Используйте этот хук, когда необходимо изменить параметры выборки пользователей перед выполнением запроса
– Производительность
Хук не должен существенно влиять на производительность, если изменения ограничены параметрами запроса
– Предупреждения
Обязательно проверяйте, что изменения применяются только к нужным запросам, чтобы избежать влияния на другие части сайта
Альтернативы
Тип: action
Этот хук позволяет изменять параметры запросов постов, но также может быть использован для запросов пользователей с дополнительными проверками
Используйте его, если вам нужно применить аналогичные изменения к запросам постов, а не только к пользователям
