Post
Représente une publication d'un post type. Cette façade est automatiquement disponible dans les templates Twig via la variable globale post sur les pages de type single.
Propriétés disponibles
Chaque objet Post expose les propriétés suivantes :
| Propriété | Type | Description |
|---|---|---|
id | int | ID du post |
title | string | Titre du post |
slug | string | Slug du post |
content | string | Contenu du post (si supporté) |
excerpt | string | Extrait du post (si supporté) |
date | string | Date de publication |
author | int | ID de l'auteur |
featured_image_url | string | URL de l'image mise en avant |
featured_image | string | Balise HTML de l'image mise en avant |
link | string | Permalien du post |
thumbnail | string | URL de la miniature (rétro-compatibilité Twig) |
fields | array | Champs personnalisés (après chargement) |
taxonomies | array | Taxonomies (après chargement) |
wp | WP_Post | WP_Post d'origine |
Constructeur
$post = new Post(\WP_Post|Post|int|null $post = null, bool $isPage = false);
Paramètres :
$post: Le post à encapsuler (WP_Post, objetPost, ID numérique, ounullpour utiliser le post global)$isPage: Sitrue, évite de charger automatiquement le contenu (utile pour les pages)
Exemples :
// Utilise le post global $post = new Post(); // À partir d'un WP_Post $wpPost = get_post(42); $post = new Post($wpPost); // À partir d'un ID $post = new Post(42); // Pour une page (ne charge pas le content automatiquement) $page = new Post(42, isPage: true);
Méthodes
getField(string $field, mixed $default = false, ?int $postId = null)
Récupère la valeur d'un champ personnalisé.
Paramètres :
$field: Clé du champ$default: Valeur retournée si le champ est vide (défaut :false)$postId: ID du post cible — si omis, utilise le post courant
Exemple :
// Champ du post courant $price = $post->getField('price'); // Champ avec valeur par défaut $label = $post->getField('label', 'Sans titre'); // Champ d'un post spécifique $subtitle = $post->getField('subtitle', '', 42);
Dans Twig :
{{ post.getField('price') }} {{ post.getField('label', 'Sans titre') }}
getFields(?int $postId = null)
Récupère l'ensemble des champs personnalisés du post.
Paramètres :
$postId: ID du post cible — si omis, utilise le post courant
Retourne : array - Tableau associatif des champs
Exemple :
// Tous les champs du post courant $fields = $post->getFields(); // Tous les champs d'un post spécifique $fields = $post->getFields(42); // Accès à un champ spécifique $price = $fields['price'];
Dans Twig :
{% set fields = post.getFields() %} Prix : {{ fields.price }} Surface : {{ fields.surface }}
taxonomy(string $taxonomy): Taxonomy|null
Récupère une taxonomy liée au post.
Cette méthode remplace les anciennes méthodes get_term() et get_terms() depuis la version 26.0.10.0.
Paramètres :
$taxonomy: Le slug de la taxonomy à récupérer
Retourne : Taxonomy|null - L'objet Taxonomy ou null si non trouvé
Exemple :
// Récupère une taxonomy $category = $post->taxonomy('category'); if ($category) { echo $category->name; echo $category->slug; } // Récupère plusieurs taxonomies $post->chargeTax(['category', 'post_tag']); $tags = $post->taxonomies['post_tag'];
Dans Twig :
{% set category = post.taxonomy('category') %} {% if category %} Catégorie : {{ category.name }} {% endif %}
get_field(string $field, mixed $default = false, ?int $postId = null)
Alias de getField() pour avoir une syntaxe snake_case dans Twig.
get_fields(?int $postId = null)
Alias de getFields() pour avoir une syntaxe snake_case dans Twig.
update(array $data)
Met à jour le post avec les données fournies.
Paramètres :
$data: Tableau associatif des données à mettre à jour
Exemple :
$post->update([ 'post_title' => 'Nouveau titre', 'post_content' => 'Nouveau contenu', 'post_status' => 'publish' ]);
delete()
Supprime le post.
Exemple :
$post->delete();
Utilisation dans Twig
Variable globale post
Sur les templates de type single, la variable post est automatiquement disponible :
{# single.html.twig #} <article> <h1>{{ post.title }}</h1> <p class="meta"> Publié le {{ post.date }} par l'auteur {{ post.author }} </p> <div class="content"> {{ post.content|raw }} </div> {% if post.featured_image %} <div class="featured-image"> {{ post.featured_image|raw }} </div> {% endif %} </article>
Rétro-compatibilité avec l'ancienne variable page
Pour compatibilité avec les anciens templates utilisant la variable globale page, la propriété $thumbnail est disponible :
{# Ancienne syntaxe toujours supportée #} {% if page.thumbnail %} <img src="{{ page.thumbnail }}" alt="Miniature" /> {% endif %} {# Nouvelle syntaxe recommandée #} {% if post.featured_image_url %} <img src="{{ post.featured_image_url }}" alt="Miniature" /> {% endif %}
Exemples complets
Single avec taxonomies et champs
{% extends 'base.html.twig' %} {% block content %} <article class="estate-single"> <h1>{{ post.title }}</h1> <div class="estate-meta"> {% if post.taxonomies('category').get_terms() %} <span class="category"> {{ post.taxonomies('category').terms[0].name }} </span> {% endif %} </div> <div class="estate-details"> <dl> <dt>Prix</dt> <dd>{{ post.get_field('price') }}€</dd> </dl> </div> <div class="estate-content"> {{ post.content|raw }} </div> </article> {% endblock %}