Aller au contenu principal
Version: Next

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éTypeDescription
idintID du post
titlestringTitre du post
slugstringSlug du post
contentstringContenu du post (si supporté)
excerptstringExtrait du post (si supporté)
datestringDate de publication
authorintID de l'auteur
featured_image_urlstringURL de l'image mise en avant
featured_imagestringBalise HTML de l'image mise en avant
linkstringPermalien du post
thumbnailstringURL de la miniature (rétro-compatibilité Twig)
fieldsarrayChamps personnalisés (après chargement)
taxonomiesarrayTaxonomies (après chargement)
wpWP_PostWP_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, objet Post, ID numérique, ou null pour utiliser le post global)
  • $isPage : Si true, é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.

info

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​

views/single/estate.html.twig
{% 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 %}

Voir aussi​