get_registered_metadata() — описание функции WordPress на русском

Сигнатура

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

Описание

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

Оригинал (английский)

The results include both meta that is registered specifically for the object’s subtype and meta that is registered for the entire object type.

Параметры

$object_type string обязательный

Тип объекта, к которому относятся метаданные. Принимает 'blog', 'post', 'comment', 'term', 'user' или любой другой тип объекта со связанной таблицей метаданных.

$object_id int обязательный

ID объекта, к которому относятся метаданные.

$meta_key string необязательный = ''

Зарегистрированный ключ метаданных. Если не указан, возвращаются все зарегистрированные метаданные для указанного объекта.

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

mixed

Исходный код

wp-includes/meta.php:1738

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.