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/wp reset query

Contents

Descrizione

wp_reset_query() ripristina $wp_query e i dati globali del post allo stato della query principale originale. Questa funzione deve essere chiamata dopo query_posts(), se si deve usare tale funzione. Come indicato negli esempi più sotto, è fortemente incoraggiato usare il filtro pre_get_posts per alterare i parametri della query prima che questa venga creata.


Utilizzo

<?php wp_reset_query(); ?>

Parametri

Questa funzione non accetta alcun parametro.

Valori restituiti

Questa funzione non restituisce alcun valore.

Esempi

L'esempio seguente mostra come utilizzare wp_reset_query() dopo un ciclo personalizzato. Si noti che il ciclo nell'esempio viene probabilmente usato in aggiunta a quello prinipale.

<?php

$args = array ( 'post_parent' => 5 );
$custom_query = new WP_Query( $args );

if ( $custom_query->have_posts() ):
    while ( $custom_query->have_posts() ) :
        $custom_query->the_post();

        // Fare qualcosa con il contenuto del post.
        the_title();
        the_permalink(); // ecc.

    endwhile;
else:
    // Inserire del contenuto o caricare un template se non viene trovato alcun posts.
endif;

wp_reset_query();

?>

query_posts() modifica la query principale e non è raccomandato. Da usare solo se è assolutamente necessario (si veda query_posts: Avvertenze). Creare una nuova istanza di WP_Query o get_posts() è preferibile per i cicli secondari. Se si desidera modificare la query principale, usare l'azione pre_get_posts. Assicurarsi di mettere il proprio filtro pre_get_posts nel file functions.php.

<?php
query_posts( 'post_parent=5' );
if ( have_posts() ) :
	while ( have_posts() ) : the_post();
		?><a href="<?php the_permalink() ?>"><?php the_title() ?></a><br /><?php
	endwhile;
endif;
wp_reset_query();
?>

Log delle modifiche

File sorgente

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