Sicherer Modus verwenden, um Probleme mit Themes und Plugins zu beheben

[Discourse]

Dieser Leitfaden erklärt, wie Sie den Safe Mode von Discourse zur Fehlerbehebung bei Problemen mit Themes und Plugins verwenden können.

Erforderliche Benutzerstufe: Alle Benutzer

Discourse bietet einen „JavaScript Safe Mode", der es jedem Benutzer ermöglicht, die Ursache von JavaScript-Problemen zu isolieren, die durch Plugins, Themes oder Theme-Komponenten verursacht werden. Diese Funktion ist besonders nützlich, um Probleme auf Ihrer Discourse-Website zu diagnostizieren.

Zugriff auf den Safe Mode

Um den Safe Mode zu aktivieren, gehen Sie wie folgt vor:

1. Öffnen Sie einen neuen Browser-Tab.

2. Geben Sie die folgende URL in die Adressleiste ein und ersetzen Sie [your-site-name](http://discourse.example.com) durch Ihre tatsächliche Discourse-Domain:

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

   Zum Beispiel lautet die Safe-Mode-URL für die Discourse-Demo-Website:

   https://try.discourse.org/safe-mode

3. Klicken Sie auf die Schaltfläche „Safe Mode aktivieren":
   

   

Optionen im Safe Mode

Beim Aktivieren des Safe Mode können Sie folgende Optionen auswählen:

• Themes und Theme-Komponenten deaktivieren
• Inoffizielle clientseitige Plugin-Anpassungen deaktivieren
• Alle clientseitigen Plugin-Anpassungen deaktivieren
• JavaScript-Deprecations als Fehler auslösen

Standardmäßig sind die ersten drei Optionen ausgewählt. Die Option für Deprecation-Fehler ist standardmäßig deaktiviert und hauptsächlich für Plugin- und Theme-Entwickler nützlich, die die Kompatibilität mit kommenden Discourse-Updates testen. Sie können den Safe Mode mehrfach mit verschiedenen Kombinationen aufrufen, um die spezifische Komponente zu isolieren, die Probleme auf Ihrer Website verursacht.

Verwendung des Safe Mode

1. Wählen Sie auf der Safe-Mode-Seite die gewünschten Optionen aus.
2. Klicken Sie auf „Safe Mode aktivieren", um Ihre Auswahl zu übernehmen.
3. Sie sehen ein Banner, das anzeigt, dass der Safe Mode aktiviert ist.
4. Durchsuchen Sie Ihre Website, um zu prüfen, ob das Problem weiterhin besteht, wenn die ausgewählten Komponenten deaktiviert sind.

Verlassen des Safe Mode

Um den Safe Mode zu verlassen, schließen Sie einfach den Browser-Tab.

Wichtige Hinweise

Wenn Sie einen Safe-Mode-Link für Ihre Website teilen, beachten Sie, dass dieser in einem neuen Tab geöffnet oder direkt in die Adressleiste eingefügt werden muss; andernfalls funktioniert er möglicherweise nicht korrekt.

Der Safe Mode deaktiviert derzeit nur die JavaScript-Teile von Plugins. Um den serverseitigen Teil eines Plugins zu deaktivieren, müssen Sie Ihren Container neu erstellen, wobei das Plugin auskommentiert ist.

Fehlerbehebung

Wenn Sie die ursprüngliche Safe-Mode-Auswahlseite nicht laden können, versuchen Sie, die folgende URL aufzurufen. Diese überspringt die Seite und lädt den Safe Mode direkt:

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

Zum Beispiel: https://try.discourse.org/?safe_mode=no_themes,no_plugins

Die verfügbaren Werte für den Abfrageparameter safe_mode sind: no_themes, no_unofficial_plugins, no_plugins und deprecation_errors. Diese können mit Kommas kombiniert werden.

[Moin]

@sam

Discourse Meta

@sam

Example: Discourse Meta - The Official Support Forum for Discourse

Irgendwie funktionieren diese Links bei mir nur, wenn ich sie in einem neuen Tab oder Fenster öffne. Der erste Link führt zur Oops-Seite und der zweite zur Homepage. Aber das Safe-Mode-Banner erscheint nicht. Der zweite Link kann zu Problemen führen, wenn man einen Link an einen Benutzer sendet, damit dieser den Safe-Mode ausprobieren kann. Wenn er einfach auf den Link klickt, wird er die Seite immer noch ohne Safe-Mode nutzen.

Vielleicht sollten diese Informationen zu den how-to hinzugefügt werden.

[Ed_S]

Gut bemerkt – beide Links sind kaputt. Der erste braucht ein ? und der zweite ein Komma statt %2C

[Moin]

@Ed_S

Das erste braucht ein ?

Wo braucht es ein “?”?
Könnten Sie den Link als Beispiel teilen?

[Ed_S]

Oh, Entschuldigung, es sieht so aus, als hätte ich mich beim ersten Mal geirrt: Die interne Navigation schlägt fehl, aber für ein neues Fenster funktioniert sie.
Discourse Meta

Und ich habe mich auch beim anderen geirrt! Discourse Meta - The Official Support Forum for Discourse
funktioniert nicht als Navigation auf derselben Seite.

Mein Fehler: Etwas ist kaputt, aber es sind nicht die URLs.

[JammyDodger]

Ich glaube, das liegt daran, dass versucht wird, sie an Ort und Stelle zu öffnen. Anstatt mich damit zu streiten, habe ich sie durch try.discourse.org ersetzt.

[Moin]

Ich denke, Administratoren sollten trotzdem darüber informiert werden, dass das Teilen dieser Links leicht zu Problemen führen kann.

Zum Beispiel melde ich ein Problem auf Meta. Sie könnten fragen: „Könnten Sie https://meta.discourse.org/safe-mode ausprobieren?“ Dann würde ich Ihnen sagen, dass der Link nicht funktioniert.
Oder noch schlimmer: Sie möchten angeben, dass ich nur Themes deaktivieren soll, also bitten Sie mich, https://meta.discourse.org/?safe_mode=no_themes auszuprobieren. Mein Problem besteht weiterhin. Woher wissen Sie, dass ich wirklich den abgesicherten Modus verwendet habe? Als Benutzer denke ich, dass es funktioniert hat, weil etwas passiert ist, als ich auf den Link geklickt habe.

Nachdem ich hier gepostet habe, wissen Sie davon. Aber woher wissen andere Administratoren, dass sie darauf achten müssen, dass dies ein Problem sein könnte?

[Arkshine]

Ich frage mich, ob aufgrund der Art dieser sicheren Startseite, die den gesamten Inhalt ersetzt, eine Ausnahme gemacht werden sollte, um diesen Link in einem neuen Tab zu öffnen.

[JammyDodger]

Ich habe eine Notiz und auch einen Screenshot von einem ‘erfolgreichen’ hinzugefügt. Wie sieht das aus?