DF Smart 404 — Documentazione

Presentazione

DF Smart 404 trasforma la pagina «pagina non trovata» del vostro negozio in un incrocio di conversione. Quando un visitatore atterra su un URL rotto, il modulo analizza quell’URL, ne estrae le parole chiave e mostra i prodotti del catalogo che corrispondono meglio, accompagnati da un modulo di ricerca già precompilato.

In parallelo, ogni 404 viene registrato in un registro nel back-office. Vedrete esattamente quali URL si rompono, quanti visitatori li colpiscono e da dove arrivano. Da quel registro, un reindirizzamento 301 verso il prodotto giusto si crea con un clic.

Cosa fa il modulo

• Inietta un blocco di suggerimenti prodotto nella pagina 404 del vostro tema, senza override di template.
• Precompila il modulo di ricerca con le parole chiave umanizzate estratte dall’URL rotto.
• Registra ogni 404 con deduplicazione, contatore di hit, referer e user agent.
• Crea reindirizzamenti 301 o 302 in un clic, con protezione anti-loop.
• Applica quei reindirizzamenti prima del dispatch della pagina.

Prerequisiti

• PrestaShop 8.0 fino a 9.x
• PHP 7.4 o superiore
• Nessuna dipendenza esterna, nessun Composer

Installazione

1. Andate su Moduli > Gestore moduli.
2. Cliccate su Carica un modulo e rilasciate il file df404smart-1.0.0.zip.
3. Cliccate su Installa.

All’installazione, il modulo crea due tabelle SQL (registro dei 404 e reindirizzamenti), registra tre hook e aggiunge un menu DF Smart 404 nel back-office con due sotto-schede.

Il blocco è attivo immediatamente sulla pagina 404, con impostazioni predefinite operative. Potete testarlo visitando un URL inesistente del vostro negozio.

Configurazione

Aprite la pagina Configura del modulo. Mostra prima quattro indicatori di monitoraggio, poi il modulo delle impostazioni.

Cruscotto

• URL rotti da correggere — numero di voci con stato «nuova» nel registro.
• Hit 404 su questi URL — somma delle visite sugli URL non ancora trattati.
• Reindirizzamenti attivi — numero di regole di reindirizzamento in servizio.
• Visite recuperate dai reindirizzamenti — somma degli hit intercettati dai vostri reindirizzamenti.

Impostazioni disponibili

• Arricchire la pagina 404 — attiva o disattiva l’iniezione del blocco di suggerimenti.
• Mostrare il modulo di ricerca — visualizza il campo di ricerca precompilato nel blocco.
• Attivare il motore di reindirizzamento — applica i reindirizzamenti creati dal registro. Deselezionate questa casella se utilizzate già un modulo di reindirizzamenti di terze parti.
• Numero di suggerimenti — tra 0 e 12 prodotti mostrati. Il valore 0 disattiva i suggerimenti mantenendo il modulo di ricerca.
• Tipo di reindirizzamento predefinito — 301 permanente (raccomandata per la SEO) o 302 temporanea.
• Registrare il traffico dei bot — se disattivato, gli hit dei crawler noti non vengono scritti nel registro.
• Conservazione del registro (giorni) — le voci più vecchie vengono ripulite automaticamente. Le regole di reindirizzamento non vengono mai ripulite.
• Pattern di esclusione — un’espressione regolare insensibile alle maiuscole per riga. Gli URL corrispondenti non vengono mai registrati.

Pattern di esclusione predefiniti

Il modulo è fornito con una lista di pattern che scartano il rumore generato dagli scanner di vulnerabilità e dalle richieste automatizzate: tentativi su wp-admin, wp-login, xmlrpc, phpmyadmin, le cartelle .git, nonché le risorse statiche (immagini, fogli di stile, script). Aggiungete i vostri pattern, uno per riga. Un pattern non valido viene segnalato al salvataggio, con il numero di riga interessato.

Il blocco di suggerimenti nel front

Come vengono selezionati i prodotti

Quando si verifica un 404, il modulo divide gli ultimi due segmenti dell’URL in parole chiave. Le stopword vengono scartate in cinque lingue (francese, inglese, spagnolo, tedesco, italiano), si conservano solo i token di almeno tre caratteri, e gli identificatori puramente numerici sono esclusi.

