is_tax( string|string[] $taxonomy = '', int|string|int[]|string[] $term = '' )

Détermine si la requête est pour une page d'archive d'une taxonomie personnalisée existante.

Paramètres

$taxonomy(string|string[])optionnel

Slug ou slugs de la taxanomie à comparer.

Valeur par défaut : ''

$term(int|string|int[]|string[])optionnel

Id, nom ou slug du terme ou tableau de ceux-ci à comparer.

Valeur par défaut : ''

Description / Informations supplémentaires

Si le paramètre $taxonomy est spécifié, la fonction vérifiera si la requête actuelle est pour la taxonomie spécifiée.

Si le paramètre $term est spécifié avec $taxonomy, la fonction vérifiera si la requête actuelle est pour le terme spécifié.

Retourne

(bool) True pour une page d'archive d'une taxonomie personnalisée, false pour une taxonomie native (archives d'étiquettes ou d'une catégorie).

Déclaration et structure de la fonction is_tax()

function is_tax( $taxonomy = '', $term = '' ) {
    global $wp_query;

    if ( ! isset( $wp_query ) ) {
        _doing_it_wrong( __FUNCTION__, __( 'Conditional query tags do not work before the query is run. Before then, they always return false.' ), '3.1.0' );
        return false;
    }

    return $wp_query->is_tax( $taxonomy, $term );
}
__()

Retourne la traduction d'un texte.

_doing_it_wrong()

Marque quelque chose comme étant appelé incorrectement.

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

Exemples

// Pour une page d'archive d'une taxonomie personnalisée en cours d'affichage
is_tax();

// Pour une page d'archive d'une taxonomie personnalisée appelée 'animaux' en cours d'affichage
is_tax( 'animaux' );

// Pour une page d'archive d'une taxonomie personnalisée appelée 'animaux' et dont le terme est 'Canidés' en cours d'affichage
s_tax( 'animaux', 'Canidés' );
Limiter le nombre de postes à afficher sur une page d'archive particulière :
add_action( 'pre_get_posts', function( $query) {
    if ( $query->is_tax( 'animaux' ) ) {
        $query->set( 'posts_per_page', 6 );
    }
} );

Sources

Codex WordPress : is_tax()

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

Retour