get_the_tags( int|WP_Post $post_id )

Description

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.

Paramètre

$post_id

(int | WP_Post) (Requis) Id ou objet du poste.

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.

Structure de la fonction get_the_tags()

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

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

    /**
     * Filters the array of tags for the given post.
     *
     * @since 2.3.0
     *
     * @see get_the_terms()
     *
     * @param WP_Term[] $terms An array of tags for the given post.
     */
    return apply_filters( 'get_the_tags', $terms );
}

Fonctions et Hook utilisés par get_the_tags()

get_the_terms()

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

get_the_tags

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

apply_filters()

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

Où trouver la fonction get_the_tags() dans le CMS Wordpress

Rechercher

Exemples

$posttags = get_the_tags();

if ( $posttags ) {
    foreach($posttags as $tag) {
        echo $tag->name . ' '; 
    }
}

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