Extrait

Sur une page d’archive, afficher le texte intégral de chaque article rendrait la lecture interminable. La plupart des thèmes préfèrent donc n’afficher qu’un aperçu de quelques phrases, accrocheur, qui donne envie de cliquer pour lire la suite.

Génération automatique ou saisie manuelle

Cette valeur est stockée dans la colonne post_excerpt de la table wp_posts. Si l’auteur ne remplit pas ce champ, WordPress en génère un automatiquement à l’affichage grâce à wp_trim_excerpt(), qui tronque le contenu à 55 mots par défaut : un nombre ajustable via le filtre excerpt_length, et un texte de fin (« […] » par défaut) modifiable avec le filtre excerpt_more.

Côté template, on l’affiche avec la fonction the_excerpt(), à ne surtout pas confondre avec la balise

insérée manuellement dans le corps d’un article, qui définit un point de coupure différent utilisé notamment par the_content().

Exemple

<?php
add_filter( 'excerpt_length', function () {
    return 30;
} );
add_filter( 'excerpt_more', function () {
    return '…';
} );

Bon à savoir

• Un type de contenu personnalisé n’affiche ce champ dans l’écran d’édition que si 'excerpt' figure dans son tableau supports.
• De nombreuses extensions de référencement reprennent cette valeur comme méta-description par défaut lorsqu’aucune n’a été saisie explicitement.
• Contrairement au contenu principal, l’extrait n’accepte pas les blocs Gutenberg : c’est un champ de texte brut, sans mise en forme HTML.
• Un flux RSS généré par WordPress peut afficher soit l’extrait, soit le contenu intégral, selon le réglage choisi dans Réglages > Lecture, indépendamment de ce que le thème affiche côté web.