get_the_tags( int|WP_Post $post_id )
Retourne les étiquettes d'un poste.
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
Exemples
Sources
Codex Wordpress : get_the_tags()
Autres fonctions dans le même fichier : wp-includes/category-template.php