Funzione the_excerpt() in WordPress: implementazione e lunghezza

La funzione the_excerpt() in WordPress è comunemente utilizzata per mostrare un breve riassunto o estratto di un post. È particolarmente utile quando si desidera visualizzare una versione abbreviata del contenuto, ad esempio nelle pagine archivio o negli elenchi di articoli.

Implementazione predefinita

È sufficiente richiamare the_excerpt() all’interno del loop nel file del template, e WordPress genererà automaticamente un estratto per ogni post basandosi sul contenuto. Per impostazione predefinita, la lunghezza dell’estratto è limitata a 55 parole, ma può essere personalizzata tramite filtri.

<?php if(has_excerpt()) { ?>
    <div class="excerpt"><?php the_excerpt(); ?></div>
<?php } ?>

In alternativa, puoi usare la funzione get_the_excerpt():

<?php $excerpt = get_the_excerpt(); 
if ($excerpt) { ?>
    <div class="excerpt"><?php echo $excerpt; ?></div>
<?php } ?>

Lunghezza personalizzata dell’estratto

Per controllare la lunghezza dell’estratto visualizzato, puoi utilizzare il filtro excerpt_length. Ad esempio, aggiungendo il seguente codice al file functions.php del tuo tema, imposterai la lunghezza dell’estratto a 10 parole:

function custom_excerpt_length( $length ) {
    return 10;
}
add_filter( 'excerpt_length', 'custom_excerpt_length' );

Puoi anche utilizzare la funzione wp_trim_words():

$excerpt = wp_trim_words( get_the_excerpt(), 10, '...' );
echo $excerpt;

Questo frammento di codice visualizzerà un estratto limitato a un massimo di 10 parole.

Estratto del post tramite ID

Il codice seguente consente di visualizzare l’estratto di un post specifico tramite il suo ID, utilizzando la funzione has_excerpt():

<?php $post_id = 1;
if (has_excerpt( $post_id )) { ?>
    <div class="excerpt"><?php echo get_the_excerpt( $post_id ); ?></div>
<?php } ?>