Ogni token rimanente viene poi confrontato con il catalogo con un punteggio ponderato:

• corrispondenza nel link_rewrite del prodotto: 4 punti
• corrispondenza nel nome del prodotto: 3 punti
• corrispondenza nel riferimento: 2 punti

I prodotti sono ordinati per punteggio decrescente, e vengono conservati solo quelli con punteggio superiore a zero.

Il ripiego

Se nessun prodotto emerge dall’analisi — caso frequente su URL molto corti o oscuri — il modulo ripiega automaticamente sui bestseller. Se anche questi non sono disponibili (catalogo nuovo, statistiche non calcolate), mostra i prodotti più recenti. Il visitatore vede quindi sempre dei prodotti, mai un blocco vuoto.

Il modulo di ricerca

Il campo di ricerca è precompilato con la versione umanizzata delle parole chiave dell’URL. Un visitatore che arriva su /sneakers-pelle-premium-edizione vede già «sneakers pelle premium edizione» nel campo.

Il modulo punta alla pagina di ricerca nativa del vostro tema, con i parametri della query string correttamente trasmessi come campi nascosti. Nessun conflitto con un modulo di ricerca istantanea di terze parti: questo modulo non sovrascrive nulla, utilizza il punto d’ingresso standard di PrestaShop.

Dove appare il blocco

Il modulo individua la sezione di contenuto della pagina 404 del vostro tema e vi inserisce il blocco, appena sotto il messaggio nativo. Se la struttura del tema è atipica, diversi ripieghi successivi garantiscono che il blocco resti sopra il piè di pagina. Nessun file del tema viene modificato.

Il registro dei 404

Menu DF Smart 404 > Registro dei 404.

Colonne

• URL rotto — il percorso richiesto, normalizzato.
• Hit — numero di visite su questo URL. La lista è ordinata per hit decrescenti per impostazione predefinita: gli URL più costosi appaiono per primi.
• Ultimo referer — da dove veniva l’ultimo visitatore (Google, un sito esterno, una pagina interna).
• Stato — Nuova, Reindirizzata o Ignorata.
• Ultimo hit — data dell’ultima visita.

Deduplicazione

La deduplicazione si basa su un hash dell’URL, delimitato per negozio. Mille visite sullo stesso URL rotto producono una sola riga con mille hit, mai mille righe. La scrittura avviene in una singola query upsert.

Azioni disponibili su ogni riga

• Reindirizzamento automatico (icona a fulmine) — crea all’istante un reindirizzamento verso il prodotto più pertinente, via AJAX, senza lasciare la pagina. Questa azione è proposta solo se il punteggio di corrispondenza supera la soglia di confidenza; in caso contrario, un messaggio vi invita a usare il modulo guidato.
• Creare un reindirizzamento — apre il modulo guidato (vedi sotto).
• Ignorare — porta la voce allo stato «ignorata». Sparisce dagli indicatori ma resta consultabile.
• Eliminare — rimuove la voce dal registro.

Dalla barra degli strumenti sono disponibili anche un’azione di eliminazione di massa e un’esportazione CSV.

Creare un reindirizzamento

Il reindirizzamento automatico

Il pulsante a fulmine calcola il miglior prodotto corrispondente all’URL rotto. Se il punteggio supera la soglia di confidenza interna, il reindirizzamento viene creato immediatamente con il tipo predefinito configurato, e la voce del registro passa allo stato «reindirizzata». Un messaggio di conferma indica il prodotto di destinazione.

La soglia di confidenza evita reindirizzamenti azzardati. Un URL come /promo-estate-2024 probabilmente non avrà una corrispondenza affidabile: il modulo rifiuterà il reindirizzamento automatico e vi rimanderà al modulo guidato.

Il modulo guidato

Mostra l’URL rotto, il suo numero di hit, poi la lista dei prodotti suggeriti classificati per punteggio. Ogni suggerimento è un pulsante radio, il primo preselezionato. Un campo URL personalizzata permette di inserire qualsiasi destinazione: una categoria, una pagina CMS, un URL esterno.

Scegliete poi il tipo di reindirizzamento (301 o 302) e confermate. Il modulo verifica che la destinazione non sia vuota, che non punti all’URL di origine stesso (protezione anti-loop), e che non esista già un reindirizzamento per quella sorgente.

Gestire i reindirizzamenti

