post_custom() – Function | Developer.WordPress.org

post_custom( string $key = ” ): array|string|false

Retrieves post custom meta data field.

Parameters

$keystringoptional: Meta data key name.
Default:''

Return

array|string|false Array of values, or single value if only one element exists.
False if the key does not exist.

Source

function post_custom( $key = '' ) {
	$custom = get_post_custom();

	if ( ! isset( $custom[ $key ] ) ) {
		return false;
	} elseif ( 1 === count( $custom[ $key ] ) ) {
		return $custom[ $key ][0];
	} else {
		return $custom[ $key ];
	}
}

View all references View on Trac View on GitHub

Uses	Description
get_post_custom()`wp-includes/post.php`	Retrieves post meta fields, based on post ID.

Changelog

Version	Description
1.5.0	Introduced.

User Contributed Notes

You must log in before being able to contribute a note or feedback.