Este guia explica como usar o Modo Seguro do Discourse para solucionar problemas com temas e plugins.
Nível de usuário necessário: Todos os usuários
O Discourse oferece um “Modo Seguro de JavaScript” que permite a qualquer usuário isolar a causa raiz de problemas de JavaScript causados por plugins, temas ou componentes de tema. Este recurso é particularmente útil para solucionar problemas no seu site Discourse.
Acessando o Modo Seguro
Para acessar o Modo Seguro, siga estas etapas:
-
Abra uma nova aba do navegador.
-
Insira a seguinte URL na barra de endereços, substituindo
[your-site-name](http://discourse.example.com)pelo domínio real do seu site Discourse:http://discourse.example.com/safe-modePor exemplo, a URL do Modo Seguro para o site de demonstração do Discourse é:
https://try.discourse.org/safe-mode -
Clique no botão ‘Entrar no Modo Seguro’:
Opções do Modo Seguro
Ao entrar no Modo Seguro, você pode selecionar as seguintes opções:
- Desativar temas e componentes de tema
- Desativar personalizações de plugins não oficiais no lado do cliente
- Desativar todas as personalizações de plugins no lado do cliente
- Fazer com que avisos de depreciação do JavaScript gerem um erro
Por padrão, as três primeiras opções estão selecionadas. A opção de erros de depreciação está desmarcada por padrão e é principalmente útil para desenvolvedores de plugins e temas que testam a compatibilidade com futuras atualizações do Discourse. Você pode entrar no Modo Seguro várias vezes com diferentes combinações para isolar o componente específico que está causando problemas no seu site.
Usando o Modo Seguro
- Selecione as opções desejadas na página do Modo Seguro.
- Clique em “Entrar no Modo Seguro” para aplicar suas seleções.
- Você verá um banner indicando que o Modo Seguro está ativado.
- Navegue pelo seu site para verificar se o problema persiste com os componentes selecionados desativados.
Saindo do Modo Seguro
Para sair do Modo Seguro, basta fechar a aba do seu navegador.
Observações importantes
Ao compartilhar um link do Modo Seguro para o seu site, esteja ciente de que ele precisa ser aberto em uma nova aba ou adicionado diretamente à barra de endereços; caso contrário, pode não funcionar corretamente.
O Modo Seguro atualmente desativa apenas as partes de JavaScript dos plugins. Para desativar a parte do servidor de um plugin, você deve reconstruir seu contêiner com o plugin comentado.
Solução de problemas
Se você não conseguir carregar a página inicial de seleção do Modo Seguro, tente visitar a seguinte URL, que ignorará a página e carregará o Modo Seguro diretamente:
https://discourse.example.com/?safe_mode=no_themes,no_plugins
Por exemplo: https://try.discourse.org/?safe_mode=no_themes,no_plugins
Os valores disponíveis do parâmetro de consulta safe_mode são: no_themes, no_unofficial_plugins, no_plugins e deprecation_errors. Estes podem ser combinados com vírgulas.
