get_post()

Définition : get_post() est une fonction WordPress qui récupère les données d’une publication à partir de son identifiant ou de son objet. Elle renvoie généralement un WP_Post, un tableau ou null selon les paramètres.

Terminologie

Appellation officielle : get_post()

Autres appellations : Récupération de publication, Get Post

Comprendre le fonctionnement

La fonction accepte un identifiant, un objet de publication ou, selon le contexte, utilise le contenu courant. Le paramètre de sortie autorise un objet ou différentes représentations en tableau. Les données obtenues décrivent le contenu stocké ; la fonction ne réalise pas une recherche de plusieurs publications avec des critères complexes.

get_post() peut renvoyer null lorsqu’aucune publication ne correspond. Pour un affichage, le code doit vérifier le résultat et échapper les valeurs. Pour limiter l’accès à des contenus privés, un contrôleur ou un plugin doit également effectuer les vérifications de visibilité ou de capacité adaptées. La fonction ne remplace pas ces contrôles.

Exemple concret

Un bloc personnalisé charge le titre d’un article donné pour présenter une référence documentaire.

Exemple de code commenté

<?php
$post = get_post( 42 );
if ( $post instanceof WP_Post && 'publish' === $post->post_status ) {
    echo esc_html( $post->post_title );
}

Point technique à retenir

Un objet récupéré n’est pas nécessairement un contenu public ni un contenu autorisé pour le visiteur courant.

Termes associés

WP_Post
WP_Query
post_type