Vai al contenuto

Un report che elenca gli indirizzi rotti dello storefront, con il redirect pronto in una riga

Reports > 404 Errors raccoglie ogni indirizzo che risponde 404 con visite, primo e ultimo passaggio e referer, e ogni riga apre un rewrite compilato con store view, percorso e 301.

Un negozio cambia un URL, un vecchio link continua ad arrivare da un forum o da una campagna di tre anni fa, e il visitatore trova una pagina bianca. Nessuno se ne accorge, perché il 404 non lascia traccia dove si guarda di solito. La pull request #1834 gli dà un posto dove finire.

Cosa aggiunge

Nasce un report nuovo, Reports > 404 Errors, subito dopo i termini di ricerca. Elenca ogni indirizzo dello storefront che ha risposto “404 Not Found” con il numero di visite, il primo e l’ultimo passaggio e l’ultimo referer. I bot contano come tutti gli altri, perché un link rotto che i motori continuano a chiedere è un problema anche quando nessun umano lo apre.

Il report 404 Errors con cinque indirizzi e un link Redirect su ogni riga

La parte che fa risparmiare tempo è il link Redirect in ogni riga: apre un nuovo rewrite personalizzato già compilato con la store view, il percorso e l’opzione 301, e resta solo da scrivere la destinazione.

Il form del rewrite personalizzato con store view, percorso e 301 già compilati

Il report non si appoggia al log dei visitatori, che al livello predefinito non scrive niente e che comunque salta i bot: ha una tabella sua, con una riga per percorso e store view e un contatore che sale a ogni visita, quindi cresce con il numero di link rotti e non con il traffico.

Perché conta

Chi gestisce un negozio che arriva da Magento 1 o da un sito vecchio sa che gli URL cambiano e che i link esterni non si aggiornano. Sapere quali indirizzi rispondono 404, da dove arrivano e da quanto tempo, trasforma un lavoro a intuito in una lista da smaltire: si guarda l’indirizzo con più visite, si crea il redirect dalla stessa riga e si passa al successivo.

Il report mostra anche Redirects To, cioè la destinazione, ma solo quando il rewrite che lo storefront usa davvero fa un redirect. Un prodotto disattivato che tiene un rewrite che non redirige compare senza destinazione, ed è giusto così: la sua pagina risponde 404.

Cosa serve

  • Le impostazioni sono in System > Configuration > General > Reports > 404 Errors: l’interruttore Record 404 Errors, il limite di voci per visitatore all’ora (100 per default), la conservazione delle righe non più viste (30 giorni) e il tetto della tabella (10.000 righe), che un cron orario applica.
  • Il report parte con l’aggiornamento: gli indirizzi rotti precedenti non ci sono, perché nessuno li aveva registrati.
  • Un redirect per percorso e store view: se la store view ha già un rewrite per quel percorso, la riga non mostra il link, perché due rewrite con lo stesso percorso non si possono salvare.

Cosa può ancora cambiare

La pull request è unita ma non è in una release, e i limiti dichiarati sono questi. Un 404 che risponde il web server da solo, come un’immagine, un CSS o un JS che non esiste, non passa da Maho e il report non può vederlo. Le righe tengono il percorso come lo legge la ricerca dei rewrite, quindi in minuscolo, senza barre finali e senza query string: è quello che fa sì che i parametri utm_* non moltiplichino le righe, e che il redirect generato combaci con la richiesta. Il report salta l’admin, il percorso api/, la cartella .well-known/, le risposte 410 e i percorsi oltre i 255 caratteri.

Nello stesso lavoro ci sono tre correzioni che vanno oltre il report: un foglio di calcolo legge come formula anche una cella che inizia con @, quindi l’export CSV ora la protegge come già faceva con =, + e -; l’import CSV non lascia più lo spazio che l’export mette davanti a quei valori; e la ricerca dei rewrite preferisce sempre quello della store view a quello del negozio 0 quando il percorso è lo stesso, cosa che prima dipendeva dall’ordine in cui il database rispondeva.

Stato

La fotografia è del 21 novembre 2026. La pull request è stata unita il 15 novembre e non è ancora in una release: chi vuole provarla la trova nella documentazione del repository, e chi aspetta una versione la trova nella prossima patch o nella prossima release, quando usciranno.

Testo preparato con l'aiuto dell'AI e verificato sulla fonte prima della pubblicazione. Può contenere errori: se ne trovi uno, segnalalo.Leggi il Manifesto

Fonte: MahoCommerce/maho#1834

Il tuo negozio vende ancora?

Raccontaci da dove parti: ti rispondiamo con una prima valutazione, senza impegno.

Chiedi l'analisi del negozio