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.

Contents

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.

Top ↑

Return

bool Whether a meta field with the given key exists.

Top ↑

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;
}

View on Trac View on GitHub

Top ↑

Hooks

Top ↑

Top ↑

Changelog

Changelog
Version Description
3.3.0 Introduced.

Top ↑

User Contributed Notes

  1. 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
    Contributed by vutuansw — 
    // Check and get a term meta

if ( metadata_exists( 'term', $term_id, '_meta_key' ) ) {
	$meta_value = get_term_meta( $term_id, '_meta_key', true );
}

// Check and get a post meta

if ( metadata_exists( 'post', $post_id, '_meta_key' ) ) {
	$meta_value = get_post_meta( $post_id, '_meta_key', true );
}

// Check and get a user meta

if ( metadata_exists( 'user', $user_id, '_meta_key' ) ) {
	$meta_value = get_user_meta( $user_id, '_meta_key', true );
}

You must log in before being able to contribute a note or feedback.