W3cubDocs

/WordPress

get_post_custom( int $post_id )

Retrieve post meta fields, based on post ID.

Description

The post meta fields are retrieved from the cache where possible, so the function is optimized to be called more than once.

Parameters

$post_id: (int) (Optional) Post ID. Default is ID of the global $post.

Return

(array) Post meta for the given post.

More Information

Source

File: wp-includes/post.php

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

Uses	Description
wp-includes/functions.php: absint()	Convert a value to non-negative integer.
wp-includes/post-template.php: get_the_ID()	Retrieve the ID of the current item in the WordPress Loop.
wp-includes/post.php: get_post_meta()	Retrieves a post meta field for the given post ID.

Used By

Used By	Description
wp-includes/feed.php: rss_enclosure()	Display the rss enclosure for the current post.
wp-includes/feed.php: atom_enclosure()	Display the atom enclosure for the current post.
wp-includes/post-template.php: post_custom()	Retrieve post custom meta data field.
wp-includes/post.php: get_enclosed()	Retrieve enclosures already enclosed for a post.
wp-includes/post.php: get_post_custom_keys()	Retrieve meta field names for a post.
wp-includes/post.php: get_post_custom_values()	Retrieve values for a custom post field.
wp-includes/class-wp-xmlrpc-server.php: wp_xmlrpc_server::mw_getPost()	Retrieve post.

Changelog

Version	Description
1.2.0	Introduced.

© 2003–2019 WordPress Foundation
Licensed under the GNU GPLv2+ License.
https://developer.wordpress.org/reference/functions/get_post_custom