Documentazione Custom 404 & Maintenance

Installazione

Requisiti

Magento 2.4.x. PHP 8.1–8.5. Compatibile sia con il tema predefinito Luma sia con il tema Hyvä. Richiede il modulo gratuito codingrow/module-core, installato automaticamente. Nessuna chiave da inserire: il modulo si attiva automaticamente sul tuo dominio.

Passi di installazione

1. Richiedi il modulo dalla pagina prodotto con la sola email: ricevi via email le credenziali Composer (le trovi anche nella tua area cliente). Salvale dalla radice del progetto Magento:

   composer config http-basic.repo.codingrow.com <username> <password>

2. composer config repositories.codingrow composer https://repo.codingrow.com
3. composer require codingrow/module-custom-404-maintenance
4. bin/magento module:enable Codingrow_Custom404Maintenance
5. bin/magento setup:upgrade — in modalità production anche setup:di:compile, setup:static-content:deploy e cache:flush.
6. Non c'è nessuna chiave da incollare: il modulo si attiva automaticamente sul tuo dominio, passa direttamente alla configurazione qui sotto.

setup:upgrade installa anche la skin della pagina di manutenzione in pub/errors. Se non ci riesce (permessi dei file), esegui una volta bin/magento codingrow:c404m:deploy con l'utente proprietario dei file di Magento.

Configurazione

Apri Admin → Stores → Configuration → Codingrow Extensions → Custom 404 & Maintenance. Ogni campo è impostabile a livello Default, Website e Store View: usa il selettore Scope in alto a sinistra per avere testi o design diversi per lingua.

Disinstallazione

Ripristina la pagina di manutenzione standard di Magento prima di rimuovere il modulo:

bin/magento codingrow:c404m:deploy --uninstall
composer remove codingrow/module-custom-404-maintenance
bin/magento setup:upgrade

Se rimuovi il modulo senza --uninstall, la pagina di manutenzione continua a mostrare l'ultima versione generata finché non si rimuove la skin. Per tornare semplicemente alle pagine standard senza disinstallare, imposta Enable custom 404 page e/o Enable custom maintenance page su No.

Guida all'uso

Pagina 404

Quando un indirizzo non esiste, invece della pagina CMS “404 Not Found” il negozio mostra una pagina a tutto schermo con logo, un grande “404” opzionale, titolo, messaggio, casella di ricerca opzionale e pulsante “Torna alla home”. La risposta mantiene lo stato HTTP 404, ha noindex e non viene mai messa in cache, quindi i motori di ricerca non la indicizzano.

Pagina di manutenzione

Mentre la manutenzione è attiva (bin/magento maintenance:enable) Magento non gira e risponde pub/errors/503.php. Il modulo quindi:

1. installa una skin in pub/errors/codingrow_c404m/ e la attiva in pub/errors/local.xml (un local.xml già esistente viene salvato in local.xml.codingrow_c404m.bak);
2. pre-genera l'HTML della pagina per ogni store view;
3. durante la manutenzione sceglie la store view della richiesta (MAGE_RUN_CODE del web server → dominio/percorso → cookie dello store → lingua del browser → store predefinito) e serve la sua pagina con HTTP 503 e Retry-After. Se per quella store view la pagina non è attiva, viene mostrata quella standard di Magento.

L'HTML si rigenera da solo quando salvi la sezione, quando cambi il logo in Content → Design → Configuration e a ogni maintenance:enable. Gli IP esclusi con --ip continuano a vedere il negozio.

Design

Il design vale per entrambe le pagine: logo (logo dello store, logo personalizzato — jpg, png, gif, svg, webp — o nessuno) con larghezza massima; sfondo a colore pieno, gradiente a due colori o immagine a tutto schermo con scurimento 0–90%; riquadro del contenuto assente, chiaro o scuro; font, dimensione del titolo e allineamento; colore del testo, colore accento (numero 404, link, pulsanti, nota) e colore del testo dei pulsanti, ognuno con selettore colore. La pagina è HTML/CSS autonomo e non usa il tema, quindi appare identica su Hyvä e Luma.

Anteprima dal vivo

Il gruppo Live Preview mostra la pagina 404 o la pagina di manutenzione, in versione Desktop o Mobile, aggiornata mentre modifichi i campi e con lo scope selezionato — prima di salvare. Le immagini appena caricate (logo personalizzato, immagine di sfondo) compaiono nell'anteprima dopo il salvataggio.

Comando CLI

bin/magento codingrow:c404m:deploy installa o aggiorna la skin di manutenzione in pub/errors e rigenera le pagine per tutte le store view. Serve solo quando pub/errors non è scrivibile dal web server; i file della skin vengono creati con permessi 644/755. --uninstall ripristina local.xml e rimuove la skin, riportando la pagina di manutenzione standard di Magento.

Risoluzione problemi

• Vedo ancora la vecchia pagina 404: verifica che Enable custom 404 page sia Yes nello scope della store view che stai guardando, svuota la cache (System → Cache Management) e prova un indirizzo che davvero non esiste.
• In manutenzione vedo la pagina standard di Magento: Installation status deve essere Installed, la pagina deve essere attiva per quella store view e il tuo IP non deve essere escluso con --ip. Poi esegui bin/magento codingrow:c404m:deploy.
• Lingua sbagliata in manutenzione: imposta i testi nello scope della store view giusta; se più store view condividono lo stesso indirizzo, decidono il cookie dello store e poi la lingua del browser. Poi esegui bin/magento codingrow:c404m:deploy.
• Il logo non si vede: con Store logo viene da Content → Design → Configuration → Header → Logo Image (o dal logo del tema); scegli Custom logo per caricarne uno e aumenta Logo max width se appare troppo piccolo.
• L'immagine di sfondo non compare nell'anteprima: le immagini caricate compaiono dopo il salvataggio; verifica che Background sia impostato su Image.

Licenza

Custom 404 & Maintenance è gratuito e non c'è nessuna chiave da inserire: una volta installato, il modulo si attiva automaticamente sul tuo dominio. Esegue una verifica online leggera con codingrow.com, inviando solo il dominio del negozio, il prodotto e la versione installata (nessun dato dei tuoi clienti), e ricorda l'ultima risposta, così un problema di rete temporaneo non lo disattiva. Il form nella pagina prodotto serve solo a inviarti le credenziali del repository Composer di Codingrow, con cui scarichi il modulo e i suoi aggiornamenti.

Se un giorno il modulo diventasse a pagamento: i domini che lo hanno già attivato restano gratuiti, per sempre, su tutte le versioni uscite fino a quella data — senza cambio dominio né richieste all'assistenza. Il log di Magento indica l'ultima versione installabile gratis; le versioni successive richiederebbero una licenza.