metadata_exists( string $meta_type, int $object_id, string $meta_key )

Paramètres

$meta_type

(string) (Requis) Type de l'objet. Accepte 'post', 'comment', 'term', 'user' ou tout autre type d'objet associé à une table de méta-donnée.

$object_id

(int) (Requis) Id de l'objet.

$meta_key

(string) (Requis) Clé de la méta-donnée.

Retourne

(bool) True si la méta-donnée existe.

Structure de la fonction metadata_exists()

Définie dans le fichier wp-includes/meta.php à la ligne 665 :

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

Fonctions et Hook utilisés par metadata_exists()

wp_cache_get()

Retourne les contenus du cache en donnant la clé et le groupe.

absint()

Convertit une valeur en entier positif (valeur absolue).

apply_filters()

Appel les fonctions qui ont été attaché à un filtre (hook).

update_meta_cache()

Met à jour le cache de la méta-donnée pour des objets spécifiés.

get_{$meta_type}_metadata

Court-circuite la valeur retournée de la méta-donnée.

Où trouver la fonction metadata_exists() dans le CMS Wordpress

Rechercher

Exemples

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

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

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

Sources

Codex Wordpress : metadata_exists()

Autres fonctions dans le même fichier : wp-includes/meta.php