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 count posts

Descrizione

Questa funzione è stata introdotta in WordPress 2.5 e restituisce il numero di post per ogni stato. Si può anche usare wp_count_posts() come un template_tag con il secondo parametro e includere i post privati. Per impostazione predefinita, o se l'utente non ha effettuato il login o è un ospite del sito, i post privati non vengono inclusi nel conteggio.

Questa funzione restituisce un oggetto con gli stati dei post come proprietà. Bisogna verificare la presenza della proprietà utilizzando la funzione PHP isset(), se si desidera il valore per i post privati. Non tutti gli stati dei post fanno parte dell'oggetto.

Utilizzo

 <?php wp_count_posts$type$perm ); ?> 

Parametri

$type
(string) (opzionale) Tipo di post da conteggiare.
Default: 'post'
$perm
(string) (opzionale) Per includere i post privati leggibili dall'utente corrente, impostare 'readable'
Default: stringa vuota

Esempi

Utilizzo standard

L'utilizzo standard restituisce un conteggio dei post pubblicati. Si tratta di un oggetto, quindi si può usare var_dump() per stamparne il contenuto in fase di debug.

<?php
  $count_posts = wp_count_posts();
?>

Ottenere il conteggio dei post pubblicati

Per ottenere i post pubblicati, si deve chiamare la funzione wp_count_posts() e poi accedere alla proprietà 'publish'.

<?php
  $count_posts = wp_count_posts();

  $published_posts = $count_posts->publish;
?>

Se si sta sviluppando in PHP5, si può usare la forma abbreviata come indicato di seguito quando si desidera ottenere un solo stato. Questa modalità non funziona in PHP4 e quando si vuole mantenere retrocompatibilità, nel qual caso si deve usare il codice riportato sopra.

<?php
  $published_posts = wp_count_posts()->publish;
?>

Conteggio delle bozze

Il conteggio delle bozze è restituito dalla proprietà 'draft'.

<?php
  $count_posts = wp_count_posts();

  $draft_posts = $count_posts->draft;
?>

Conteggio delle pagine

Il conteggio delle pagine si effettua come quello per i post indicando 'page' come primo parametro.

<?php
  $count_pages = wp_count_posts('page');
?>

Altri usi

La funzione wp_count_posts() può essere utilizzata per trovare il numero di post per ogni stato per qualunque tipo di post, inclusi gli allegati o altri tipi che verranno aggiunti in futuro, sia da un plugin che come parte dello stesso WordPress.

File sorgente

wp_count_posts() si trova in wp-includes/post.php.

Correlati

Count Tags: wp_count_posts(), wp_count_terms(), wp_count_comments(), count_users()

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