Lingue: English – 関数リファレンス/get the excerpt 日本語 (Add your language)

Description

Ritorna l’estratto del post. Questo può essere sia un estratto fornito dall’utente, che viene restituito senza modifiche, sia una versione tagliata del contenuto completo del post generata automaticamente con il conteggio delle parole.

Gli estratti generati automaticamente hanno tutti gli shortcode e i tag rimossi, il che significa che è solo una stringa non formattata che non vedrà interruzioni di riga in nessuna forma di output, poiché anche le attuali interruzioni di riga nel testo grezzo vengono rimosse.

Quando chiamato attraverso the_excerpt() questo implica che gli estratti auto-gen sono solo testo grezzo con <p></p> tag avvolti intorno, fondamentalmente.

Gli estratti auto-gen hanno un tag “more” aggiunto ad essi. Questo tag è ” di default. Può essere cambiato attraverso il filtro excerpt_more.

La lunghezza predefinita delle parole è di 55 parole. Può essere cambiata attraverso il filtro excerpt_length.

Usage

<?php $excerpt = get_the_excerpt( int|WP_Post $post ) ?>

Questa funzione deve essere usata all’interno di The Loop quando non viene passato nessun parametro $post o ID.

Se questa funzione è usata fuori da The Loop e il post non ha un estratto personalizzato, questa funzione userà wp_trim_excerpt() per generare un estratto. Questa funzione usa get_the_content(), che deve essere usata con The Loop e causerà problemi se get_the_excerpt() viene usata al di fuori di The Loop. Per evitare i problemi, usa setup_postdata() prima di chiamare get_the_excerpt() per impostare l’oggetto globale $post.

Parametri

$post (intero|WP_Post) (opzionale) ID del post o oggetto WP_Post. Il default è globale $post. Default: null

Return Values

• Restituisce un estratto esistente invariato (per default) ma applica i filtri get_the_excerpt ad esso.
• Restituisce una versione tagliata del contenuto completo del post come descritto, applicando inoltre i filtri wp_trim_excerpt ad esso. ‘wp_trim_excerpt’ è concatenato da ‘get_the_excerpt’, il che significa che il tuo filtro get_the_excerpt sarà chiamato prima o dopo il trim a seconda della priorità del tuo filtro. Se chiamato prima, il tuo parametro $text sarà una stringa vuota se non c’è un estratto fornito dall’utente, mentre sarà la versione tagliata del post completo se chiamato dopo. In quest’ultimo caso potrebbe essere utile o più significativo usare ‘wp_trim_excerpt’ poiché ha un secondo parametro che ti dà l’input non tagliato alla funzione wp_trim_excerpt, il che significa che questo secondo parametro è semplicemente il grezzo $post->post_excerpt.
• Per le pagine protette da password restituisce una stringa, che ha un valore predefinito di “Non c’è alcun estratto perché questo è un post protetto”. Questo testo può essere cambiato nella definizione della funzione.

Esempi

get_the_excerpt() può essere usato per recuperare e memorizzare il valore in una variabile, senza mostrarlo alla pagina.

<?php$my_excerpt = get_the_excerpt();if ( '' != $my_excerpt ) {// Some string manipulation performed}echo $my_excerpt; // Outputs the processed value to the page?>

Utilizza get_the_excerpt() per stampare un estratto specificando un numero massimo di caratteri.

<?phpthe_excerpt_max_charlength(140);function the_excerpt_max_charlength($charlength) {$excerpt = get_the_excerpt();$charlength++;if ( mb_strlen( $excerpt ) > $charlength ) {$subex = mb_substr( $excerpt, 0, $charlength - 5 );$exwords = explode( ' ', $subex );$excut = - ( mb_strlen( $exwords ) );if ( $excut < 0 ) {echo mb_substr( $subex, 0, $excut );} else {echo $subex;}echo '';} else {echo $excerpt;}}?>

Log delle modifiche

Da: 0.71