get_tags() | Fonctions Wordpress

Paramètre

$args

(string | array) (Optionnel) Tableau d'arguments qui influeront sur la requête. Voir la fonction get_terms() pour voir la liste des arguments acceptés.

'taxonomy'
(string) Taxonomie des termes à recevoir.
Par défaut : 'post_tag'.

Valeur par défaut : ''

Retourne

(WP_Term | int | WP_Error) Un tableau d'objet de termes appartenant à la taxonomie donnée, un compte de ceux-ci ou l'objet WP_Error si la taxonomie n'existe pas.

Structure de la fonction `get_tags()`

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

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 get_terms()
         */
        $tags = apply_filters( 'get_tags', $tags, $args );
    }

    return $tags;
}

Fonctions et Hook utilisés par `get_tags()`

get_tags: Filtre le tableau d'objet de termes retournés pour la taxonomie 'post_tag'.
wp_parse_args(): Fusionne des arguments définis par l'utilisateur dans un tableau par défaut.
get_terms(): Retourne les termes pour une taxonomie donnée ou une liste de taxonomies.
apply_filters(): Appel les fonctions qui ont été attaché à un filtre (hook).

Où trouver la fonction `get_tags()` dans le CMS Wordpress

Exemple

$tags = get_tags(array(
  'taxonomy' => 'post_tag',
  'orderby' => 'name',
  'hide_empty' => false // for development
));

Sources

Codex Wordpress : get_tags()

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

Retour