users_list_table_query_args
Фильтрует аргументы запроса, используемые для получения пользователей в таблице списка пользователей в админке.
Использование
add_filter( 'users_list_table_query_args', 'wp_kama_users_list_table_query_args_filter' );
/**
* Function for `users_list_table_query_args` filter-hook.
*
* @param array $args Arguments passed to WP_User_Query to retrieve items for the current users list table.
*
* @return array
*/
function wp_kama_users_list_table_query_args_filter( $args ){
// filter...
return $args;
}
- $args(массив)
- Аргументы, передаваемые классу WP_User_Query::prepare_query, который получает пользователей для текущей таблицы списка пользователей.
Примеры
#1 Изменяем сортировку в таблице
add_action( 'users_list_table_query_args', function ( $args ) {
// Сортировка по дате регистрации
$args['orderby'] = empty( $_REQUEST['orderby'] ) ? 'registered' : $_REQUEST['orderby'];
// DESC - список начинать с новых пользователей
$args['order'] = empty( $_REQUEST['order'] ) ? 'DESC' : $_REQUEST['order'];
return $args;
} );
Список изменений
| С версии 4.4.0 | Введена. |
Где вызывается хук
users_list_table_query_args
users_list_table_query_args
wp-admin/includes/class-wp-users-list-table.php 137
$args = apply_filters( 'users_list_table_query_args', $args );
wp-admin/includes/class-wp-ms-users-list-table.php 93
$args = apply_filters( 'users_list_table_query_args', $args );