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 );