Pagine di errore
Imposta uno stile comune per le pagine dei visitatori e personalizza i singoli errori HTTP con un’anteprima interattiva.
Usa Configuration > Error pages per personalizzare le pagine che i visitatori vedono dopo una richiesta bloccata o un errore di connessione. Puoi impostare valori predefiniti comuni e personalizzare i singoli stati HTTP da 400 a 599. Le modifiche riguardano solo il sito selezionato.
Valori predefiniti comuni
- Apri Configuration per il sito.
- In Error pages, scegli Default for all pages dal menu Error page.
- Seleziona un testo o uno sfondo in Interactive preview. Puoi anche scegliere un campo da Edit element.
- Inserisci il testo o scegli il colore nel pannello accanto all’anteprima. Sugli schermi più piccoli, il pannello compare sotto.
- Seleziona Save changes in fondo al modulo di configurazione.
L’anteprima si aggiorna prima del salvataggio. L’anteprima predefinita mostra HTTP 403. Ogni campo vuoto usa il valore predefinito del sistema o quello ereditato dal marchio. Titoli e messaggi vuoti mantengono il testo adatto all’errore effettivo.
Uno sfondo o un colore di accento comune si applica a tutte le pagine che non personalizzano quel campo. Ad esempio, imposta lo sfondo predefinito su #171022 e lascia vuoti gli sfondi delle singole pagine per usare quel colore ovunque.
Singole pagine
Scegli uno stato HTTP da Error page, ad esempio HTTP 403 · Forbidden. Modifica i campi che richiedono valori diversi. Il menu contrassegna con (custom) le pagine con personalizzazioni salvate o ancora in bozza.
Ad esempio, imposta Heading della pagina 403 su Access restricted e lascia vuoto Page background. La pagina usa quel titolo e lo sfondo comune. Se cambi lo sfondo predefinito, cambia anche questa pagina. Se invece assegni uno sfondo specifico alla pagina 403, quel colore rimane anche quando cambia il valore predefinito.
Seleziona Use website default per rimuovere tutte le personalizzazioni dello stato selezionato. Seleziona Save changes per applicare la rimozione. Puoi personalizzare fino a 100 singole pagine. Per aggiungerne un’altra dopo aver raggiunto il limite, ripristina i valori predefiniti per una pagina già personalizzata.

L’esempio mostra una pagina 403 personalizzata nella dashboard in inglese. Su mobile, gli stessi controlli compaiono sotto l’anteprima.
Campi e limiti
| Campo | Configurazione |
|---|---|
| Page background | Sfondo della pagina e del riquadro come colore esadecimale a sei cifre, ad esempio #171022. |
| Accent color | Colore dello stato HTTP, del testo del marchio e del link di assistenza, ad esempio #d0b0ff. |
| Text color | Colore di titolo, messaggio e piè di pagina. Mantienilo leggibile sullo sfondo. |
| Brand name | Fino a 80 byte di testo. Il logo del reseller rimane parte del marchio ereditato. |
| Heading | Fino a 120 byte di testo. |
| Message | Fino a 1.000 byte di testo. Le interruzioni di riga vengono mantenute. |
| Footer text | Fino a 240 byte di testo. L’identificativo della richiesta resta invariato. |
| Support URL | Un indirizzo HTTPS senza credenziali, fino a 2.048 byte. |
I limiti contano i byte UTF-8, quindi alcuni caratteri occupano più di un byte. Il contenuto viene mostrato come testo semplice; HTML e script vengono visualizzati come testo. Reset svuota il campo selezionato, che eredita così il valore predefinito appropriato. Il link di assistenza nell’editor è un esempio: selezionarlo non apre un’altra pagina.
Errori dell’origine
Abilita Use these pages for origin errors e seleziona Save changes per sostituire le risposte di errore HTML compatibili del server. La sostituzione copre HTTP 400–599 quando il visitatore accetta HTML e il server di origine restituisce HTML o non specifica il tipo di contenuto. JSON e gli altri corpi delle risposte mantengono il contenuto originale. Anche le risposte riuscite restano invariate.
Il contenuto scaduto della cache, quando ancora utilizzabile, ha la precedenza sulla pagina di errore. Loclix non può sostituire una risposta dopo aver iniziato a inviarla al visitatore.
Risultati e risoluzione dei problemi
La stessa configurazione copre blocchi delle regole, limiti di frequenza, richieste non valide, verifiche fallite ed errori di connessione all’origine generati da Loclix. Usa lo stesso editor in Challenge page branding per personalizzare la pagina di verifica. Le regole per le route API mantengono le risposte di errore JSON. Le altre risposte di errore non HTML possono usare titolo e messaggio configurati come testo semplice.
La personalizzazione non cambia stati HTTP, header dei tentativi successivi o identificativi delle richieste. Gli errori precedenti all’identificazione del sito, come un errore TLS iniziale o di analisi HTTP, non possono usare le sue impostazioni.
Se l’anteprima non si carica, seleziona Retry preview. Controlla colori non validi, limiti di testo o un URL di assistenza che non inizi con https://. Se una pagina mantiene un colore o un titolo precedente, seleziona il suo stato HTTP e cerca una personalizzazione specifica. Dopo il salvataggio, ricarica Configuration per verificare che i valori siano stati mantenuti.