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.