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.

Description

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é.

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 : ''

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).

Structure de la fonction is_tax()

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

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 );
}

Fonctions utilisées par is_tax()

__()

Retourne la traduction d'un texte.

_doing_it_wrong()

Marque quelque chose comme étant incorrectement appelée.

Où trouver 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