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/have posts

Descrizione

Questa funzione verifica che nella query corrente di WordPress vi sia qualche risultato fra cui ciclare. Si tratta di una funzione booleana, ossia restituisce TRUE o FALSE.

Come effetto collaterale, have_posts fa partire, attraversa o reimposta il loop. Alla fine del ciclo, have_posts restituisce 0 dopo aver chiamato rewind_posts.

Utilizzo

<?php have_posts(); ?>

Parametri

Questa funzione non accetta alcun parametro.

Valori restituiti

(boolean) 
True in caso di successo, false in caso di fallimento.

Esempi

Il seguente esempio può essere utilizzato per determinare se esistono degli articoli e nel caso ciclare fra di essi.

<?php
if ( have_posts() ) :
	while ( have_posts() ) : the_post();
		// Il codice del ciclo
	endwhile;
else :
	echo wpautop( 'Spiacente, nessun articolo trovato' );
endif;
?>

Note

Richiamando questa funzione all'interno del ciclo si causerà un ciclo infinito. Ad esempio si veda il seguente codice:

<?php
while ( have_posts() ): the_post();
        // Visualizza articolo
        if ( have_posts() ): // Se questo è l'ultimo articolo il ciclo ricomincia nuovamente
                // Eseguire qualche operazione se non si tratta dell'ultimo articolo
        endif;
endwhile;
?>

Se si desidera verificare se vi sono altri articoli nel ciclo corrente senza effetti collaterali utilizzare la seguente funzione.

function more_posts() {
  global $wp_query;
  return $wp_query->current_post + 1 < $wp_query->post_count;
}

Log delle modifiche

File sorgente

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