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

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