Consentire HTML nell'excerpt

GUIDA COMPLETA AGLI EXCERPT

Recentemente ho risposto ad alcune domande riguardanti gli excerpt, quindi fornirò una spiegazione dettagliata che copra il più possibile.

PREFAZIONE

Sembrano esserci un paio di domande su dove dovrebbe andare il codice, e la risposta è che dipende davvero da te e da come ritieni opportuno. Ci sono un paio di opzioni su dove inserire il codice (se non esplicitamente indicato):

• Nel file functions.php del tuo tema o in qualsiasi file utilizzato come file di funzioni. Ricorda solo che quando fai questo, se il tema non è tuo, tutte le modifiche andranno perse quando aggiornerai il tema

• Un modo migliore sarebbe utilizzare il codice in un child theme. Come sopra, nel file functions.php o in un file correlato alle funzioni

• Usare il codice in un plugin. Questo è il metodo preferito poiché rende il codice disponibile per tutti i temi. Se cambi tema, non devi preoccuparti di riscrivere lo stesso codice.

Spero che questo chiarisca un po' le cose :-)

TAG/FORMATTAZIONE HTML

the_excerpt() innanzitutto non accetta alcun parametro, quindi non gli può essere passato nulla. È un fatto che the_excerpt() taglia il contenuto a 55 parole, e tutti i tag HTML vengono rimossi prima di restituire il testo. the_excerpt() si trova in wp-includes/post-template.php. Per consentire determinati o tutti i tag HTML nell'excerpt, deve essere creato un nuovo excerpt.

Prima di tutto, la funzione originale deve essere rimossa, e poi la nuova funzione deve essere agganciata a get_the_excerpt. Nota bene, questo nuovo excerpt sarà ancora richiamabile come the_excerpt() nei file template, non c'è bisogno di cambiarlo. get_the_excerpt() si trova in wp-includes/post-template.php.

L'excerpt utilizza wp_trim_excerpt per restituire il testo tagliato, quindi dobbiamo prima rimuovere wp_trim_excerpt dal filtro dell'excerpt. wp_trim_excerpt() si trova in wp-includes/formatting.php, riga 2355. Ecco come:

remove_filter('get_the_excerpt', 'wp_trim_excerpt');

Ora puoi aggiungere il tuo nuovo excerpt a get_the_excerpt

add_filter('get_the_excerpt', 'wpse_custom_wp_trim_excerpt');

Per consentire tag HTML/formattazione, dovremo specificare quali tag vuoi permettere. Puoi usare la seguente istruzione strip_tags per ottenere ciò

$wpse_excerpt = strip_tags($wpse_excerpt, wpse_allowedtags());

Il secondo argomento wpse_allowedtags() è una piccola funzione che viene utilizzata per aggiungere i tag che the_excerpt() permetterà. Per una lista completa dei tag HTML 5 validi, vai a controllare qui. Ecco la funzione, aggiungi qualsiasi tag HTML a questa che hai bisogno di permettere/mantenere

function wpse_allowedtags() {
// Aggiungi tag personalizzati a questa stringa
    return '<script>,<style>,<br>,<em>,<i>,<ul>,<ol>,<li>,<a>,<p>,<img>,<video>,<audio>'; 
}

Se hai bisogno di permettere tutti i tag HTML, cioè nessuna rimozione di alcun tag, la funzione strips_tags() può essere omessa/rimossa completamente.

Un punto da notare tuttavia, quando i tag html sono permessi, questi tag vengono contati come parole, quindi il conteggio delle parole per excerpt con tag e senza tag non sarà lo stesso. Per correggere questo, dovrai prima rimuovere questi tag dal conteggio effettivo delle parole in modo che solo le parole siano contate.

Ho scritto un excerpt che permetterà tutti i tag, conterà solo le parole come parole, completerà una frase dopo il numero impostato di parole (in modo che il testo non venga tagliato a metà frase) e aggiungerà un testo "leggi tutto" dopo l'ultima parola.

Ecco il codice completo

