Come aggiungere automaticamente i titoli mancanti ai link in WordPress per una migliore accessibilità e SEO
Quando sviluppi o personalizzi siti WordPress, è comune affidarsi a temi e plugin che generano contenuti in modo dinamico. Anche se è comodo, spesso va a scapito dell’accessibilità e dell’ottimizzazione per i motori di ricerca, soprattutto quando questi plugin o temi generano tag <a> senza l’attributo title.
In questo articolo spiegheremo perché gli attributi title mancanti sono importanti e come puoi aggiungerli automaticamente ai link nel contenuto dei tuoi articoli usando una funzione WordPress personalizzata.
Perché i titoli dei link sono importanti
Accessibilità
Per gli utenti che usano gli screen reader, i titoli dei link possono fornire un contesto aggiuntivo su dove porta un link. Anche se gli screen reader di solito leggono il testo visibile dell’ancora, l’attributo title può integrarlo offrendo informazioni extra. Può essere particolarmente utile quando il testo del link è vago, come “clicca qui” o “leggi di più”.
È importante usare gli attributi title con criterio e non ripetere il testo dell’ancora, perché potrebbe essere ridondante per chi usa uno screen reader.
SEO
I motori di ricerca analizzano i link per il testo dell’ancora e gli attributi correlati. Anche se l’attributo title non è un fattore di ranking diretto, può contribuire alla chiarezza e al significato semantico. Quando inserisci link ad altri articoli, aggiungere un title descrittivo può rafforzare la rilevanza della pagina di destinazione e aiutare i crawler a comprendere meglio la struttura del sito.
Esperienza utente
Quando gli utenti passano il mouse su un link, il browser può mostrare un tooltip con l’attributo title. Questo può rassicurare gli utenti prima di cliccare su un link, migliorando fiducia e usabilità.
Il problema dei titoli mancanti
Molti plugin, page builder e temi generano link senza attributi title. Questo può portare a un markup incoerente, a occasioni perse per la SEO e a contenuti meno accessibili. Anche se gli sviluppatori possono aggiungere manualmente gli attributi title, raramente è fattibile su siti grandi o dinamici.
Per questo abbiamo creato una funzione che aggiunge automaticamente i titoli mancanti ai link nel contenuto degli articoli.
Il codice: aggiungere automaticamente i titoli mancanti ai link
Qui sotto trovi lo snippet di codice completo. Puoi aggiungerlo al file functions.php del tuo tema oppure, meglio ancora, inserirlo in un plugin funzionale.
defined( 'ABSPATH' ) || exit;
/**
* Adds the post title as the "title" attribute to links in post content
* that don't already have one. This improves accessibility and SEO.
*
* The function:
* - Processes the content and finds links missing a title attribute.
* - Determines the title from the current post or, if needed,
* from the target post ID.
* - Replaces the links with a version that includes the title.
*
* @since 1.0.0
*
* @param string $content The post content.
* @return string The modified content with title attributes added.
*/
function eos_add_missing_link_titles_to_links( $content ) {
$content = do_shortcode( $content );
$pattern = '/<a\s((?!.*\btitle=)[^>]+)>/i'; // Regex: Find anchor tags WITHOUT a title attribute.
$title = false;
if ( function_exists( 'is_main_query' ) && ! is_main_query() && isset( $post ) && isset( $post->post_title ) ) {
// We are in a secondary loop.
global $post;
$title = $post->title;
if( $title ) {
$replacement = '<a title="' . esc_attr( $title ) . '">';
$content = preg_replace( $pattern, $replacement, $content );
return $content;
}
}
else{
// We aren't in a loop.
preg_match_all( $pattern, $content, $matches );
if( $matches && is_array( $matches[0] ) ) {
foreach( $matches[0] as $link ) {
if( false !== strpos( $link, ' href="' ) ) {
$arr = explode( ' href="', $link );
$url = rtrim( $arr[1], '">' );
$post_id = url_to_postid( $url );
if( $post_id ) {
$title = get_the_title( $post_id );
if( $title ) {
$new_link = str_replace( ' href="', ' title="' . esc_attr( $title ) . '" href="', $link );
$content = str_replace( $link, $new_link, $content );
}
}
}
}
}
}
return $content;
}
if( ! is_admin() ) {
// Run only on the frontend.
add_filter( 'the_content', 'eos_add_missing_link_titles_to_links', 9999999999999 ); // Filter post content to automatically add title attributes to links for better accessibility and SEO.
}
Se non sai come creare un plugin funzionale personalizzato, puoi usare il nostro Plugin Builder.
Come funziona il codice
Elaborazione del contenuto
La funzione inizia applicando do_shortcode() al contenuto. Questo garantisce che gli shortcode che generano link vengano espansi prima di analizzare l’HTML.
Trovare i link senza titolo
L’espressione regolare cerca i tag di ancora che non contengono un attributo title. Questo è fondamentale per evitare di sovrascrivere i link che hanno già valori title significativi.
Gestione dei loop secondari
In alcune situazioni, come gli articoli correlati o i widget, WordPress usa loop secondari. In quel caso, se è disponibile un oggetto post valido, la funzione usa il suo titolo per inserirlo nell’attributo title.
Fallback: uso di url_to_postid()
Se non siamo in un loop, la funzione tenta di estrarre l’URL di destinazione da ogni link, convertire quell’URL in un ID di post usando url_to_postid() e recuperare il titolo corrispondente. Se ci riesce, il titolo viene aggiunto come attributo title nel tag di ancora.
Questo permette alla funzione di funzionare anche sulle pagine statiche o sui contenuti caricati al di fuori del Loop.
Aggancio a WordPress
Infine, la funzione viene agganciata al filtro the_content. Viene eseguita solo sul frontend e con un numero di priorità molto alto, per garantire che elabori il contenuto dopo la maggior parte degli altri filtri.
if( ! is_admin() ) {
// Run only on the frontend.
add_filter( 'the_content', 'eos_add_missing_link_titles_to_links', 9999999999999 ); // Filter post content to automatically add title attributes to links for better accessibility and SEO.
}
Considerazioni finali
Aggiungere attributi title ai link può migliorare l’accessibilità, supportare i motori di ricerca e creare un’esperienza utente migliore. Anche se non tutti gli screen reader li useranno, e anche se non dovrebbero mai duplicare il testo visibile, possono comunque offrire un contesto prezioso se usati correttamente.
Poiché molti temi e plugin trascurano di aggiungerli, automatizzare questa attività aiuta a mantenere i tuoi contenuti puliti e più accessibili senza modifiche manuali.
Sentiti libero di adattare ed estendere questo codice per escludere certi link o gestire gli URL esterni, in base alle esigenze del tuo sito.
Vuoi il modo più semplice per implementare il codice suggerito sul tuo sito? Scarica semplicemente il plugin Add Missing Link Titles.