the_terms() | Fonctions Wordpress

Paramètres

$post_id

(int) (Requis) Id du poste.

$taxonomy

(string) (Requis) Nom de la taxonomie.

$before

(string) (Optionnel) Mots à mettre avant la liste des termes.

Valeur par défaut : ''

$sep

(string) (Optionnel) Mot à mettre entre chaque terme.

Valeur par défaut : ', '

$after

(string) (Optionnel) Mots à mettre après la liste des termes.

Valeur par défaut : ''

Retourne

(void | false) Affiche la liste si succès, false si échec.

Structure de la fonction `the_terms()`

Définie dans le fichier wp-includes/category-template.php à la ligne 1429 :

function the_terms( $post_id, $taxonomy, $before = '', $sep = ', ', $after = '' ) {
    $term_list = get_the_term_list( $post_id, $taxonomy, $before, $sep, $after );

    if ( is_wp_error( $term_list ) ) {
        return false;
    }

    /**
     * Filters the list of terms to display.
     *
     * @since 2.9.0
     *
     * @param string $term_list List of terms to display.
     * @param string $taxonomy  The taxonomy name.
     * @param string $before    String to use before the terms.
     * @param string $sep       String to use between the terms.
     * @param string $after     String to use after the terms.
     */
    echo apply_filters( 'the_terms', $term_list, $taxonomy, $before, $sep, $after );
}

Fonctions et Hook utilisés par `the_terms()`

get_the_term_list(): Retourne les termes d'un poste sous forme de liste au format spécifié.
the_terms: Filtre la liste de termes à afficher.
apply_filters(): Appel les fonctions qui ont été attaché à un filtre (hook).
is_wp_error(): Vérifie si la variable est une erreur WordPress.

Où trouver la fonction `the_terms()` dans le CMS Wordpress

Exemple

Obtenir les catégories d'un poste actuel :

the_terms( $post->ID, 'category', 'Categories : ', ' / ' );

// Affichera :
Categories : TV / Speaker / Monitor

Sources

Codex Wordpress : the_terms()

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

Retour