WordPress.org

Ready to get started?Download WordPress

Codex

it:Riferimento funzioni/wp reset postdata

Contents

Descrizione

Utilizzare questa funzione per ripristinare la variabile globale $post del ciclo della query principale dopo un ciclo della query secondaria che usa una nuova WP_Query. Ripristina la variabile $post all'articolo corrente della query principale.

Le differenze tra il ciclo della query principale e i cicli delle query secondarie sono:

  • il ciclo principale si basa sulla richiesta nell'URL ed è elaborato prima che i template vengano caricati
  • i cicli secondari sono query (che usano una nuova WP_Query) nei file template di temi o plugin

Utilizzo

<?php wp_reset_postdata(); ?>

Parametri

Questa funzione non accetta alcun parametro.

Valori restituiti

Questa funzione non restituisce alcun valore.

Esempi

<?php
// argomenti di esempio
$args = array( 'posts_per_page' => 3 );

// la query
$the_query = new WP_Query( $args );
?>

<?php if ( $the_query->have_posts() ) : ?>

	<!-- inizio del ciclo -->
	<?php while ( $the_query->have_posts() ) : $the_query->the_post(); ?>
		<?php the_title(); ?>
		<?php the_excerpt(); ?>
	<?php endwhile; ?><!-- fine del ciclo -->

	<!-- inserire qui le funzioni di paginazione -->
	<?php wp_reset_postdata(); ?>

<?php else:  ?>

<p><?php _e( 'Spiacenti, nessun articolo risponde ai criteri indicati.' ); ?></p>

<?php endif; ?>

Note

  • Utilizza: $wp_query

Log delle modifiche

File sorgente

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