Usando Modo Seguro para solucionar problemas com temas e plugins

[Discourse]

This guide explains how to use Discourse’s Safe Mode to troubleshoot issues with themes and plugins.

Required user level: All users

Discourse offers a “JavaScript Safe Mode” that allows any user to isolate the root cause of JavaScript issues caused by plugins, themes, or theme components. This feature is particularly useful for troubleshooting problems on your Discourse site.

Accessing Safe Mode

To access Safe Mode, follow these steps:

1. Open a new browser tab.

2. Enter the following URL in the address bar, replacing [your-site-name](http://discourse.example.com) with your actual Discourse site domain:

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

   For example, the Safe Mode URL for the Discourse demo site is:
   https://try.discourse.org/safe-mode

3. Click the ‘Enter Safe Mode’ button:
   

   

Safe Mode options

When entering Safe Mode, you can select from the following options:

• Disable all themes and theme components
• Disable unofficial plugins
• Disable all plugins

By default, all three options are selected. However, you can enter Safe Mode multiple times with different combinations to isolate the specific component causing issues on your site.

Using Safe Mode

1. Select the desired options on the Safe Mode page.
2. Click “Enter Safe Mode” to apply your selections.
3. You will see a banner indicating that Safe Mode is enabled.
4. Browse your site to check if the issue persists with the selected components disabled.

Exiting Safe Mode

To exit Safe Mode, simply close your browser tab.

Important notes

When sharing a Safe Mode link for your site, be aware that it needs to be opened in a new tab or added directly to the address bar; otherwise, it may not work correctly.

Safe Mode currently only disables the JavaScript portions of plugins. To disable the server-side portion of a plugin, you must rebuild your container with the plugin commented out.

Troubleshooting

If you cannot load the initial Safe Mode selection page, try visiting the following URL, which will skip the page and load Safe Mode directly:

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

For example: https://try.discourse.org/?safe_mode=no_themes,no_plugins

On Discourse versions 2.9.0.beta8 and below, you need to use ?safe_mode=no_custom,no_plugins instead.

Last edited by @hugh 2024-07-30T05:32:08Z

Check document

Perform check on document:

[Moin]

@sam

Discourse Meta

@sam

Example: Discourse Meta - The Official Support Forum for Discourse

De alguma forma, para mim esses links só funcionam quando eu os abro em uma nova aba ou janela. O primeiro leva à página de erro e o segundo à página inicial. Mas o banner do modo de segurança não aparece. O segundo pode causar problemas quando você envia um link para um usuário para que ele tente o modo de segurança. Se eles apenas clicarem no link, eles ainda usarão o site sem o modo de segurança.

Talvez essa informação deva ser adicionada ao how-to.

[Ed_S]

Boa observação - ambos os links estão quebrados. O primeiro precisa de um ? e o segundo precisa de uma vírgula em vez de %2C

[Moin]

@Ed_S

O primeiro precisa de um ?

Onde ele precisa de um “?”?
Você poderia compartilhar o link como exemplo?

[Ed_S]

Ah, desculpe, parece que errei na primeira: a navegação interna falha, mas para uma nova janela funciona.
Discourse Meta

E também errei na outra! Discourse Meta - The Official Support Forum for Discourse
não funciona como navegação na mesma página.

Meu erro: algo está quebrado, mas não são os URLs.

[JammyDodger]

Acho que é porque ele está tentando abri-los no local. Em vez de discutir com ele, eu os troquei por try.discourse.org.

[Moin]

Eu acho que, de alguma forma, os administradores ainda deveriam ser informados de que compartilhar esses links pode facilmente ser um problema.

Por exemplo, eu reporto um problema no meta. Você poderia perguntar: “Você poderia tentar https://meta.discourse.org/safe-mode?” Então eu diria que o link não funciona.
Ou, pior ainda: você quer especificar que eu desabilite apenas os temas, então você me pede para tentar https://meta.discourse.org/?safe_mode=no_themes. Meu problema ainda existe. Como você tem certeza de que eu realmente usei o modo seguro? Como usuário, eu acho que funcionou porque algo aconteceu quando cliquei no link.

Depois que postei aqui, você sabe disso. Mas como outros administradores sabem que eles precisam prestar atenção que isso pode ser um problema?

[Arkshine]

Estou me perguntando, devido à natureza desta página inicial segura exibida (que substitui todo o conteúdo), se uma exceção deveria ser feita para abrir este link em uma nova aba.

[JammyDodger]

Adicionei uma nota e também uma captura de tela de uma bem-sucedida. Como isso parece?