# wp_pre_insert_user_data

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

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

## Сигнатура

```php
apply_filters( 'wp_pre_insert_user_data', array $data, bool $update, int|null $user_id, array $userdata )
```

## Описание

Сюда входят только данные из таблицы users, но не метаданные пользователя.

## Параметры

- `$data` `array` — обязательный. Значения и ключи для пользователя.
  
  user_login stringЛогин пользователя. Включается только если $update == false
  
  user_pass stringПароль пользователя.
  
  user_email stringАдрес электронной почты пользователя.
  
  user_url stringURL пользователя.
  
  user_nicename stringКрасивое имя пользователя. По умолчанию — безопасная для URL версия логина пользователя.
  
  display_name stringОтображаемое имя пользователя.
  
  user_registered stringМетка времени MySQL, описывающая момент регистрации пользователя. По умолчанию — текущая метка времени UTC.
- `$update` `bool` — обязательный. Обновляется ли пользователь, а не создаётся.
- `$user_id` `int|null` — обязательный. ID обновляемого пользователя или NULL, если пользователь создаётся.
- `$userdata` `array` — обязательный. Необработанный массив данных, переданных в wp_insert_user() .

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

Значения и ключи для пользователя.

user_login stringЛогин пользователя. Включается только если $update == false

user_pass stringПароль пользователя.

user_email stringАдрес электронной почты пользователя.

user_url stringURL пользователя.

user_nicename stringКрасивое имя пользователя. По умолчанию — безопасная для URL версия логина пользователя.

display_name stringОтображаемое имя пользователя.

user_registered stringМетка времени MySQL, описывающая момент регистрации пользователя. По умолчанию — текущая метка времени UTC.

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

Файл: `wp-includes/user.php:2543`

```php
$data = apply_filters( 'wp_pre_insert_user_data', $data, $update, ( $update ? $user_id : null ), $userdata );
```

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

- 6.8.0 — The user’s password is now hashed using bcrypt by default instead of phpass.
- 5.8.0 — The $userdata parameter was added.
- 4.9.0 — Introduced.

## Связанные

Используется в: [`wp_insert_user`](https://chugunov.pro/api-wordpress/functions/wp_insert_user/).

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