More Information #More Information

Visualizza l’estratto del post corrente dopo avergli applicato diversi filtri, compresa la formattazione auto-p che trasforma le doppie interruzioni di riga in paragrafi HTML. Utilizza get_the_excerpt() per generare prima una versione ridotta dell’intero contenuto del post nel caso in cui non ci sia un estratto esplicito per il post.

La versione ridotta contiene un tag ‘more’ alla fine che per impostazione predefinita è il simbolo o “hellip”. Un estratto fornito dall’utente NON ha di default tale simbolo. Per aggiungerlo, devi modificare manualmente il grezzo $post->post_excerpt nel tuo template prima di chiamare the_excerpt(), aggiungere un filtro per ‘get_the_excerpt’ con una priorità inferiore a 10, o aggiungere un filtro per ‘wp_trim_excerpt’ (confrontando il primo e il secondo parametro, perché un estratto fornito dall’utente non viene modificato in alcun modo da questa funzione).

Vedi get_the_excerpt() per maggiori dettagli.

Un estratto generato automaticamente avrà anche tutti gli shortcode e i tag rimossi. Viene tagliato fino a un limite di parole e la lunghezza predefinita è di 55 parole. Per le lingue in cui le parole sono (o possono essere) descritte con caratteri singoli (cioè le lingue dell’Asia orientale) la parola-limite è effettivamente il carattere.

Nota: Se il post corrente è un allegato, come nei cicli dei template attachment.php e image.php, allora viene visualizzata la didascalia dell’allegato. Le didascalie non includono il testo “”.

Confronto con il quicktag <!-more-> #Confronto con il quicktag <!-more->

Gli estratti forniscono un’alternativa all’uso del quicktag <!–more–>. Mentre questo tag more richiede che l’autore di un post crei manualmente uno ‘split’ nel contenuto del post, che è poi usato per generare un link “read more” sulle pagine dell’indice, gli estratti richiedono, ma non necessariamente richiedono, che l’autore di un post fornisca un ‘teaser’ per il contenuto completo del post.

Il <!–more–> richiede che i template usino the_content() mentre l’uso degli estratti richiede, e permette, agli autori di template di scegliere esplicitamente se mostrare post completi (usando the_content()) o estratti (usando the_excerpt()).

La scelta se mostrare un post completo o un estratto può quindi essere basata su fattori come il template usato, il tipo di pagina, la categoria del post, eccetera. In altre parole, con un <!–more–> quicktag l’autore del post decide cosa succede, mentre l’autore del template ha il controllo sugli estratti. Inoltre, anche se <!–more–> può essere usato per creare un vero e proprio split usando il parametro $stripteaser, sarebbe difficile e complicato differenziare poi in base alle caratteristiche, facendo sì che questa diventi una scelta sostanzialmente a livello di sito.