wp_get_post_tags( int $post_id, array $args = array() )

Retourne les étiquettes associées à un poste.

Paramètres

$post_id

(int) (Optionnel) Id du poste. Ne prend pas par défaut l'id de la global $post.

$args

(array) (Optionnel) Paramètre de la requête des étiquettes. Voir la fonction get_terms() pour les arguments supportés.

  • 'fields'
    (string) Champs de terme à recevoir. Par défaut : 'all'.

Valeur par défaut : array()

Retourne

(array | WP_Error) Tableau d'objets WP_Term si succès ou tableau vide si aucunes étiquettes n'est trouvées. WP_Error si la taxonomie 'post_tag' n'existe pas.

Structure de la fonction wp_get_post_tags()

Définie dans le fichier wp-includes/post.php à la ligne 3564 :

function wp_get_post_tags( $post_id = 0, $args = array() ) {
    return wp_get_post_terms( $post_id, 'post_tag', $args );
}

Fonction utilisée par wp_get_post_tags()

wp_get_post_terms()

Retourne les termes d'un poste.

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

Exemples

$t = wp_get_post_tags($post->ID);

$tag_ids = wp_get_post_tags( $post->ID, array( 'fields' => 'ids' ) );
Afficher une liste d'étiquettes en fonction d'un poste spécifique :
$tags = wp_get_post_tags($post->ID);
$html = '<div class="post_tags">';
foreach ( $tags as $tag ) {
$tag_link = get_tag_link( $tag->term_id );
 
$html .= "<a href='{$tag_link}' title='{$tag->name} Tag' class='{$tag->slug}'>";
$html .= "{$tag->name}</a> ";
}
$html .= '</div>';
echo $html;

Sources

Codex Wordpress : wp_get_post_tags()

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

Retour