wp_count_terms( array|string $args = array() )

Compte combien de termes appartiennent à une taxonomie.

Paramètre

$args(array|string)optionnel

Tableau ou chaîne d'arguments.

Valeur par défaut : array()

Description / Informations supplémentaires

La valeur par défaut de $args est 'hide_empty' qui peut être 'hide_empty=true' ou array('hide_empty' => true).

Voir WP_Term_Query::__construct() pour plus d'information sur les arguments acceptés.

Retourne

(string|WP_Error) Une chaîne numérique contenant le nombre de termes dans cette taxonomie ou WP_Error si la taxonomie n'existe pas.

Déclaration et structure de la fonction wp_count_terms()

function wp_count_terms( $args = array(), $deprecated = '' ) {
    $use_legacy_args = false;

    // Check whether function is used with legacy signature: `$taxonomy` and `$args`.
    if ( $args
        && ( is_string( $args ) && taxonomy_exists( $args )
            || is_array( $args ) && wp_is_numeric_array( $args ) )
    ) {
        $use_legacy_args = true;
    }

    $defaults = array( 'hide_empty' => false );

    if ( $use_legacy_args ) {
        $defaults['taxonomy'] = $args;
        $args                 = $deprecated;
    }

    $args = wp_parse_args( $args, $defaults );

    // Backward compatibility.
    if ( isset( $args['ignore_empty'] ) ) {
        $args['hide_empty'] = $args['ignore_empty'];
        unset( $args['ignore_empty'] );
    }

    $args['fields'] = 'count';

    return get_terms( $args );
}
wp_is_numeric_array()

Détermine si la variable est un tableau numérique.

get_terms()

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

taxonomy_exists()

Détermine si un nom de taxonomie existe.

wp_parse_args()

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

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

Sources

Codex WordPress : wp_count_terms()

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

Retour