WordPress.org

Ready to get started?Download WordPress

Codex

Attention Interested in functions, hooks, classes, or methods? Check out the new WordPress Code Reference!

it:Riferimento funzioni/get query var

Descrizione

Recupera la variabile di query pubblica nella classe WP_Query dell'oggetto globale $wp_query.

Utilizzo

<?php get_query_var$var ?>

Parametri

$var
(stringa) (richiesto) La chiave della variabile da restituire.
Default: Nessuno

Valori restituiti

(mixed) 
Restituisce una stringa vuota se la variabile non è impostata.

Esempi

Ottenere il numero corrente di paginazione


<?php  $paged = (get_query_var('paged')) ? get_query_var('paged') : 1;  ?>

<h1>Stai visitando la pagina <?php echo $paged; ?></h1>

Per ottenere il numero corrente di paginazione su una pagina principale statica (Page template) si deve usare la variabile di query 'page':

<?php  $paged = (get_query_var('page')) ? get_query_var('page') : 1;  ?>
<h1>Stai visitando la pagina <?php echo $paged; ?> su una pagina principale statica</h1>

Nota: La variabile di query 'page' contiene il numero di pagina di un singolo post paginato che include nel suo contenuto il quicktag <!--nextpage-->.

Note

get_query_var() recupera solo variabili di query pubbliche che sono riconosciute da WP_Query. Ciò significa che se si crea il proprio URL personalizzato con le proprie variabili di query, get_query_var() non le recupererà se non si effettua del lavoro ulteriore (si veda sotto).

Variabili di query personalizzate

Al fine di poter aggiungere e lavorare con le proprie variabili di query personalizzate che si appendono all'URL (es. "http://mysite.com/some_page/?my_var=foo" - per esempo usando add_query_arg()) è necessario aggiungerle alle variabili di query pubbliche disponibili a WP_Query. Queste sono costruite quando WP_Query viene istanziata, ma fortunatamente vengono passate attraverso un filtro 'query_vars' prima di essere effettivamente usate per popolare la proprietà $query_vars di WP_Query.

Per cui, per esporre la propria nuova variabile personalizzata a WP_Query bisogna agganciarsi al filtro 'query_vars', aggiungere la propria variabile all'array $vars che è passato dal filtro, e ricordarsi di restituire l'array come output della propria funzione filtro. Si veda il codice seguente:

function add_query_vars_filter( $vars ){
  $vars[] = "my_var";
  return $vars;
}
add_filter( 'query_vars', 'add_query_vars_filter' );

Note

  • Si veda WP_Query::get()
  • Utilizza l'oggetto globale (object) $wp_query

Log delle modifiche

Da: 1.5.0

File sorgente

get_query_var() si trova in wp-includes/query.php.

Correlati

Query Tags: WP_Query (Classe), get_query_var(), query_posts(), have posts(), the_post(), rewind_posts(), wp_reset_postdata(), wp_reset_query()

Si veda anche l'indice di Riferimento funzioni e l'indice di Tag dei template.