get_tags( string|array $args = '' )

Retourne toutes les étiquettes des postes.

Paramètre

$args(string|array)optionnel

Arguments de requête des étiquettes à récupérer.

Par défaut, l'argument 'taxonomy' passé via $args vaut 'post_tag'.

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

Valeur par défaut : ''

Retourne

(WP_Term[]|int|WP_Error) Un tableau d'objets WP_Term ou leur nombre.

L'objet WP_Error si l'une des taxonomies n'existe pas.

Déclaration et structure de la fonction get_tags()

function get_tags( $args = '' ) {
    $defaults = array( 'taxonomy' => 'post_tag' );
    $args     = wp_parse_args( $args, $defaults );

    $tags = get_terms( $args );

    if ( empty( $tags ) ) {
        $tags = array();
    } else {
        /**
         * Filters the array of term objects returned for the 'post_tag' taxonomy.
         *
         * @since 2.3.0
         *
         * @param WP_Term[]|int|WP_Error $tags Array of 'post_tag' term objects, a count thereof,
         *                                     or WP_Error if any of the taxonomies do not exist.
         * @param array                  $args An array of arguments. See {@see get_terms()}.
         */
        $tags = apply_filters( 'get_tags', $tags, $args );
    }

    return $tags;
}
get_terms()

Retourne les termes pour une taxonomie donnée ou une liste de taxonomies.

wp_parse_args()

Fusionne des arguments définis par l'utilisateur dans un tableau par défaut.

apply_filters()

Appel les fonctions qui ont été attachées à un filtre spécifique.

get_tags

Filtre le tableau d’objets WP_Term renvoyés pour les taxonomies données.

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

Exemples

Affiche une liste d'étiquettes avec des liens vers chacune d'elles et une classe spécifique pour chaque étiquette :
$tags = 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;
Récupérer une liste de noms d'étiquette par ordre alphabétique :
$tags = get_tags(array(
    'taxonomy' => 'post_tag',
    'orderby' => 'name',
    'hide_empty' => false
));

Sources

Codex WordPress : get_tags()

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

Retour