get_term_meta( int $term_id, string $key = '', bool $single = false )

Retourne une méta-donnée pour un terme.

Paramètres

$term_id(int)requis

Id du terme.

$key(string)optionnel

Clé de la méta-donnée à retourner. Si laissé par défaut, retourne toutes les méta-données du terme.

Valeur par défaut : ''

$single(bool)optionnel

True pour retourner une valeur simple. Ce paramètre n'a aucun effet si $key n'est pas spécifiée.

Valeur par défaut : false

Retourne

(mixed) Un tableau si $single = false. La valeur simple de la méta-donnée si $single = true. False si l'id du terme est invalide.

Déclaration et structure de la fonction get_term_meta()

function get_term_meta( $term_id, $key = '', $single = false ) {
    return get_metadata( 'term', $term_id, $key, $single );
}
get_metadata()

Retourne la valeur d'un champ de méta-donnée pour un type d'objet et un id spécifiés.

Où est utilisée la fonction get_term_meta() dans le CMS WordPress

Exemples

$term_vals = get_term_meta($term_id);
foreach($term_vals as $key=>$val){
    echo $key . ' : ' . $val[0] . '<br>';
}
Usage sur une page d'archive :
$term_image = get_term_meta( get_queried_object_id(), '_myprefix_term_image', true);

Sources

Codex WordPress : get_term_meta()

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

Retour