URL puliti Pro modulo per PrestaShop

Caratteristiche e vantaggi principali

• URL senza ID secondo i tuoi modelli — decidi tu come deve apparire l’indirizzo di ogni tipo di contenuto, ad es. product/nome-prodotto oppure — dopo aver attivato i modelli senza prefisso — anche nome-prodotto.html direttamente nella directory principale del negozio.
• Nessuna perdita SEO durante la modifica degli URL — i reindirizzamenti permanenti 301/308 dagli indirizzi nativi e da ogni forma precedente dell’indirizzo trasferiscono ai nuovi URL il posizionamento conquistato nei motori di ricerca, invece di creare duplicati ed errori 404.
• Implementazione sicura e reversibile — nel negozio non cambia nulla finché non attivi tu stesso il motore; prima costruisci e verifichi tutto in background, e il rollback è graduale quanto l’implementazione.
• Compatibilità con altri moduli senza modificarli — l’override della classe Link fa sì che ogni modulo che recupera gli indirizzi tramite l’API standard di PrestaShop (feed Google/Facebook, sitemap, moduli eseguiti da cron e dal pannello) riceva automaticamente gli indirizzi canonici.
• Gestione automatica dei conflitti di nome — quando due elementi hanno lo stesso nome, il motore assegna automaticamente un suffisso leggibile o un percorso padre oppure — se lo imposti così — attende la tua decisione; nulla viene pubblicato alla cieca.
• Protezione delle pagine esistenti — il modulo rileva e riserva automaticamente gli indirizzi già occupati da PrestaShop stesso e da altri moduli (carrello, contatti, mappa del sito), quindi un URL pulito di prodotto non prenderà mai il posto di una pagina esistente.
• Pannello comprensibile anche per i non esperti — dashboard con guida passo dopo passo, descrizione per ogni opzione, descrizioni di stato in ogni scheda e messaggi diagnostici che indicano chiaramente cosa e dove cliccare, inclusi pulsanti di riparazione con un solo clic.
• Architettura fail-closed — in caso di qualsiasi errore (registro danneggiato, guasto della cache, conflitto con un’altra modifica) il negozio torna immediatamente agli indirizzi nativi, invece di mostrare errori ai clienti.

Funzionalità nel dettaglio

Modelli e costruzione degli indirizzi

