get_post_custom_keys( int $post_id )
Retrieve meta field names for a post.
Description Description
If there are no meta fields, then nothing (null) will be returned.
Parameters Parameters
- $post_id
-
(int) (Optional) Post ID. Default is ID of the global $post.
Return Return
(array|void) Array of the keys, if retrieved.
Source Source
File: wp-includes/post.php
function get_post_custom_keys( $post_id = 0 ) {
$custom = get_post_custom( $post_id );
if ( ! is_array( $custom ) ) {
return;
}
$keys = array_keys( $custom );
if ( $keys ) {
return $keys;
}
}
Expand full source code Collapse full source code View on Trac
Changelog Changelog
| Version | Description |
|---|---|
| 1.2.0 | Introduced. |
User Contributed Notes User Contributed Notes
You must log in before being able to contribute a note or feedback.
Default Usage
The following example will set a variable (
$custom_field_keys) as an array containing the keys of all custom fields in the current post, and then print it. Note: the if test excludes values for WordPress internally maintained custom keys such as_edit_lastand_edit_lock.<?php $custom_field_keys = get_post_custom_keys(); foreach ( $custom_field_keys as $key => $value ) { $valuet = trim($value); if ( '_' == $valuet{0} ) continue; echo $key . " => " . $value . "<br />"; } ?>If the post contains custom fields with the keys
mykeyandyourkey, the output would be something like:Note: Regardless of how many values (custom fields) are assigned to one key, that key will only appear once in this array.