get_the_tags( int|WP_Post $post_id )

Retourne les étiquettes d'un poste.

Paramètre

$post_id(int|WP_Post)requis

Id ou objet du poste.

Description / Informations supplémentaires

Cette fonction retourne un tableau d'objets, un par étiquette assignée au poste. Elle peut être utilisée à l'extérieur d'une boucle en passant l'id du poste.

Cette fonction n'affiche rien, il faut accéder aux objets pour agir ou afficher sur la variable voulue.

Retourne

(WP_Term[]|false|WP_Error) Tableau d'objets WP_Term, false si aucunes étiquettes n'est trouvées ou que le poste n'existe pas. WP_Error si échec.

Déclaration et structure de la fonction get_the_tags()

function get_the_tags( $post = 0 ) {
    $terms = get_the_terms( $post, 'post_tag' );

    /**
     * Filters the array of tags for the given post.
     *
     * @since 2.3.0
     *
     * @see get_the_terms()
     *
     * @param WP_Term[]|false|WP_Error $terms Array of WP_Term objects on success, false if there are no terms
     *                                        or the post does not exist, WP_Error on failure.
     */
    return apply_filters( 'get_the_tags', $terms );
}
get_the_terms()

Retourne les termes d'une taxonomie attachés à un poste.

apply_filters()

Appel les fonctions qui ont été attaché à un filtre (hook).

get_the_tags

Filtre le tableau d'étiquettes pour un poste donné.

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

Exemples

Afficher les noms des étiquettes appartenant à un poste :
$posttags = get_the_tags();

if ( $posttags ) {
    foreach($posttags as $tag) {
        echo $tag->name . ' '; 
    }
}
Afficher les liens des étiquettes d'un poste avec un séparateur personnalisé :
function show_tags(){
    $post_tags = get_the_tags();
    $separator = ' | ';
    if (!empty($post_tags)) {
        foreach ($post_tags as $tag) {
            $output .= '<a href="' . get_tag_link($tag->term_id) . '">' . $tag->name . '</a>' . $separator;
        }
        return trim($output, $separator);
    }
}

Sources

Codex WordPress : get_the_tags()

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

Retour