Wenn etwas schiefgeht #

Diese Seite ist für alle, die auf einen Fehler stoßen: Redakteure in der Administration, Besucher der Site oder Administratoren, die ein Problem weitergeben. Sie erklärt, was die häufigen Fehlerseiten bedeuten, wen Sie informieren und wie Sie ein Problem so beschreiben, dass es behoben wird.

Zuerst: Ist es ein Fehler? #

Manche Seiten sehen wie Fehler aus, sagen aber nur, dass etwas nicht erlaubt oder nicht vorhanden ist:

Wenn wirklich etwas schiefgegangen ist #

Ein Fehler der Site zeigt eine Seite wie Bei uns ist etwas schiefgegangen, unten mit einer Referenz, zum Beispiel ERR-0123456789. Der Fehler ist bereits protokolliert; mit der Referenz findet ein Administrator genau diesen Moment in den Protokollen.

1. Notieren Sie die Referenz, die Uhrzeit und die Adresse der Seite (kopieren Sie sie aus der Adressleiste des Browsers).
2. Schreiben Sie auf, was Sie getan haben, Schritt für Schritt, unmittelbar vor dem Fehler: welche Seite, welche Schaltfläche, was Sie eingegeben haben.
3. Versuchen Sie es noch einmal. Funktioniert es jetzt, erwähnen Sie, dass es einmal passiert ist.
4. Informieren Sie Ihren Administrator (oder die Kontaktperson der Site) und geben Sie die Referenz, die Uhrzeit, die Adresse und die Schritte weiter. Administratoren finden die Anfrage anhand der Referenz, siehe Einen Fehler anhand seiner Referenz finden.

Ein Bildschirmfoto hilft, solange es keine Passwörter und keine personenbezogenen Daten anderer zeigt.

Einen Fehler in Exponential melden #

Bevor Sie ihn melden: Nicht alles, was wie ein Fehler aussieht, ist einer. Ein Verhalten kann beabsichtigt oder Auslegungssache sein, was Fachleute eine negative Funktion nennen. Eine Änderung daran kann jede Site betreffen, die sich darauf verlässt, und braucht deshalb eine starke Begründung und oft mehrere Runden der Prüfung. Siehe Negative Funktionen.

Stellt Ihr Administrator (oder Sie als Administrator) fest, dass das Problem in der Software selbst liegt und nicht in der Einrichtung der Site, melden Sie es öffentlich, damit es für alle behoben werden kann. Die Seite Fehler melden der Hilfe (exphelp/report in der Administration) führt Sie durch die Meldung, füllt eine Zusammenfassung der Installation für Sie aus und öffnet ein neues Issue mit vorbereitetem Titel und Text.

Wählen Sie den richtigen Tracker:

Um ein Issue zu eröffnen, brauchen Sie ein kostenloses GitHub-Konto. Durchsuchen Sie zuerst den Tracker: Ist das Problem bereits bekannt, ergänzen Sie Ihr Wissen in diesem Issue, statt ein neues zu eröffnen.

Eine gute Fehlerbeschreibung #

• Ein kurzer Titel, der das Problem benennt: Upload-Seite: ZIP-Datei mit einem Ordner scheitert mit „temp_dir“.
• Was Sie getan haben, Schritt für Schritt, damit jemand anderes es nachstellen kann.
• Was Sie erwartet haben und was stattdessen geschah, mit der genauen Meldung.
• Die Umgebung: die Exponential-Version, die PHP-Version, der Webserver (Exponential Velocity, Apache oder nginx mit PHP-FPM, FrankenPHP), die Datenbank und das Design der Administration. Die Seite Fehler melden und Setup > Systeminformationen (Bericht als Text kopieren) liefern Ihnen diese Zusammenfassung; beide lassen Passwörter, Schlüssel und Serverpfade weg.
• Protokollzeilen um den Zeitpunkt herum, wenn ein Administrator sie beschaffen kann; entfernen Sie vorher alles Private.

Schreiben Sie niemals Passwörter, Schlüssel, Sitzungs-Cookies, Datenbankadressen oder personenbezogene Daten von Kunden oder Benutzern in ein öffentliches Issue.

Noch besser: die Korrektur mitschicken #

Haben Sie die Ursache selbst gefunden, können Sie die Korrektur gleich mit der Meldung schicken. Ist der Code als Git-Klone installiert, ist eine Korrektur nur einen Branch in Ihrem Fork und einen Pull-Request entfernt, und sie erreicht mit dem nächsten Release jede Site. Mit Git entwickeln zeigt Schritt für Schritt, wie es geht. Erwähnen Sie das Issue im Pull-Request (zum Beispiel Fixes #123), damit beide verknüpft sind.

Sicherheitsprobleme #

Finden Sie ein Sicherheitsproblem, etwa eine Möglichkeit, etwas zu sehen oder zu ändern, das Sie nicht sehen oder ändern sollten, melden Sie es nicht in einem öffentlichen Tracker. Schicken Sie es vertraulich an [email protected], oder verwenden Sie die vertrauliche Meldung von Sicherheitslücken von GitHub im jeweiligen Repository. Nennen Sie die Version, die Sie betreiben, was ein Angreifer tun könnte und wie es sich nachstellen lässt. Die vollständige Richtlinie steht in der Datei SECURITY.md im Hauptverzeichnis der Installation.

„Diese Installation ist eine öffentliche Demo“. Diese Meldung oder ein Hinweisbalken Demo-Modus bedeutet, dass die Site absichtlich im Demo-Modus läuft: Administratorpasswörter lassen sich dort weder ändern noch zurücksetzen. Erscheint sie auf einer echten Site, informieren Sie sofort die Betreiber des Servers. Demo-Modus: häufige Fragen, Probleme mit dem Demo-Modus.

Um Hilfe bitten #

Für Fragen, die keine Fehler sind („Wie mache ich ...?“), ist die Community die richtige Anlaufstelle: die Foren der Exponential-Community, der Telegram-Community-Chat, der Discord-Server und der Slack-Workspace, alle kostenlos. Bevor Sie fragen, sehen Sie in der Exponential-Dokumentation, in eZpedia und in den Artikeln auf Share Exponential nach. Vielleicht haben auch die anderen Hilfeseiten schon die Antwort: siehe Hilfe für Redakteure und Benutzer.

Kostenlose Hilfe hängt von der Zeit ab, die Menschen geben; niemand verspricht deshalb eine Antwortzeit. Wenn Sie nicht warten können, empfiehlt die Support-Seite des Projekts den kostenpflichtigen Support von 7x, dem Unternehmen, das Exponential pflegt (se7enx.com/services). Beide Arten von Support erklärt Unterstützung erhalten.

Verwandte Seiten #

• Wenn eine Migration scheitert