get_the_excerpt()

Définition : get_the_excerpt() récupère un extrait textuel de publication, rédigé manuellement ou généré selon le contenu disponible. Elle permet de préparer des résumés de cartes et de listes éditoriales.

Comprendre et utiliser

À quoi sert ce terme ?

Elle aide à présenter des contenus sous une forme concise sans afficher tout l’article. Une page de ressources peut ainsi offrir une introduction à plusieurs fiches, chacune accompagnée d’un lien de lecture.

Fonctionnement technique

La fonction utilise les mécanismes d’extrait de WordPress et peut appliquer des filtres. Le résultat n’est pas équivalent à une simple découpe des premiers caractères du texte HTML et sa longueur peut varier.

Dans quels contextes l’utiliser ?

Utiliser pour des archives, recommandations d’articles et widgets de contenu. Prévoir que certains articles ont un extrait vide ou très court ; ne pas supposer un nombre exact de mots.

Cas concret : ATOOLPHA

Afficher dans le portail ATOOLPHA un extrait de la dernière publication, en limitant seulement la longueur visuelle par CSS si l’interface l’exige.

Exemple de code commenté

Extrait PHP destiné à un plugin ou à un template WordPress, dans le contexte indiqué ; pas au contenu HTML de l’article.

<?php
$post = get_post( 123 );
if ( $post instanceof WP_Post ) {
    $excerpt = get_the_excerpt( $post );
    if ( '' !== trim( $excerpt ) ) {
        echo '<p>' . esc_html( wp_strip_all_tags( $excerpt ) ) . '</p>';
    }
}

Décryptage de l’exemple

Le résultat est traité comme un résumé textuel : wp_strip_all_tags() retire les balises et esc_html() protège la sortie. Ce choix volontaire ne préserve pas les liens ou mises en forme intégrés à l’extrait.

Résultat attendu

Un paragraphe de résumé s’affiche lorsque WordPress retourne un extrait non vide ; un article sans extrait exploitable ne crée pas de bloc inutile.

Exercice pratique et vérification

Comparer un article avec extrait manuel et un article sans extrait. Observer les valeurs obtenues, leur rendu texte et leur effet dans une grille responsive.

Précautions et limites

Les filtres d’extrait et les contenus complexes peuvent produire des différences ; conserver un résumé éditorial maîtrisé lorsqu’une précision documentaire est requise.

À ne pas confondre

get_the_excerpt() produit l’extrait ; get_the_content() récupère le contenu principal brut, dont le traitement est différent.

Diagnostic avancé

Si un extrait contient un shortcode inattendu ou un texte coupé, inspecter les filtres appliqués et l’éventuel extrait manuel avant de modifier la requête.

Choix d’architecture et déploiement

Un extrait est une promesse éditoriale : il doit aider le lecteur à décider de consulter l’article, pas simplement le remplir. Les filtres et résumés automatiques peuvent modifier sa longueur ; vérifier le sens du texte lors des changements de thème ou de plugin.