Usar el modo seguro para solucionar problemas con temas y plugins

[Discourse]

Esta guía explica cómo usar el Modo Seguro de Discourse para solucionar problemas con temas y complementos.

Nivel de usuario requerido: Todos los usuarios

Discourse ofrece un “Modo Seguro de JavaScript” que permite a cualquier usuario aislar la causa raíz de problemas de JavaScript causados por complementos, temas o componentes de temas. Esta función es particularmente útil para solucionar problemas en tu sitio de Discourse.

Acceder al Modo Seguro

Para acceder al Modo Seguro, sigue estos pasos:

1. Abre una nueva pestaña del navegador.

2. Ingresa la siguiente URL en la barra de direcciones, reemplazando [tu-sitio-web](http://discourse.example.com) con el dominio real de tu sitio de Discourse:

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

   Por ejemplo, la URL del Modo Seguro para el sitio de demostración de Discourse es:
   https://try.discourse.org/safe-mode

3. Haz clic en el botón ‘Entrar en Modo Seguro’:
   

   

Opciones del Modo Seguro

Al entrar en Modo Seguro, puedes seleccionar entre las siguientes opciones:

• Desactivar temas y componentes de temas
• Desactivar personalizaciones de complementos no oficiales en el lado del cliente
• Desactivar todas las personalizaciones de complementos en el lado del cliente
• Hacer que las advertencias de JavaScript generen un error

De forma predeterminada, las primeras tres opciones están seleccionadas. La opción de errores de advertencia no está marcada por defecto y es principalmente útil para desarrolladores de complementos y temas que prueban la compatibilidad con futuras actualizaciones de Discourse. Puedes entrar en Modo Seguro varias veces con diferentes combinaciones para aislar el componente específico que causa problemas en tu sitio.

Usar el Modo Seguro

1. Selecciona las opciones deseadas en la página del Modo Seguro.
2. Haz clic en “Entrar en Modo Seguro” para aplicar tus selecciones.
3. Verás un banner que indica que el Modo Seguro está activado.
4. Navega por tu sitio para verificar si el problema persiste con los componentes seleccionados desactivados.

Salir del Modo Seguro

Para salir del Modo Seguro, simplemente cierra la pestaña de tu navegador.

Notas importantes

Al compartir un enlace del Modo Seguro para tu sitio, ten en cuenta que debe abrirse en una nueva pestaña o agregarse directamente a la barra de direcciones; de lo contrario, es posible que no funcione correctamente.

El Modo Seguro actualmente solo desactiva las partes de JavaScript de los complementos. Para desactivar la parte del servidor de un complemento, debes reconstruir tu contenedor con el complemento comentado.

Solución de problemas

Si no puedes cargar la página inicial de selección del Modo Seguro, intenta visitar la siguiente URL, que omitirá la página y cargará el Modo Seguro directamente:

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

Por ejemplo: https://try.discourse.org/?safe_mode=no_themes,no_plugins

Los valores disponibles del parámetro de consulta safe_mode son: no_themes, no_unofficial_plugins, no_plugins y deprecation_errors. Estos pueden combinarse con comas.

[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?