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 post

Contents

Descrizione

Prende l'ID di un post e restituisce il record del database relativo a tale post. Si può specificare, per mezzo del parametro $output, come si desidera che i risultati vengano restituiti.

Utilizzo

<?php get_post$id$output$filter ); ?> 

Parametri

$id
(integer o object) (opzionale) L'ID del post che si desidera recuperare, oppure un oggetto che specifica il post. Per default viene recuperato il post corrente.
Default: null
$output
(string) (opzionale) Come si desidera il risultato.
  • OBJECT - (default) restituisce un oggetto WP_Post
  • ARRAY_A - restituisce un array associativo con i nomi dei campi come chiavi e i valori
  • ARRAY_N - restituisce un array numerico con i valori dei campi
Default: OBJECT
$filter
(string) (opzionale) Filtro. Si veda sanitize_post_field() per una lista completa di valori.
  • raw - (default)
Default: raw

Esempio

Ottenere il titolo di un post con ID 7:

<?php
$post_7 
get_post(7); 
$title $post_7->post_title;
?> 

Alternativamente, specificare il parametro $output:

<?php
$post_7 
get_post(7ARRAY_A);
$title $post_7['post_title'];
?> 

Valori restituiti

Restituisce un oggetto WP_Post oppure null in caso di fallimento.

I campi restituiti sono:

ID 
(integer) L'ID del post
post_author 
(integer) L'ID dell'autore del post
post_date 
(string) Data e ora del post (YYYY-MM-DD HH:MM:SS)
post_date_gmt 
(string) Data e ora GMT del post (YYYY-MM-DD HH:MM:SS)
post_content 
(string) Il contenuto del post
post_title 
(string) Il titolo del post
post_category 
(integer) L'ID della categoria del post. Si noti che questo sarà sempre 0 (zero) da WordPress 2.1 in avanti. Per determinare la categoria o le categorie di un post, si utilizzi get_the_category().
post_excerpt 
(string) Il riassunto del post
post_status 
(string) Lo stato del post (publish|pending|draft|private|static|object|attachment|inherit|future|trash)
comment_status 
(string) Lo stato dei commenti (open|closed|registered_only)
ping_status 
(string) Lo stato del pingback/trackback (open|closed)
post_password 
(string) La password del post
post_name 
(string) Lo slug del post
to_ping 
(string) URL di cui effettuare il ping
pinged 
(string) URL di cui è stato effettuato il ping
post_modified 
(string) Data e ora di ultima modifica del post (YYYY-MM-DD HH:MM:SS)
post_modified_gmt 
(string) Data e ora GMT di ultima modifica del post (YYYY-MM-DD HH:MM:SS)
post_content_filtered 
(string)
post_parent 
(integer) L'ID del post genitore (per allegati, ecc.)
guid 
(string) Un link al post. Nota: il valore di questo campo non deve essere considerato come il permalink al post (come invece accadeva prima della versione 2.5), e non ci si può neanche aspettare che sia un link valido. È puramente un identificatore univoco, per cui al momento si tratta di un link al post.
menu_order 
(integer)
post_type 
(string) (post|page|attachment)
post_mime_type 
(string) Tipo mime (per allegati, ecc.)
comment_count 
(integer) Numero di commenti

Note

Prima della versione 3.5, il primo parametro $post doveva essere una variabile. Ad esempio, get_post(7) avrebbe causato un errore fatale.

Log delle modifiche

  • Da 1.5.1
  • 3.5.0 - il parametro $post non è più passato per riferimento.

File sorgente

get_post() si trova in wp-includes/post.php e wp-includes/class-wp-atom-server.php.

Correlati

  • get_post_field() - Recupera i dati di un campo di un post basandosi sull'ID del post.
Si veda anche l'indice di Riferimento funzioni e l'indice di Tag dei template.
This article is marked as in need of editing. You can help Codex by editing it.