Utiliser le mode sans échec pour diagnostiquer des problèmes avec les thèmes et les 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

Pour une raison quelconque, ces liens ne fonctionnent que lorsque je les ouvre dans un nouvel onglet ou une nouvelle fenêtre. Le premier mène à la page “oops” et le second à la page d’accueil. Mais la bannière du mode sécurisé n’apparaît pas. Le second peut causer des problèmes lorsque vous envoyez un lien à un utilisateur pour qu’il essaie le mode sécurisé. S’il clique simplement sur le lien, il utilisera toujours le site sans le mode sécurisé.

Peut-être que cette information devrait être ajoutée à la section how-to.

[Ed_S]

Bien vu - les deux liens sont défectueux. Le premier a besoin d’un ? et le second d’une virgule au lieu de %2C

[Moin]

@Ed_S

Le premier a besoin d’un ?

Où a-t-il besoin d’un « ? » ?
Pourriez-vous partager le lien comme exemple ?

[Ed_S]

Oh, désolé, il semble que je me trompe sur le premier : la navigation interne échoue, mais pour une nouvelle fenêtre, cela fonctionne.
Discourse Meta

Et je me trompe aussi sur l’autre ! Discourse Meta - Le forum officiel de support pour Discourse
ne fonctionne pas comme une navigation sur la même page.

Mon erreur : quelque chose est cassé, mais ce ne sont pas les URL.

[JammyDodger]

Je pense que c’est parce qu’il essaie de les ouvrir sur place. Plutôt que de discuter avec, je les ai remplacés par try.discourse.org.

[Moin]

Je pense que les administrateurs devraient quand même être informés que le partage de ces liens peut facilement poser problème.

Par exemple, je signale un problème sur meta. Vous pourriez demander : « Pourriez-vous essayer https://meta.discourse.org/safe-mode ? » Ensuite, je vous dirais que le lien ne fonctionne pas.
Ou pire encore : vous voulez spécifier que je désactive uniquement les thèmes, alors vous me demandez d’essayer https://meta.discourse.org/?safe_mode=no_themes. Mon problème existe toujours. Comment êtes-vous sûr que j’ai vraiment utilisé le mode sans échec ? En tant qu’utilisateur, je pense que cela a fonctionné car quelque chose s’est passé lorsque j’ai cliqué sur le lien.

Après que j’ai posté ici, vous êtes au courant de cela. Mais comment les autres administrateurs savent-ils qu’ils doivent faire attention à ce que cela puisse être un problème ?

[Arkshine]

Je me demande, étant donné la nature de cette page d’accueil sécurisée affichée (qui remplace tout le contenu), s’il ne faudrait pas faire une exception pour ouvrir ce lien dans un nouvel onglet.

[JammyDodger]

J’ai ajouté une note ainsi qu’une capture d’écran d’une réussite. Qu’en pensez-vous ?