# user_search_columns

URL: https://chugunov.pro/api-wordpress/filters/user_search_columns/
Проверено на WordPress 6.9, обновлено 06.08.2026.
Источник: независимый русскоязычный справочник chugunov.pro. Не является официальной документацией WordPress.

Тип: хук-фильтр.
Появился в версии: 3.6.0.

## Сигнатура

```php
apply_filters( 'user_search_columns', string[] $search_columns, string $search, WP_User_Query $query )
```

## Описание

Столбцы по умолчанию зависят от поискового запроса и включают ‘ID’, ‘user_login’, ‘user_email’, ‘user_url’, ‘user_nicename’ и ‘display_name’.

## Параметры

- `$search_columns` `string[]` — обязательный. Массив имён столбцов, по которым выполняется поиск.
- `$search` `string` — обязательный. Искомый текст.
- `$query` `WP_User_Query` — обязательный. Текущий экземпляр WP_User_Query.

## Фильтруемое значение

Массив имён столбцов, по которым выполняется поиск.

## Исходный код

Файл: `wp-includes/class-wp-user-query.php:741`

```php
$search_columns = apply_filters( 'user_search_columns', $search_columns, $search, $this );
```

## История изменений

- 3.6.0 — Introduced.

## Связанные

Используется в: `WP_User_Query::prepare_query`.

Оригинал в официальной документации: https://developer.wordpress.org/reference/hooks/user_search_columns/