функция
since 5.5.0
get_metadata_default()
Проверено на WordPress 6.9, обновлено Источник: WordPress Developer Resources.
Сигнатура
get_metadata_default( string $meta_type, int $object_id, string $meta_key, bool $single = false ): mixed
Описание
По умолчанию возвращается пустая строка, если $single равно true, или пустой массив, если false.
Оригинал (английский)
By default, an empty string is returned if $single is true, or an empty array if it’s 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
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. |

