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.

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'

Description / Informations supplémentaires

Le paramètre $post doit être donné en tant que variable depuis qu'il est passé par référence.

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.

Déclaration et structure de la fonction get_post()

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;
}
sanitize_post()

Nettoie tous les champs d'un poste.

Où est utilisée la fonction get_post() dans le CMS WordPress

Exemple

Obtenir le titre d'un poste avec son id :
$poste = get_post( 7 ); 
$title = $poste->post_title;

Sources

Codex WordPress : get_post()

Autres fonctions dans le même fichier : wp-includes/post.php

Retour