• Modello di indirizzo separato per ogni tipo di contenuto (prodotti, categorie, pagine CMS, categorie CMS, produttori, fornitori, allegati) in ogni lingua e negozio.
• Token nei modelli: nome leggibile, percorso completo della categoria, categoria padre, produttore, fornitore, riferimento, prefisso lingua e altri — a seconda del tipo di contenuto.
• Politica globale dei percorsi: lettere minuscole, solo caratteri ASCII, slash finale, limiti di lunghezza del segmento e dell’intero percorso, controllo degli slug composti solo da cifre — con possibilità di override per singolo modello.
• Modelli senza prefisso fisso (indirizzi direttamente nella directory principale) per PrestaShop 8.1.2 e versioni successive, sempre verificati con controllo preliminare.
• Politica degli indirizzi delle combinazioni prodotto: un unico indirizzo canonico condiviso per tutte le varianti (con rimozione dell’ancora della combinazione dopo il segno #) oppure mantenimento del parametro funzionale della variante.

Implementazione graduale e diagnostica

• Cinque modalità del motore: disattivato, solo osservazione, modalità parallela (i vecchi indirizzi reindirizzano già, il negozio mostra i link nativi), attivo e modalità di emergenza “attivo con fallback nativo”.
• Controllo preliminare (preflight) che blocca l’attivazione finché non sono soddisfatte tutte le condizioni: registro completo, validazione aggiornata, collisioni risolte, attività completate, schema del database corretto, hook registrati, assenza di conflitti tra modelli.
• Messaggi diagnostici che indicano la causa esatta e il punto da correggere, con pulsanti che con un clic mettono in coda le ricostruzioni o validazioni mancanti esattamente per gli ambiti interessati dal problema.
• Tabella di copertura che mostra per ogni lingua e tipo di contenuto quanti elementi hanno già un URL pulito, oltre a un report di integrità del registro.
• Transizioni protette tra le modalità — dalla modalità attiva non è possibile passare accidentalmente a quella disattivata saltando la verifica.

Reindirizzamenti, alias e protezione SEO

• Reindirizzamenti permanenti automatici dagli indirizzi nativi con ID agli indirizzi canonici (301 o 308 a scelta), escludendo le pagine di listing con parametri di ordinamento e filtri.
• Cronologia degli indirizzi: ogni modifica dell’indirizzo canonico lascia dietro di sé un reindirizzamento funzionante, così segnalibri, annunci e risultati di ricerca non portano mai nel vuoto.
• Alias manuali e importati con destinazione sotto forma di oggetto del negozio, qualsiasi URL (con politica di sicurezza degli host: solo negozio corrente, elenco di domini HTTPS consentiti oppure qualsiasi HTTPS) oppure risposta 410/404.
• Codici di risposta per gli alias: 301, 302, 307, 308 nonché 404 e 410; gli oggetti rimossi restituiscono a scelta 410 Gone (rimozione più rapida dall’indice) oppure 404.
• I reindirizzamenti mantengono i parametri di campagna (utm_source, utm_medium, utm_campaign, utm_term, utm_content), gli identificatori di clic pubblicitari (gclid, fbclid, msclkid) e un elenco definito di parametri funzionali.
• Normalizzazione delle richieste: le varianti dell’indirizzo che differiscono per maiuscole/minuscole o slash finale vengono reindirizzate a un’unica forma canonica, senza contenuti duplicati.
• Statistiche opzionali di utilizzo dei reindirizzamenti con campionamento — vedi se qualcuno usa ancora i vecchi link.

Compatibilità e integrazioni

• Override della classe Link: tutti i moduli che utilizzano l’API standard degli indirizzi di PrestaShop — inclusi i generatori di feed prodotto e sitemap eseguiti dal pannello o da cron — ricevono indirizzi canonici senza alcuna modifica al loro codice, con ritorno automatico all’indirizzo nativo quando l’URL pulito non è disponibile.
• API pubblica per sviluppatori: recupero singolo e massivo degli indirizzi canonici (con precaricamento del registro per i generatori di sitemap) e hook che consentono ad altri moduli di riservare i propri percorsi e reagire alle modifiche delle route.
• Supporto completo multistore (configurazione, modelli e registro per negozio) e multilingua; nelle versioni più vecchie di PrestaShop, dove il core lo richiede, il modulo garantisce modelli identici tra le lingue.
• Compatibilità: PrestaShop 1.7.x–9.x, sintassi PHP 7.0–8.5 (nei limiti dei requisiti del core utilizzato), MySQL 5.6+/MariaDB 10.x, Apache e Nginx, negozi in sottodirectory — senza Composer né librerie esterne.

Automazione, attività e prestazioni

• Aggiornamento automatico: l’aggiunta, la modifica del nome o la rimozione di un prodotto, una categoria o una pagina aggiorna automaticamente l’indirizzo e mette in coda le ricostruzioni necessarie, incluse le dipendenze (la modifica di una categoria aggiorna i prodotti, la modifica di un prodotto — gli allegati).
• Sistema di attività in background: scansione, anteprima (senza salvataggio), ricostruzione, validazione, riscaldamento della cache, importazione, esportazione e pulizia — eseguiti in blocchi configurabili, con pausa, ripresa, annullamento e svuotamento dell’intera coda con un solo pulsante.
• Cron con un solo link: un indirizzo pronto da copiare con token segreto (sezione Cron nel pannello, con istruzioni e riga per crontab) elabora automaticamente la coda; le chiamate sovrapposte vengono bloccate; è disponibile anche un’interfaccia CLI.
• Cache file-based frammentata delle route (dimensione del frammento e durata configurabili) con fallback al database — la risoluzione degli indirizzi non grava sul database a ogni visualizzazione.
• Registro di audit delle modifiche agli indirizzi con retention configurabile e pulizia automatica delle attività completate e delle voci scadute.
• Importazione degli alias da file CSV con anteprima e validazione separate prima del salvataggio (fino a 500 righe per file, salvataggio atomico) ed esportazione di impostazioni, route, alias, riserve, collisioni e diagnostica in JSON/CSV — senza segreti né dati dei clienti.

Pannello di amministrazione e sicurezza

• Pannello chiaro con dashboard (metriche del registro), guida richiudibile “Come iniziare — passo dopo passo” che ricorda il proprio stato, descrizione dello stato della configurazione in ogni scheda e descrizioni accanto a ogni opzione.
• Elenchi di percorsi, alias, collisioni e attività con il filtraggio standard di PrestaShop: lingua e tipo di oggetto come liste di selezione, ID, percorso e slug come campi di testo, con paginazione nativa.
• Permessi conformi ai profili dipendente di PrestaShop (visualizzazione, modifica, eliminazione) applicati nel pannello e in ogni azione AJAX.
• Sicurezza: token e firme delle richieste amministrative, verifica dell’origine delle richieste, confronti di chiavi resistenti agli attacchi temporali, chiave operativa segreta del cron per negozio, normalizzazione rigorosa dei percorsi che rifiuta caratteri di controllo e doppia codifica.
• Affidabilità: installazione transazionale con rollback automatico e ripristino della configurazione precedente in caso di errore, blocco della disinstallazione con routing attivo, marcatori persistenti di guasto che forzano la modalità sicura dopo un errore critico e pulizia completa di tabelle e configurazione durante la disinstallazione.

Requisiti

• PrestaShop 1.7.0–9.x con URL amichevoli attivati (Parametri negozio → Traffico e SEO).
• PHP 7.0–8.5 (versione supportata dal core PrestaShop utilizzato), MySQL 5.6+ oppure MariaDB 10.x.
• Nessuna dipendenza aggiuntiva: il modulo non utilizza Composer né librerie esterne.