users_list_table_query_argsхук-фильтрWP 4.4.0

Фильтрует аргументы запроса, используемые для получения пользователей в таблице списка пользователей в админке.

Использование

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, который получает пользователей для текущей таблицы списка пользователей.

Примеры

0

#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 Введена.

Где вызывается хук

WP_Users_List_Table::prepare_items()
users_list_table_query_args
WP_MS_Users_List_Table::prepare_items()
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 );

Где используется хук в WordPress

Использование не найдено.