get_post( int|WP_Post|null $post = null, string $output = OBJECT, string $filter = 'raw' )
Retourne les données d'un poste en passant l'id ou l'objet d'un poste.
Description
Le paramètre $post doit être donné en tant que variable depuis qu'il est passé par référence.
Paramètres
$post
(int | WP_Post | null) (Optionnel) Id ou objet du poste. Si laissé vide, la fonction s'appuiera sur la global $post.
Valeur par défaut : null
$output
(string) (Optionnel) Le type voulu de la sortie.
- OBJECT pour l'objet WP_Term
- ARRAY_A pour un tableau associatif
- ARRAY_N pour un tableau numéroté
Valeur par défaut : OBJECT
$filter
(string) (Optionnel) Type de filtre à appliquer. Accepte 'raw', 'edit', 'db', ou 'display'.
Valeur par défaut : 'raw'
Retourne
(WP_Post | array | null) Retourne le type correspondant à $output, null si le poste n'existe pas. Quand $output = OBJECT, retourne une instance de WP_Post.
Structure de la fonction get_post()
Définie dans le fichier wp-includes/post.php à la ligne 763 :
function get_post( $post = null, $output = OBJECT, $filter = 'raw' ) {
if ( empty( $post ) && isset( $GLOBALS['post'] ) ) {
$post = $GLOBALS['post'];
}
if ( $post instanceof WP_Post ) {
$_post = $post;
} elseif ( is_object( $post ) ) {
if ( empty( $post->filter ) ) {
$_post = sanitize_post( $post, 'raw' );
$_post = new WP_Post( $_post );
} elseif ( 'raw' === $post->filter ) {
$_post = new WP_Post( $post );
} else {
$_post = WP_Post::get_instance( $post->ID );
}
} else {
$_post = WP_Post::get_instance( $post );
}
if ( ! $_post ) {
return null;
}
$_post = $_post->filter( $filter );
if ( ARRAY_A == $output ) {
return $_post->to_array();
} elseif ( ARRAY_N == $output ) {
return array_values( $_post->to_array() );
}
return $_post;
}
Fonction utilisée par get_post()
sanitize_post()
Nettoie tous les champs d'un poste.
Où trouver la fonction get_post()
dans le CMS Wordpress
Exemple
Sources
Codex Wordpress : get_post()
Autres fonctions dans le même fichier : wp-includes/post.php