Usando modo seguro para solucionar problemas con temas y 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

Por alguna razón, para mí esos enlaces solo funcionan cuando los abro en una pestaña o ventana nueva. El primero lleva a la página de error y el segundo a la página de inicio. Pero el banner de modo seguro no aparece. El segundo puede causar problemas cuando envías un enlace a un usuario para que pruebe el modo seguro. Si simplemente hacen clic en el enlace, seguirán usando el sitio sin modo seguro.

Quizás esta información debería añadirse a how-to.

[Ed_S]

Buena observación: ambos enlaces están rotos. El primero necesita un ? y el segundo necesita una coma en lugar de %2C

[Moin]

@Ed_S

¿El primero necesita un “?”?

¿Dónde necesita un “?”?
¿Podrías compartir el enlace como ejemplo?

[Ed_S]

Oh, lo siento, parece que me equivoqué en la primera: la navegación interna falla, pero para una ventana nueva funciona.
Discourse Meta

¡Y también me equivoqué en la otra! Discourse Meta - The Official Support Forum for Discourse
no funciona como una navegación en la misma página.

Mi error: algo está roto, pero no son las URL.

[JammyDodger]

Creo que es porque está intentando abrirlos en su lugar. En lugar de discutir con él, los he cambiado por try.discourse.org.

[Moin]

Creo que de alguna manera los administradores aún deberían ser informados de que compartir esos enlaces puede ser fácilmente un problema.

Por ejemplo, informo de un problema en meta. Podrías preguntar: “¿Podrías probar https://meta.discourse.org/safe-mode?” Entonces te diría que el enlace no funciona.
O aún peor: quieres especificar que solo deshabilito temas, así que me pides que pruebe https://meta.discourse.org/?safe_mode=no_themes. Mi problema todavía existe. ¿Cómo estás seguro de que realmente usé el modo seguro? Como usuario, creo que funcionó porque algo sucedió cuando hice clic en el enlace.

Después de que publiqué aquí, lo sabes. Pero, ¿cómo saben otros administradores que tienen que prestar atención a que esto podría ser un problema?

[Arkshine]

Me pregunto si, dada la naturaleza de esta página de inicio segura que reemplaza todo el contenido, se debería hacer una excepción para abrir este enlace en una nueva pestaña.

[JammyDodger]

He añadido una nota y también una captura de pantalla de una exitosa. ¿Qué te parece?