In questo tutorial vedremo come utilizzare la funzione di WordPress wp_trim_words().
Questa funzione, come suggerisce il suo nome, serve a tagliare il testo in eccedenza usando come riferimento il numero di parole in esso contenuto.
Accetta tre argomenti:
- Il testo da tagliare.
- Il numero di parole da considerare (il valore predefinito è
55). - Una stringa che indica l'interruzione del testo aggiunta alla fine (il valore predefinito sono dei puntini di sospensione).
La funzione effettua una verifica condizionale: se il testo supera il numero massimo di parole indicato, viene tagliato fermandosi al numero esatto di parole, altrimenti il testo viene restituito nella sua interezza.
Un caso d'uso pratico sono i titoli dei post, che spesso possono essere molto lunghi.
$title = get_the_title();
echo wp_trim_words( $title, 15, '(...)' );
Nell'esempio, se il titolo del post supera le 15 parole, viene tagliato aggiungendo alla fine la stringa (...) che segnala visivamente l'interruzione del testo.
Questa funzione è ottimizzata per il testo semplice, quindi se ne sconsiglia l'uso con il testo che contiene ad esempio tag HTML.