WP_Post

Définition : WP_Post est la classe du Core WordPress qui représente un contenu de type publication : article, page ou type personnalisé. Ses propriétés décrivent notamment son identifiant, son auteur, son état et son contenu.

Terminologie

Appellation officielle : WP_Post

Autres appellations : Objet publication WordPress, Objet post

Comprendre le fonctionnement

Un objet WP_Post regroupe les informations d’une entrée stockée dans la table des publications, notamment ID, post_type, post_status, post_title et post_content. WordPress utilise cette classe pour transmettre les données d’un contenu aux fonctions, thèmes et extensions. Ce modèle sert aussi aux pages et aux types personnalisés : le nom « post » ne signifie pas uniquement « article de blog ».

La classe fournit un objet de données ; elle ne gère pas à elle seule les permissions, la validation ou la mise à jour en base. Pour lire un contenu, get_post() est l’interface habituelle. Pour modifier un contenu, on utilise les fonctions de l’API des publications, après contrôle des capacités. Les champs récupérés doivent être échappés au moment de leur affichage.

Exemple concret

Un template récupère un article par identifiant, vérifie qu’il existe puis affiche son titre correctement échappé.

Exemple de code commenté

<?php
// Exemple dans un contexte où WordPress est chargé.
$publication = get_post( 42 );
if ( $publication instanceof WP_Post ) {
    echo '<h2>' . esc_html( $publication->post_title ) . '</h2>';
}