Lors de la création d’un filtrage de contenu personnalisé dans WordPress – pour les blogs, les catalogues de produits ou les annuaires de services – le paramètre tax_query dans WP_Query est l’un des outils les plus essentiels. Il permet aux développeurs d’extraire des articles, des pages ou des types d’articles personnalisés en fonction de termes de taxonomie spécifiques.

Que sont les taxonomies dans WordPress ?

Les taxonomies dans WordPress sont des moyens de regrouper le contenu. WordPress est livré avec deux taxonomies par défaut :

  • catégorie
  • article_tag

Mais les développeurs peuvent également créer des taxonomies personnalisées, telles que :

  • marque
  • région
  • type_de_produit
  • niveau de compétence

Chaque taxonomie contient des termes – par exemple, une taxonomie de région peut inclure des termes comme europe, asie ou us.

Qu’est-ce qu’une requête fiscale ?

Une requête fiscale est un tableau de conditions passées à WP_Query qui indique à WordPress de ne récupérer que le contenu correspondant à certains termes de la taxonomie.

Les cas d’utilisation incluent :

  • Afficher les articles de blog d’une catégorie spécifique.
  • Afficher les produits filtrés par attributs.
  • Création de filtres dynamiques pour la recherche ou les archives.

Exemple simple : Filtre par catégorie

$args = array(
  'post_type' => 'post',
  'tax_query' => array(
    array(
      'taxonomy' => 'category',
      'field' => 'slug',
      'terms' => 'news',
    ),
  ),
) ;
$query = new WP_Query($args) ;

Ceci renverra tous les articles de la catégorie “actualités”.

Opérateurs que vous pouvez utiliser

WordPress supporte plusieurs opérateurs dans les requêtes fiscales :

  • IN – correspond à n’importe quel terme (par défaut)
  • NOT IN – exclut ces termes
  • AND – doit correspondre à tous les termes
  • EXISTS / NOT EXISTS – vérifie si une taxonomie est définie ou non

Exemple avancé : Conditions multiples

Vous pouvez combiner plusieurs filtres de taxonomie :

$args = array(
  'post_type' => 'product',
  'tax_query' => array(
    'relation' => 'AND',
    array(
      'taxonomy' => 'product_type',
      'field' => 'slug',
      'terms' => 'hosting',
    ),
    array(
      'taxonomy' => 'region',
      'field' => 'slug',
      'terms' => array('europe', 'us'),
      'operator' => 'IN',
    ),
  ),
) ;

Cette méthode renvoie les produits de type hébergement disponibles en Europe ou aux États-Unis.

Utilisations pratiques

Quelques cas d’utilisation courante des requêtes fiscales dans des projets WordPress réels :

  • Un site immobilier filtrant les listes par type de propriété et par emplacement.
  • Un site d’offres d’emploi affichant les postes par département et par ancienneté.
  • Une boutique WooCommerce filtrant les produits par marque, couleur ou disponibilité.

Résumé

Le paramètre tax_query de WordPress permet aux développeurs de créer des affichages de contenu dynamiques et pertinents. Que vous créiez une grille de produits filtrés, une page de recherche ou une archive personnalisée, les requêtes fiscales vous permettent d’affiner le contenu affiché aux utilisateurs, en fonction de la configuration de la taxonomie que vous avez définie. Vous voulez aller plus loin ? Combinez les requêtes fiscales avec des méta-requêtes ou des paramètres de recherche pour un filtrage encore plus puissant.