function wpse_allowedtags()
{
  // Aggiungi tag personalizzati a questa stringa
  return '<script>,<style>,<br>,<em>,<i>,<ul>,<ol>,<li>,<a>,<p>,<img>,<video>,<audio>';
}

if (!function_exists('wpse_custom_wp_trim_excerpt')) :

  function wpse_custom_wp_trim_excerpt($wpse_excerpt)
  {
    $raw_excerpt = $wpse_excerpt;
    if ('' == $wpse_excerpt) {

      $wpse_excerpt = get_the_content('');
      $wpse_excerpt = strip_shortcodes($wpse_excerpt);
      $wpse_excerpt = apply_filters('the_content', $wpse_excerpt);
      $wpse_excerpt = str_replace(']]>', ']]&gt;', $wpse_excerpt);
      $wpse_excerpt = strip_tags($wpse_excerpt, wpse_allowedtags()); /*SE hai bisogno di permettere solo alcuni tag. Elimina se tutti i tag sono permessi */

      //Imposta il conteggio delle parole dell'excerpt e interrompi solo dopo che la frase è completa.
      $excerpt_word_count = 75;
      $excerpt_length = apply_filters('excerpt_length', $excerpt_word_count);
      $tokens = array();
      $excerptOutput = '';
      $count = 0;

      // Divide la stringa in token; tag HTML, o parole, seguite da qualsiasi spazio bianco
      preg_match_all('/(<[^>]+>|[^<>\s]+)\s*/u', $wpse_excerpt, $tokens);

      foreach ($tokens[0] as $token) {

        if ($count >= $excerpt_length && preg_match('/[\,\;\?\.\!]\s*$/uS', $token)) {
          // Limite raggiunto, continua finché , ; ? . o ! non compaiono alla fine
          $excerptOutput .= trim($token);
          break;
        }

        // Aggiungi parole per completare la frase
        $count++;

        // Aggiungi ciò che resta del token
        $excerptOutput .= $token;
      }

      $wpse_excerpt = trim(force_balance_tags($excerptOutput));

      $excerpt_end = ' <a href="' . esc_url(get_permalink()) . '">' . '&nbsp;&raquo;&nbsp;' . sprintf(__('Leggi tutto su: %s &nbsp;&raquo;', 'wpse'), get_the_title()) . '</a>';
      $excerpt_more = apply_filters('excerpt_more', ' ' . $excerpt_end);

      //$pos = strrpos($wpse_excerpt, '</');
      //if ($pos !== false)
      // Dentro l'ultimo tag HTML
      //$wpse_excerpt = substr_replace($wpse_excerpt, $excerpt_end, $pos, 0); /* Aggiungi "leggi tutto" accanto all'ultima parola */
      //else
      // Dopo il contenuto
      $wpse_excerpt .= $excerpt_more; /*Aggiungi "leggi tutto" in un nuovo paragrafo */

      return $wpse_excerpt;

    }
    return apply_filters('wpse_custom_wp_trim_excerpt', $wpse_excerpt, $raw_excerpt);
  }

endif;

remove_filter('get_the_excerpt', 'wp_trim_excerpt');
add_filter('get_the_excerpt', 'wpse_custom_wp_trim_excerpt');

Puoi semplicemente rimuovere i '//' dalle funzioni di cui hai bisogno extra.

LUNGHEZZE PERSONALIZZATE DEGLI EXCERPT

A volte hai bisogno di visualizzare excerpt semplici di lunghezze diverse e non è pratico scrivere un excerpt per ogni post/funzione/pagina. Ecco una bella piccola funzione che utilizza wp_trim_words

function wpse_custom_excerpts($limit) {
    return wp_trim_words(get_the_excerpt(), $limit, '<a href="'. esc_url( get_permalink() ) . '">' . '&nbsp;&hellip;' . __( 'Leggi tutto &nbsp;&raquo;', 'wpse' ) . '</a>');
}

Ciò che fa questa piccola funzione è prendere get_the_excerpt, tagliarlo al $limit impostato dall'utente, e restituire il testo con un link "leggi tutto" alla fine.

Puoi chiamare questo excerpt come segue nel tuo template

