get_term()

Définition : get_term() est une fonction WordPress destinée à récupérer un terme de taxonomie par identifiant ou objet. Selon le résultat, elle retourne un WP_Term, un tableau, null ou un objet WP_Error.

Terminologie

Appellation officielle : get_term()

Autres appellations : Récupérer un terme, Get Term

Comprendre le fonctionnement

Les taxonomies classent des contenus grâce à des termes. get_term() peut recevoir le nom de la taxonomie afin de contrôler le contexte et utilise les mécanismes de récupération et de filtrage du Core. Selon les paramètres, la représentation de sortie peut être un objet ou un tableau. Une taxonomie incorrecte peut entraîner le retour d’une erreur.

Le terme obtenu n’indique pas directement la liste de ses contenus associés : cette recherche relève d’autres API. Les noms et descriptions peuvent contenir des valeurs administrées ou importées et doivent être échappés à l’affichage. Un traitement robuste teste le type de résultat avant de lire les propriétés, notamment en présence de taxonomies personnalisées.

Exemple concret

Un annuaire WordPress affiche le nom de la catégorie qui regroupe plusieurs fiches techniques.

Exemple de code commenté

<?php
$term = get_term( 3, 'category' );
if ( $term instanceof WP_Term ) {
    echo esc_html( $term->name );
}

Point technique à retenir

Une taxonomie invalide peut produire WP_Error : ne pas supposer que toute réponse contient un terme valide.

Termes associés

WP_Term
Taxonomie
WP_Error