# insert_user_meta

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

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

## Сигнатура

```php
apply_filters( 'insert_user_meta', array $meta, WP_User $user, bool $update, array $userdata )
```

## Описание

Не включает способы связи. Они добавляются с помощью wp_get_user_contact_methods( $user ).
Для произвольных полей метаданных см. фильтр 'insert_custom_user_meta'.

## Параметры

- `$meta` `array` — обязательный. Значения и ключи метаданных пользователя по умолчанию.
  
  nickname stringНикнейм пользователя. По умолчанию — имя пользователя (username).
  
  first_name stringИмя пользователя.
  
  last_name stringФамилия пользователя.
  
  description stringОписание пользователя.
  
  rich_editing stringВключать ли визуальный редактор для пользователя. Значение по умолчанию 'true'.
  
  syntax_highlighting stringВключать ли редактор кода с подсветкой синтаксиса для пользователя. Значение по умолчанию 'true'.
  
  comment_shortcuts stringВключать ли клавиатурные сочетания для пользователя. Значение по умолчанию 'false'.
  
  admin_color stringЦветовая схема для экрана администрирования пользователя. Значение по умолчанию 'modern'.
  
  use_ssl int|boolПринудительно ли использовать SSL в административной части для пользователя. 0|false, если SSL не принудителен.
  
  show_admin_bar_front stringПоказывать ли панель администрирования в публичной части сайта для пользователя.
  
  Значение по умолчанию 'true'.
  
  locale stringЛокаль пользователя. По умолчанию пусто.
- `$user` `WP_User` — обязательный. Объект пользователя.
- `$update` `bool` — обязательный. Обновляется ли пользователь, а не создаётся.
- `$userdata` `array` — обязательный. Необработанный массив данных, переданных в wp_insert_user() .

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

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

nickname stringНикнейм пользователя. По умолчанию — имя пользователя (username).

first_name stringИмя пользователя.

last_name stringФамилия пользователя.

description stringОписание пользователя.

rich_editing stringВключать ли визуальный редактор для пользователя. Значение по умолчанию 'true'.

syntax_highlighting stringВключать ли редактор кода с подсветкой синтаксиса для пользователя. Значение по умолчанию 'true'.

comment_shortcuts stringВключать ли клавиатурные сочетания для пользователя. Значение по умолчанию 'false'.

admin_color stringЦветовая схема для экрана администрирования пользователя. Значение по умолчанию 'modern'.

use_ssl int|boolПринудительно ли использовать SSL в административной части для пользователя. 0|false, если SSL не принудителен.

show_admin_bar_front stringПоказывать ли панель администрирования в публичной части сайта для пользователя.

Значение по умолчанию 'true'.

locale stringЛокаль пользователя. По умолчанию пусто.

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

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

```php
$meta = apply_filters( 'insert_user_meta', $meta, $user, $update, $userdata );
```

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

- 5.8.0 — The $userdata parameter was added.
- 4.4.0 — Introduced.

## Связанные

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

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