L’extrait WordPress via la fonction the_excerpt() est un bref résumé d’une publication de votre blog WordPress qui apparaît là où elle est appelée, généralement sur les pages d’archives (catégories, tag, pages d’auteur), les résultats de recherche et, dans certains cas, sur la page d’accueil de votre site, mais aussi dans le flux RSS et dans ce qui est parfois envoyé sur les réseaux sociaux via des extensions spécifiques.
Par défaut, WordPress utilise un maximum de 55 mots pour la longueur de l’extrait. Attention, certains thèmes permettent via la fonctionnalité « personnaliser » de définir cet extrait, mais d’autres ne le permettent pas et parfois on a tout de même besoin de personnaliser cela via un bout de code.
Fonction pour personnaliser la longueur de l’extrait via le nombre de mots
Pour augmenter ou diminuer la taille de cet extrait, voici une petit hack à ajouter au fichier functions.php de votre thème, ou via un plugin tel que Code Snippets.
function custom_excerpt_length( $length ) {
return 100; // Change this number to the desired excerpt length
}
add_filter( ‘excerpt_length’, ‘custom_excerpt_length’, 999 );
Dans ce snippet, nous définissons une nouvelle fonction appelée « custom_excerpt_length » qui appelle la fonction length de WordPress, qui définit la longueur de l’extrait d’un article ou d’une page WordPress, que nous réglons sur « 100 » mots par exemple, via l’instruction « return », après quoi nous ajoutons ce nouveau filtre avec le paramètre 999 pour s’assurer qu’il vient après tout autre filtre éventuel qui aurait une instruction contradictoire sur la fonction « length » de l’extrait.
Mais attention, pour que cela soit pris en compte côté thème, assurez-vous que votre thème appelle la fonction excerpt quelque part à l’endroit où vous souhaitez voir apparaître l’extrait de l’article dans votre boucle, via le code <?php echo get_excerpt(); ?>
Il existe par ailleurs une autre façon de personnaliser la longueur de l’extrait d’une publication WordPress, et qui se base sur le nombre de paragraphes.
Fonction pour personnaliser la longueur de l’extrait via le nombre de paragraphes
Cette fonction est particulièrement utile si vous souhaitez éviter de couper une phrase en plein milieu. Pour cela, copiez-collez ce bout de code dans votre fichiers « functions.php », ou bien via l’extension Code Snippets ou tout autre plugin permettant l’ajout de fonctions PHP dans votre installation WordPress :
add_filter( ‘wp_trim_excerpt’, ‘my_custom_excerpt’, 10, 2 );
function my_custom_excerpt($text, $raw_excerpt) {
if( ! $raw_excerpt ) {
$content = apply_filters( ‘the_content’, get_the_content() );
$text = substr( $content, 0, strpos( $content, ‘</p>’ ) + 4 );
}
return $text;
Avec la fonction wp_trim_excerpt, WordPress outrepasse la longueur de l’extrait en nombre de mots ou de caractères et considère le premier paragraphe comme étant l’extrait, et ça fonctionne même avec Elementor.