On this page
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
$keystring Optional-
Meta field key.
Default:
'' $post_idint 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;
}
Related
Uses
| Uses | Description |
|---|---|
| get_post_custom() wp-includes/post.php | Retrieves post meta fields, based on post ID. |
Used By
| Used By | Description |
|---|---|
| the_meta() wp-includes/post-template.php | Displays a list of post custom fields. |
Changelog
| Version | Description |
|---|---|
| 1.2.0 | Introduced. |
© 2003–2022 WordPress Foundation
Licensed under the GNU GPLv2+ License.
https://developer.wordpress.org/reference/functions/get_post_custom_values