Errore 404 nelle pagine tag WordPress: come risolvere il conflitto tra base tag e slug categorie

Perché WordPress mostra errore 404 nelle pagine tag

In WordPress può capitare che, visitando le pagine tag (ad esempio nomesito.it/tag/nome-tag), venga mostrato un errore 404 pagina non trovata.
Questo problema si verifica quasi sempre quando c’è un conflitto di slug tra la base dei tag o delle categorie e lo slug di una categoria o di un tag già esistente.

In altre parole, se la base tag è impostata su psicologo-milano e hai già una categoria con slug psicologo-milano, WordPress non riesce a distinguere i percorsi e manda tutto in errore.

Differenza tra slug e base tag/categorie

• Slug categoria/tag: è il nome univoco che identifica una tassonomia, ad esempio psicologo-milano.
• Base tag/categoria: è il prefisso che WordPress utilizza negli URL per distinguere gli archivi, ad esempio tag → nomesito.it/tag/ossessioni.

Quando questi due valori coincidono, WordPress non è più in grado di interpretare correttamente la URL e mostra errore 404.

Soluzione al problema 404 nei tag

La soluzione più efficace nella maggior parte dei casi è modificare la base dei tag o delle categorie in modo che non coincida con lo slug di una categoria o di un tag già esistente.

Esempio pratico

• Problema: categoria con slug psicologo-milano + base tag impostata a psicologo-milano → errore 404.
• Soluzione: cambiare la base tag in argomenti o tematiche.

MU-plugin per sbloccare gli archivi tag

Se il tema attivo disabilita o reindirizza gli archivi dei tag, si può creare un MU-plugin con questo codice:

<?php
/**
 * Plugin Name: Enable Tag Archives
 */
add_action('pre_get_posts', function ($q) {
    if (is_admin() || !$q->is_main_query()) return;
    if ($q->is_tag()) {
        $q->is_404 = false;
        if (!$q->get('post_type')) {
            $q->set('post_type', ['post']);
        }
        $q->set('ignore_sticky_posts', true);
    }
}, 999);

add_action('template_redirect', function () {
    if (is_tag()) {
        status_header(200);
        nocache_headers();
    }
}, 0);

Conclusioni

Nella maggior parte dei casi, l’errore 404 nelle pagine tag di WordPress non è un bug ma dipende da un conflitto tra la base delle tassonomie e lo slug delle categorie o dei tag. La soluzione più semplice è differenziare le basi, mentre nei casi in cui il tema blocchi gli archivi si possono usare MU-plugin o creare un template tag.php dedicato.

Con questi accorgimenti si ripristina la corretta navigazione dei tag, migliorando l’esperienza utente e la struttura SEO del sito.

Ti auguro buona lettura e mi raccomando, se dopo aver letto questo articolo hai bisogno di aiuto non esitare a contattarmi.

Autore: Graziano De Maio | Titolare di Gdmtech