WP_Term

Définition : WP_Term est la classe WordPress qui représente un terme appartenant à une taxonomie, comme une catégorie ou une étiquette. Elle regroupe ses propriétés et permet aux API de manipuler les données de classement.

Terminologie

Appellation officielle : WP_Term

Autres appellations : Objet terme, Term WordPress

Comprendre le fonctionnement

WordPress organise de nombreux contenus au moyen de taxonomies. Un WP_Term décrit notamment l’identifiant du terme, son nom, son slug, sa description et sa taxonomie. Une catégorie et une étiquette sont deux taxonomies distinctes : deux termes portant le même libellé ne sont pas forcément le même concept. Les extensions peuvent créer leurs propres taxonomies pour classer d’autres types de publication.

Le terme constitue un objet de classification, non le contenu lui-même. L’API get_term() permet de le récupérer et peut signaler une erreur, notamment lorsque la taxonomie passée est invalide. Avant d’afficher le nom ou la description d’un terme, il faut choisir l’échappement approprié au contexte HTML et ne pas supposer que tout appel réussit.

Exemple concret

Un glossaire thématique affiche le nom d’une catégorie provenant d’une taxonomie dédiée au plugin.

Exemple de code commenté

<?php
// Exemple avec une catégorie déjà existante.
$terme = get_term( 3, 'category' );
if ( $terme instanceof WP_Term ) {
    echo esc_html( $terme->name );
}