Utiliser le mode sans échec pour dépanner les problèmes de thèmes et d'extensions

[Discourse]

Ce guide explique comment utiliser le mode sécurisé de Discourse pour résoudre les problèmes liés aux thèmes et aux plugins.

Niveau d’utilisateur requis : Tous les utilisateurs

Discourse propose un « mode sécurisé JavaScript » qui permet à tout utilisateur d’isoler la cause racine des problèmes JavaScript causés par des plugins, des thèmes ou des composants de thème. Cette fonctionnalité est particulièrement utile pour dépanner les problèmes sur votre site Discourse.

Accéder au mode sécurisé

Pour accéder au mode sécurisé, suivez ces étapes :

1. Ouvrez un nouvel onglet de navigateur.

2. Saisissez l’URL suivante dans la barre d’adresse, en remplaçant [your-site-name](http://discourse.example.com) par le domaine réel de votre site Discourse :

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

   Par exemple, l’URL du mode sécurisé pour le site de démonstration de Discourse est :
   https://try.discourse.org/safe-mode

3. Cliquez sur le bouton « Entrer en mode sécurisé » :
   

   

Options du mode sécurisé

Lors de l’entrée en mode sécurisé, vous pouvez sélectionner parmi les options suivantes :

• Désactiver les thèmes et les composants de thème
• Désactiver les personnalisations non officielles des plugins côté client
• Désactiver toutes les personnalisations des plugins côté client
• Faire en sorte que les avertissements de dépréciation JavaScript génèrent une erreur

Par défaut, les trois premières options sont sélectionnées. L’option relative aux erreurs de dépréciation est décochée par défaut et est principalement utile pour les développeurs de plugins et de thèmes testant la compatibilité avec les futures mises à jour de Discourse. Vous pouvez entrer en mode sécurisé plusieurs fois avec différentes combinaisons pour isoler le composant spécifique causant des problèmes sur votre site.

Utiliser le mode sécurisé

1. Sélectionnez les options souhaitées sur la page du mode sécurisé.
2. Cliquez sur « Entrer en mode sécurisé » pour appliquer vos sélections.
3. Vous verrez une bannière indiquant que le mode sécurisé est activé.
4. Parcourez votre site pour vérifier si le problème persiste avec les composants sélectionnés désactivés.

Quitter le mode sécurisé

Pour quitter le mode sécurisé, fermez simplement votre onglet de navigateur.

Notes importantes

Lorsque vous partagez un lien vers le mode sécurisé pour votre site, sachez qu’il doit être ouvert dans un nouvel onglet ou ajouté directement dans la barre d’adresse ; sinon, il pourrait ne pas fonctionner correctement.

Le mode sécurisé désactive actuellement uniquement les parties JavaScript des plugins. Pour désactiver la partie côté serveur d’un plugin, vous devez reconstruire votre conteneur avec le plugin commenté.

Dépannage

Si vous ne parvenez pas à charger la page initiale de sélection du mode sécurisé, essayez de visiter l’URL suivante, qui passera la page et chargera directement le mode sécurisé :

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

Par exemple : https://try.discourse.org/?safe_mode=no_themes,no_plugins

Les valeurs disponibles pour le paramètre de requête safe_mode sont : no_themes, no_unofficial_plugins, no_plugins et deprecation_errors. Ces valeurs peuvent être combinées avec des virgules.

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