# get_metadata_default()

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

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

## Сигнатура

```php
get_metadata_default( string $meta_type, int $object_id, string $meta_key, bool $single = false ): mixed
```

## Описание

По умолчанию возвращается пустая строка, если $single равно true, или пустой массив, если false.

## Параметры

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

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

`mixed` — $single $single

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

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

```php
function get_metadata_default( $meta_type, $object_id, $meta_key, $single = false ) {
	if ( $single ) {
		$value = '';
	} else {
		$value = array();
	}

	/**
	 * Filters the default metadata value for a specified meta key and object.
	 *
	 * The dynamic portion of the hook name, `$meta_type`, refers to the meta object type
	 * (blog, post, comment, term, user, or any other type with an associated meta table).
	 *
	 * Possible filter names include:
	 *
	 *  - `default_blog_metadata`
	 *  - `default_post_metadata`
	 *  - `default_comment_metadata`
	 *  - `default_term_metadata`
	 *  - `default_user_metadata`
	 *
	 * @since 5.5.0
	 *
	 * @param mixed  $value     The value to return, either a single metadata value or an array
	 *                          of values depending on the value of `$single`.
	 * @param int    $object_id ID of the object metadata is for.
	 * @param string $meta_key  Metadata key.
	 * @param bool   $single    Whether to return only the first value of the specified `$meta_key`.
	 * @param string $meta_type Type of object metadata is for. Accepts 'blog', 'post', 'comment', 'term',
	 *                          'user', or any other object type with an associated meta table.
	 */
	$value = apply_filters( "default_{$meta_type}_metadata", $value, $object_id, $meta_key, $single, $meta_type );

	if ( ! $single && ! wp_is_numeric_array( $value ) ) {
		$value = array( $value );
	}

	return $value;
}
```

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

- 5.5.0 — Introduced.

## Связанные

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

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