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

Retourne les étiquettes associées à un poste.

Paramètres

$post_id(int)optionnel

Id du poste. La valeur par défaut n'est pas l'id de la variable global $post.

Valeur par défaut : 0

$args(array)optionnel

Paramètres de requête des étiquettes à récupérer.

Voir WP_Term_Query::__construct() pour les arguments supportés.

Valeur par défaut : array()

Retourne

(array|WP_Error) Un tableau d'objets WP_Term en cas de réussite ou un tableau vide si aucune étiquette n'a été trouvée.

L'objet WP_Error si la taxonomie 'post_tag' n'existe pas.

Déclaration et structure de la fonction wp_get_post_tags()

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

Retourne les termes d'un poste.

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

Exemples

Pour récupérer toutes les étiquettes d'un poste :
$tags = wp_get_post_tags($post->ID);
Pour obtenir une liste contenant uniquement les ids d'étiquette pour un poste en particulier :
global $post;
$tag_ids = wp_get_post_tags( $post->ID, array( 'fields' => 'ids' ) );
Affiche une liste d'étiquette spécifiques à un article, en étendant celle-ci à partir d'un exemple de la fonction get_tags() :
$tags = wp_get_post_tags($post->ID); // ceci est un ajustement, le reste vient de l'exemple de la fonction get_tags()
$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