get_post_custom_values( string $key = '', int $post_id ): array|null
Retrieves values for a custom post field.
Description
The parameters must not be considered optional. All of the post meta fields will be retrieved and only the meta field key values returned.
Parameters
-
$key
string Optional -
Meta field key.
Default:
''
-
$post_id
int Optional -
Post ID. Default is the ID of the global
$post
.
Return
array|null Meta field values.
Source
File: wp-includes/post.php
.
View all references
function get_post_custom_values( $key = '', $post_id = 0 ) {
if ( ! $key ) {
return null;
}
$custom = get_post_custom( $post_id );
return isset( $custom[ $key ] ) ? $custom[ $key ] : null;
}
Changelog
Version | Description |
---|---|
1.2.0 | Introduced. |
User Contributed Notes
You must log in before being able to contribute a note or feedback.
Default usage example.
Let’s assume the current post has 3 values associated with the (custom) field my_key.
You could show them through:
The above example will output: