the_content

Définition : the_content est un filtre WordPress appliqué au contenu d’une publication pendant certains traitements de rendu. Il permet d’enrichir ou de transformer ce contenu avant son affichage, sans modifier le texte enregistré en base.

Terminologie

Terme : the_content

Autres appellations : Filtre de contenu, Post Content Filter

À quoi cela sert

Le filtre reçoit une chaîne de contenu et doit renvoyer une chaîne exploitable. WordPress et les extensions y ajoutent souvent des transformations comme le traitement des blocs et des shortcodes. Le même filtre peut être sollicité dans plusieurs contextes.

Dans quel contexte l’utiliser

L’utiliser pour ajouter une information en bas d’un article ou adapter un contenu destiné au lecteur, en contrôlant le contexte principal. Pour modifier durablement un article, employer une API d’édition plutôt qu’un filtre d’affichage.

Exemple concret

Un site pédagogique ajoute un encadré de lecture à la fin des articles individuels, mais pas aux extraits ni aux boucles secondaires.

Exemple de code commenté

<?php
add_filter( 'the_content', function ( $content ) {
    if ( ! is_singular( 'post' ) || ! in_the_loop() || ! is_main_query() ) {
        return $content;
    }
    $note = esc_html( 'Article pédagogique ATOOLPHA.' );
    return $content . '<p class="atoolpha-note">' . $note . '</p>';
} );

Explication de l’exemple

Les conditions is_singular(), in_the_loop() et is_main_query() limitent le contexte. Le callback concatène une mention constante échappée, puis retourne le contenu complet à WordPress.

Précautions et limites

Un filtre de contenu peut affecter une réponse utilisée hors page publique. Ne pas le traiter comme un événement exécuté exactement une fois par visite.