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.

Structure de la fonction get_term_meta()

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

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

Fonction utilisée par get_term_meta()

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ù trouver 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