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

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.

Uses · 1

• get_post_custom()Retrieves post meta fields, based on post ID.

Source

View on Trac ↗View on GitHub ↗

1099function post_custom( $key = '' ) {1100	$custom = get_post_custom();1101 1102	if ( ! isset( $custom[ $key ] ) ) {1103		return false;1104	} elseif ( 1 === count( $custom[ $key ] ) ) {1105		return $custom[ $key ][0];1106	} else {1107		return $custom[ $key ];1108	}1109}

History

Introduced in 1.5.0. Unchanged from 6.7.7 through 7.1.0.

1. 6.7.7
2. 6.8.8
3. 6.9.7
4. 7.0.4
5. 7.1.0

Signature, return type and hooks compared across 5 parsed releases.

About this page

Parsed data

Generated from the wordpress-develop 6.7.7 tag, from src/wp-includes/post-template.php, and regenerated for each WordPress release so it tracks the code rather than a snapshot of it.

Corrections

Something wrong on this page? Report it and it gets fixed in the next regeneration.