Query Variables

Définition : Query Variables désigne les paramètres que WordPress utilise pour comprendre la requête courante, comme un type de contenu, une pagination ou un identifiant. Elles relient l’interprétation des URL au moteur WP_Query.

Terminologie

Appellation officielle : Query Variables

Autres appellations : Variables de requête, Query Vars

Comprendre le fonctionnement

Lorsqu’une URL est analysée, ses segments et paramètres reconnus peuvent devenir des variables de requête. WordPress distingue les variables publiques admises dans l’URL et d’autres paramètres internes. Les règles de réécriture et le composant WP participent à cette transformation, avant que WP_Query interprète les critères nécessaires à la recherche des contenus.

Une extension peut ajouter une variable publique au moyen du filtre query_vars ou d’une fonction appropriée. Le simple fait qu’un nom soit reconnu ne signifie pas que sa valeur est fiable : les données de la requête restent à valider selon leur type et leur usage. get_query_var() lit une variable du contexte principal, tandis que la méthode WP_Query::get() lit celle d’une instance donnée.

Exemple concret

Une page utilise une variable « edition » pour identifier une sélection de contenus dans une URL personnalisée.

Exemple de code commenté

<?php
// Exemple de déclaration d’une variable de requête publique.
add_filter( 'query_vars', function ( $vars ) {
    $vars[] = 'edition';
    return $vars;
} );
// Sur la requête principale : $edition = get_query_var( 'edition' );