Utilizza la Modalità Provvisoria per risolvere problemi con temi e plugin

[Discourse]

Questa guida spiega come utilizzare la Modalità Sicura di Discourse per risolvere i problemi relativi a temi e plugin.

Livello utente richiesto: Tutti gli utenti

Discourse offre una “Modalità Sicura JavaScript” che consente a qualsiasi utente di isolare la causa principale dei problemi JavaScript causati da plugin, temi o componenti dei temi. Questa funzionalità è particolarmente utile per la risoluzione dei problemi sul tuo sito Discourse.

Accesso alla Modalità Sicura

Per accedere alla Modalità Sicura, segui questi passaggi:

1. Apri una nuova scheda del browser.

2. Inserisci il seguente URL nella barra degli indirizzi, sostituendo [your-site-name](http://discourse.example.com) con il dominio effettivo del tuo sito Discourse:

   http://discourse.example.com/safe-mode
   

   Ad esempio, l’URL della Modalità Sicura per il sito dimostrativo di Discourse è:

   https://try.discourse.org/safe-mode

3. Fai clic sul pulsante ‘Entra in Modalità Sicura’:
   

   

Opzioni della Modalità Sicura

Quando si entra in Modalità Sicura, è possibile selezionare le seguenti opzioni:

• Disabilita temi e componenti dei temi
• Disabilita le personalizzazioni dei plugin client non ufficiali
• Disabilita tutte le personalizzazioni dei plugin client
• Fai sì che gli avvisi di deprecazione JavaScript generino un errore

Per impostazione predefinita, sono selezionate le prime tre opzioni. L’opzione relativa agli errori di deprecazione è deselezionata per impostazione predefinita ed è principalmente utile per gli sviluppatori di plugin e temi che testano la compatibilità con gli aggiornamenti imminenti di Discourse. Puoi entrare in Modalità Sicura più volte con diverse combinazioni per isolare il componente specifico che causa problemi sul tuo sito.

Utilizzo della Modalità Sicura

1. Seleziona le opzioni desiderate nella pagina della Modalità Sicura.
2. Fai clic su “Entra in Modalità Sicura” per applicare le tue selezioni.
3. Vedrai un banner che indica che la Modalità Sicura è abilitata.
4. Esplora il tuo sito per verificare se il problema persiste con i componenti selezionati disabilitati.

Uscita dalla Modalità Sicura

Per uscire dalla Modalità Sicura, chiudi semplicemente la scheda del browser.

Note importanti

Quando condividi un link della Modalità Sicura per il tuo sito, tieni presente che deve essere aperto in una nuova scheda o aggiunto direttamente alla barra degli indirizzi; altrimenti, potrebbe non funzionare correttamente.

La Modalità Sicura attualmente disabilita solo le parti JavaScript dei plugin. Per disabilitare la parte lato server di un plugin, devi ricostruire il tuo contenitore con il plugin commentato.

Risoluzione dei problemi

Se non riesci a caricare la pagina iniziale di selezione della Modalità Sicura, prova a visitare il seguente URL, che ignorerà la pagina e caricherà direttamente la Modalità Sicura:

https://discourse.example.com/?safe_mode=no_themes,no_plugins

Ad esempio: https://try.discourse.org/?safe_mode=no_themes,no_plugins

I valori disponibili per il parametro di query safe_mode sono: no_themes, no_unofficial_plugins, no_plugins e deprecation_errors. Questi possono essere combinati con le virgole.

[Moin]

@sam

Discourse Meta

@sam

Example: Discourse Meta - The Official Support Forum for Discourse

In qualche modo, per me quei link funzionano solo quando li apro in una nuova scheda o finestra. Il primo porta alla pagina oops e il secondo alla homepage. Ma il banner della modalità sicura non appare. Il secondo può causare problemi quando invii un link a un utente per fargli provare la modalità sicura. Se cliccano semplicemente sul link, utilizzeranno comunque il sito senza la modalità sicura.

Forse queste informazioni dovrebbero essere aggiunte a how-to.

[Ed_S]

Ottima osservazione: entrambi i link sono rotti. Il primo necessita di un ? e il secondo di una virgola al posto di %2C

[Moin]

@Ed_S

Il primo ha bisogno di un “?”

Dove serve un “?”?
Potresti condividere il link come esempio?

[Ed_S]

Oh, mi dispiace, sembra che mi sia sbagliato sulla prima: la navigazione interna fallisce, ma per una nuova finestra funziona.
Discourse Meta

E mi sbaglio anche sull’altro! Discourse Meta - The Official Support Forum for Discourse
non funziona come navigazione nella stessa pagina.

Mi scuso: qualcosa non va, ma non sono gli URL.

[JammyDodger]

Penso che sia perché sta cercando di aprirli sul posto. Piuttosto che discutere con esso, li ho sostituiti con try.discourse.org.

[Moin]

Penso che in qualche modo gli amministratori debbano comunque essere informati che la condivisione di tali link può facilmente essere un problema.

Ad esempio, segnalo un problema su meta. Potresti chiedere: “Potresti provare https://meta.discourse.org/safe-mode?” Quindi ti direi che il link non funziona.
O ancora peggio: vuoi specificare che disabilito solo i temi, quindi mi chiedi di provare https://meta.discourse.org/?safe_mode=no_themes. Il mio problema esiste ancora. Come fai a sapere se ho davvero usato la modalità sicura? Come utente, penso che abbia funzionato perché è successo qualcosa quando ho cliccato sul link.

Dopo che ho postato qui, ne sei a conoscenza. Ma come fanno gli altri amministratori a sapere che devono prestare attenzione al fatto che questo potrebbe essere un problema?

[Arkshine]

Mi chiedo, data la natura di questa home page sicura visualizzata (che sostituisce tutto il contenuto), se si dovrebbe fare un’eccezione per aprire questo link in una nuova scheda.

[JammyDodger]

Ho aggiunto una nota e anche uno screenshot di uno ‘riuscito’. Come ti sembra?