WordPress at Your Fingertips

get_metadata() WP 1.0

Retrieve metadata for the specified object.

If the meta field exists, a single value is returned if $single is true, or an array of values if it's false.

If the meta field does not exist, the result depends on get_metadata_default(). By default, an empty string is returned if $single is true, or an empty array if it's false.

1 time — 0.00013 sec (fast) | 50000 times — 1.0 sec (very fast)

No Hooks.

Return

Mixed. Single metadata value, or array of values. False if there's a problem with the parameters passed to the function.

Usage

get_metadata( $meta_type, $object_id, $meta_key, $single );
$meta_type(string) (required)
Type of object metadata is for. Accepts 'post', 'comment', 'term', 'user', or any other object type with an associated meta table.
$object_id(int) (required)
ID of the object metadata is for.
$meta_key(string)
Metadata key. If not specified, retrieve all metadata for the specified object.
Default: ''
$single(true|false)
If true, return only the first value of the specified meta_key. This parameter has no effect if meta_key is not specified.
Default: false

Notes

Changelog

Since 2.9.0 Introduced.

Code of get_metadata() WP 5.7.2

<?php
function get_metadata( $meta_type, $object_id, $meta_key = '', $single = false ) {
	$value = get_metadata_raw( $meta_type, $object_id, $meta_key, $single );
	if ( ! is_null( $value ) ) {
		return $value;
	}

	return get_metadata_default( $meta_type, $object_id, $meta_key, $single );
}

From tag: Metadatas (any)

No comments
    Log In