Menu DF Smart 404 > Reindirizzamenti 404.

Questa schermata offre un CRUD completo sulle vostre regole di reindirizzamento:

• URL di origine — il percorso rotto (es. /vecchia-categoria/vecchio-prodotto).
• URL di destinazione — percorso o URL completo verso cui reindirizzare.
• Tipo — 301 (permanente) o 302 (temporaneo).
• Hit — numero di visite intercettate da questa regola. È la vostra misura diretta delle visite recuperate.
• Attivo — interruttore per disattivare una regola senza eliminarla.

Si applicano le stesse convalide del modulo guidato: origine non vuota, nessun loop, nessun duplicato di origine (l’identificatore corrente è escluso dal controllo in modifica).

Funzionamento del motore

I reindirizzamenti vengono valutati prima del dispatch della pagina, a monte del controller front. Il percorso richiesto viene normalizzato, poi una ricerca indicizzata sul suo hash cerca una regola attiva per il negozio corrente. Se una regola corrisponde, il contatore di hit viene incrementato e il reindirizzamento viene emesso con il codice HTTP configurato.

Prestazioni

• Il registro scrive solo in caso di 404 reale, in una singola query upsert.
• Il motore di reindirizzamento esegue una ricerca indicizzata su hash: costo trascurabile, anche con centinaia di regole.
• La pulizia delle voci vecchie viene attivata casualmente su circa l’1 % degli hit, per non bloccare mai una richiesta del visitatore.
• Gli hit provenienti dai bot possono essere esclusi dalla scrittura, riducendo ulteriormente il carico sui negozi molto scansionati.

Multinegozio

Tutti i dati del modulo sono delimitati per identificativo di negozio: il registro, i reindirizzamenti e i suggerimenti. Ogni negozio dispone del proprio registro, delle proprie regole e della propria configurazione. Un URL rotto sul negozio A non appare nel registro del negozio B.

GDPR

Il registro memorizza l’URL rotto, il referer e lo user agent. Nessun indirizzo IP viene memorizzato, nessun dato personale viene raccolto. La conservazione è configurabile e la pulizia automatica. Il modulo non invia alcun dato a servizi esterni.

Disinstallazione

La disinstallazione elimina le due tabelle del modulo (registro dei 404 e reindirizzamenti), le schede del back-office e la configurazione. I reindirizzamenti creati andranno persi. Viene richiesta una conferma prima dell’operazione.

Se prevedete di reinstallare il modulo o di migrare, esportate prima i vostri reindirizzamenti in CSV dalla schermata di gestione.

Risoluzione dei problemi

Il blocco non appare sulla pagina 404

• Verificate che l’impostazione Arricchire la pagina 404 sia attiva.
• Svuotate la cache di PrestaShop (Parametri avanzati > Prestazioni > Svuota la cache).
• Assicuratevi che il tema utilizzi il controller pagenotfound standard.

Il blocco appare sotto il piè di pagina

Questo caso è trattato dalla versione 1.0.0: il modulo punta alla sezione di contenuto e non al tag di chiusura del contenitore principale. Se osservate ancora questo comportamento, svuotate la cache Smarty e segnalate la struttura del vostro tema al supporto.

Nessun prodotto viene suggerito

• Verificate che il Numero di suggerimenti non sia impostato su 0.
• Su un catalogo nuovo senza storico di vendite, il ripiego sui bestseller è vuoto: il modulo passa allora ai prodotti recenti. Assicuratevi di avere almeno un prodotto attivo e visibile.

Il reindirizzamento automatico si rifiuta di crearsi

È il comportamento atteso quando il punteggio di corrispondenza è troppo basso. Usate il modulo guidato, che mostra i suggerimenti anche sotto la soglia e permette di inserire una destinazione personalizzata.

Un reindirizzamento non si applica

• Verificate che l’impostazione Attivare il motore di reindirizzamento sia spuntata.
• Verificate che la regola sia attiva nella schermata di gestione.
• Verificate che la regola appartenga al negozio corretto in contesto multinegozio.
• Se è installato un altro modulo di reindirizzamenti, potrebbe intercettare la richiesta a monte.

Supporto

12 mesi di aggiornamenti e 12 mesi di supporto via email sono inclusi nella vostra licenza. Il codice sorgente PHP completo è fornito, non offuscato.