# get_registered_metadata()

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

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

## Сигнатура

```php
get_registered_metadata( string $object_type, int $object_id, string $meta_key = '' ): mixed
```

## Описание

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

## Параметры

- `$object_type` `string` — обязательный. Тип объекта, к которому относятся метаданные. Принимает 'blog', 'post', 'comment', 'term', 'user' или любой другой тип объекта со связанной таблицей метаданных.
- `$object_id` `int` — обязательный. ID объекта, к которому относятся метаданные.
- `$meta_key` `string` — необязательный, по умолчанию `''`. Зарегистрированный ключ метаданных. Если не указан, возвращаются все зарегистрированные метаданные для указанного объекта.

## Возвращаемое значение

`mixed`

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

Файл: `wp-includes/meta.php:1738`

```php
function get_registered_metadata( $object_type, $object_id, $meta_key = '' ) {
	$object_subtype = get_object_subtype( $object_type, $object_id );

	if ( ! empty( $meta_key ) ) {
		if ( ! empty( $object_subtype ) && ! registered_meta_key_exists( $object_type, $meta_key, $object_subtype ) ) {
			$object_subtype = '';
		}

		if ( ! registered_meta_key_exists( $object_type, $meta_key, $object_subtype ) ) {
			return false;
		}

		$meta_keys     = get_registered_meta_keys( $object_type, $object_subtype );
		$meta_key_data = $meta_keys[ $meta_key ];

		$data = get_metadata( $object_type, $object_id, $meta_key, $meta_key_data['single'] );

		return $data;
	}

	$data = get_metadata( $object_type, $object_id );
	if ( ! $data ) {
		return array();
	}

	$meta_keys = get_registered_meta_keys( $object_type );
	if ( ! empty( $object_subtype ) ) {
		$meta_keys = array_merge( $meta_keys, get_registered_meta_keys( $object_type, $object_subtype ) );
	}

	return array_intersect_key( $data, $meta_keys );
}
```

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

- 4.6.0 — Introduced.

## Связанные

Использует: [`get_object_subtype`](https://chugunov.pro/api-wordpress/functions/get_object_subtype/), [`registered_meta_key_exists`](https://chugunov.pro/api-wordpress/functions/registered_meta_key_exists/), [`get_registered_meta_keys`](https://chugunov.pro/api-wordpress/functions/get_registered_meta_keys/), [`get_metadata`](https://chugunov.pro/api-wordpress/functions/get_metadata/).

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