metadata_exists( string $meta_type, int $object_id, string $meta_key ): bool
Determines if a meta field with the given key exists for the given object ID.
Parameters
-
$meta_type
string Required -
Type of object metadata is for. Accepts
'post'
,'comment'
,'term'
,'user'
, or any other object type with an associated meta table. -
$object_id
int Required -
ID of the object metadata is for.
-
$meta_key
string Required -
Metadata key.
Return
bool Whether a meta field with the given key exists.
Source
File: wp-includes/meta.php
.
View all references
function metadata_exists( $meta_type, $object_id, $meta_key ) {
if ( ! $meta_type || ! is_numeric( $object_id ) ) {
return false;
}
$object_id = absint( $object_id );
if ( ! $object_id ) {
return false;
}
/** This filter is documented in wp-includes/meta.php */
$check = apply_filters( "get_{$meta_type}_metadata", null, $object_id, $meta_key, true, $meta_type );
if ( null !== $check ) {
return (bool) $check;
}
$meta_cache = wp_cache_get( $object_id, $meta_type . '_meta' );
if ( ! $meta_cache ) {
$meta_cache = update_meta_cache( $meta_type, array( $object_id ) );
$meta_cache = $meta_cache[ $object_id ];
}
if ( isset( $meta_cache[ $meta_key ] ) ) {
return true;
}
return false;
}
Hooks
-
apply_filters( "get_{$meta_type}_metadata",
mixed $value ,int $object_id ,string $meta_key ,bool $single ,string $meta_type ) -
Short-circuits the return value of a meta field.
Changelog
Version | Description |
---|---|
3.3.0 | Introduced. |
User Contributed Notes
-
Skip to note 1 content You must log in to vote on the helpfulness of this noteVote results for this note: 1You must log in to vote on the helpfulness of this note