echo wpse_custom_excerpts($limit);

dove $limit sarà il tuo conteggio di parole, quindi un excerpt di 30 parole sarà

echo wpse_custom_excerpts(30);

Solo una cosa da ricordare qui, se imposti il tuo limite a più di 55 parole, verranno restituite solo 55 parole poiché l'excerpt è lungo solo 55 parole. Se sono necessari excerpt più lunghi, usa get_the_content invece.

LUNGHEZZA PERSONALIZZATA DELL'EXCERPT

Se hai solo bisogno di modificare la lunghezza di the_excerpt(), puoi usare la seguente funzione

function wpse_excerpt_length( $length ) {
    return 20;
}
add_filter( 'excerpt_length', 'wpse_excerpt_length', 999 );

Ricorda, dovrai impostare una priorità maggiore di 10 in modo che la tua funzione personalizzata venga eseguita dopo quella predefinita.

AGGIUNGI LINK "LEGGI TUTTO"

Tutto il testo restituito dall'excerpt ha il famigerato [...] alla fine che non è cliccabile. Per aggiungere un testo "leggi tutto" al posto dei puntini, usa questa funzione

 function wpse_excerpt_more( $more ) {
    return ' <a class="read-more" href="'. get_permalink( get_the_ID() ) . '">' . __('Leggi tutto', 'your-text-domain') . '</a>';
}
add_filter( 'excerpt_more', 'wpse_excerpt_more' );

MODIFICA

Excerpt del primo paragrafo

Voglio mantenere questa guida completa, quindi ecco l'excerpt che taglia dopo il primo paragrafo.

Ecco una funzione che mantiene intatti i tag HTML, aggiunge un link "Leggi tutto" alla fine dell'excerpt e taglia l'excerpt dopo il primo paragrafo.

if ( ! function_exists( 'wpse0001_custom_wp_trim_excerpt' ) ) : 
    
    function wpse0001_custom_wp_trim_excerpt($wpse0001_excerpt) {
        global $post;
        $raw_excerpt = $wpse0001_excerpt;
        if ( '' == $wpse0001_excerpt ) {
    
            $wpse0001_excerpt = get_the_content('');
            $wpse0001_excerpt = strip_shortcodes( $wpse0001_excerpt );
            $wpse0001_excerpt = apply_filters('the_content', $wpse0001_excerpt);
            $wpse0001_excerpt = substr( $wpse0001_excerpt, 0, strpos( $wpse0001_excerpt, '</p>' ) + 4 );
            $wpse0001_excerpt = str_replace(']]>', ']]&gt;', $wpse0001_excerpt);
    
            $excerpt_end = ' <a href="'. esc_url( get_permalink() ) . '">' . '&nbsp;&raquo;&nbsp;' . sprintf(__( 'Leggi tutto su: %s &nbsp;&raquo;', 'pietergoosen' ), get_the_title()) . '</a>'; 
            $excerpt_more = apply_filters('excerpt_more', ' ' . $excerpt_end); 
    
            //$pos = strrpos($wpse0001_excerpt, '</');
            //if ($pos !== false)
            // Dentro l'ultimo tag HTML
            //$wpse0001_excerpt = substr_replace($wpse0001_excerpt, $excerpt_end, $pos, 0);
            //else
            // Dopo il contenuto
            $wpse0001_excerpt .= $excerpt_more;
    
            return $wpse0001_excerpt;
    
        }
        return apply_filters('wpse0001_custom_wp_trim_excerpt', $wpse0001_excerpt, $raw_excerpt);
    }
    
endif; 
    
remove_filter('get_the_excerpt', 'wp_trim_excerpt');
add_filter('get_the_excerpt', 'wpse0001_custom_wp_trim_excerpt');

MODIFICA 29-10-2015

Per chiunque abbia bisogno di una soluzione alternativa per non visualizzare il link "leggi tutto" dopo l'excerpt quando l'excerpt è più corto del numero di parole impostato, si prega di vedere la seguente domanda e risposta

• Il tag "leggi tutto" appare su OGNI post