Determines if a meta field with the given key exists for the given object ID.
Parameters
$meta_type
stringrequired- Type of object metadata is for. Accepts
'post'
,'comment'
,'term'
,'user'
, or any other object type with an associated meta table. $object_id
intrequired- ID of the object metadata is for.
$meta_key
stringrequired- Metadata key.
Source
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. |
Please note that as of 2024 this function no longer supports meta keys that start with an underscore.