# register_rest_field()

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

Тип: функция.
Появился в версии: 4.7.0.

## Сигнатура

```php
register_rest_field( string|array $object_type, string $attribute, array $args = array() )
```

## Описание

Регистрирует новое поле для существующего типа объекта WordPress.

## Параметры

- `$object_type` `string|array` — обязательный. Объект(ы), для которых регистрируется поле: "post"|"term"|"comment" и т. д.
- `$attribute` `string` — обязательный. Имя атрибута.
- `$args` `array` — необязательный, по умолчанию `array()`. Массив аргументов, используемых для обработки зарегистрированного поля.
  
  get_callback callable|nullНеобязательный. Функция обратного вызова для получения значения поля. Значение по умолчанию — 'null', поле не будет возвращено в ответе. Функции будут переданы подготовленные данные объекта.
  
  update_callback callable|nullНеобязательный. Функция обратного вызова для установки и обновления значения поля. Значение по умолчанию — 'null', значение нельзя установить или обновить. Функции будет передан объект модели, например WP_Post.
  
  schema array|nullНеобязательный. Схема для этого поля.
  
  Значение по умолчанию — 'null', запись схемы не будет возвращена.

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

Файл: `wp-includes/rest-api.php:182`

```php
function register_rest_field( $object_type, $attribute, $args = array() ) {
	global $wp_rest_additional_fields;

	$defaults = array(
		'get_callback'    => null,
		'update_callback' => null,
		'schema'          => null,
	);

	$args = wp_parse_args( $args, $defaults );

	$object_types = (array) $object_type;

	foreach ( $object_types as $object_type ) {
		$wp_rest_additional_fields[ $object_type ][ $attribute ] = $args;
	}
}
```

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

- 4.7.0 — Introduced.

## Связанные

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

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