| CARVIEW |
Retrieves post meta fields, based on post ID.
The post meta fields are retrieved from the cache where possible, so the function is optimized to be called more than once.
$post_idintoptional$post.$post_id (non-numeric, zero, or negative value).See also get_post_custom_keys() and get_post_custom_values()
function get_post_custom( $post_id = 0 ) {
$post_id = absint( $post_id );
if ( ! $post_id ) {
$post_id = get_the_ID();
}
return get_post_meta( $post_id );
}
| Uses | Description |
|---|---|
get_the_ID()wp-includes/post-template.php | Retrieves the ID of the current item in the WordPress Loop. |
absint()wp-includes/load.php | Converts a value to non-negative integer. |
get_post_meta()wp-includes/post.php | Retrieves a post meta field for the given post ID. |
| Used by | Description |
|---|---|
rss_enclosure()wp-includes/feed.php | Displays the rss enclosure for the current post. |
atom_enclosure()wp-includes/feed.php | Displays the atom enclosure for the current post. |
post_custom()wp-includes/post-template.php | Retrieves post custom meta data field. |
get_enclosed()wp-includes/post.php | Retrieves enclosures already enclosed for a post. |
get_post_custom_keys()wp-includes/post.php | Retrieves meta field names for a post. |
get_post_custom_values()wp-includes/post.php | Retrieves values for a custom post field. |
wp_xmlrpc_server::mw_getPost()wp-includes/class-wp-xmlrpc-server.php | Retrieves a post. |
| Version | Description |
|---|---|
| 1.2.0 | Introduced. |
You must log in before being able to contribute a note or feedback.
Default Usage
Use the following example to set a variable ($custom_fields) as a multidimensional array containing all custom fields of the current post.
Retrieving data from the array
The following example will retrieve all custom field values with the key my_custom_field from post ID 72 (assuming there are three custom fields with this key, and the values are “dogs”, “47” and “This is another value”).
0 => dogs
1 => 47
2 => This is another value
Note: not only does the function return a multi-dimensional array (ie: always be prepared to deal with an array of arrays, even if expecting array of single values), but it also returns serialized values of any arrays stored as meta values. If you expect that possibly an array may be stored as a metavalue, then be prepared to maybe_unserialize.