Das Instanzadministrationspanel

Das Instanzadministrationspanel unter /instance-admin ist der Ort, an dem ein Instanzadministrator über alle Konten des Servers hinweg schaut: wie viele es gibt, wer darin ist, und die Handvoll destruktiver Aktionen, die nur ein Betreiber innehaben sollte. Diese Seite beschreibt, was das Panel kann, und ebenso wichtig, was es bewusst nicht kann.

Wenn du eine private Instanz mit einem einzigen Konto betreibst, brauchst du dieses Panel vielleicht nie. Es lohnt sich auf gemeinsam genutzten Instanzen, etwa einem Vereins- oder Familienserver mit mehreren Konten.

Die Übersicht

Das Panel öffnet sich mit einer Übersicht über die gesamte Instanz:

• Anzahl von Konten, Benutzern, Sammlungen und Objekten über den ganzen Server hinweg.
• Diesen Monat erstellte Konten und diesen Monat aktive Benutzer, sodass du siehst, ob die Instanz wächst oder ruhig ist.
• Ein Diagramm der Anmeldungen pro Monat über die letzten zwölf Monate.

Diese Zahlen sind instanzweit. Sie geben keinen Einblick in den Inhalt der Kataloge einzelner Personen.

Konten durchsuchen

Der Bereich Konten listet jedes Konto der Instanz auf, 25 pro Seite, mit der Mitgliederzahl und Sammlungszahl jedes Kontos.

Du kannst Konten nach der E-Mail-Adresse eines Mitglieds suchen und nach Rolle filtern. Die Suche nach Konto- oder Personennamen ist nicht möglich, da Namen in der Datenbank verschlüsselt sind und dort nicht abgeglichen werden können. Die E-Mail-Adresse ist der verlässliche Ansatzpunkt.

Öffnest du ein Konto, siehst du dessen Mitglieder, sortiert erst nach Eigentümern, dann Bearbeitern, dann Betrachtern, zusammen mit den Sammlungs- und Objektzahlen des Kontos und seinen fünfzehn jüngsten Einträgen im Aktivitätsprotokoll.

Löschgründe

Wer sein Benutzerkonto löscht, wird vorher nach dem Grund gefragt, und im Bereich Löschgründe landen diese Antworten, die neueste zuerst, 25 pro Seite.

Ein Eintrag besteht aus einem Satz und einem Datum, mehr nicht. Er ist mit niemandem verknüpft und bleibt bestehen, wenn die Person weg ist: der Benutzer verschwindet, der Satz bleibt. Es gibt nichts zu öffnen und nichts zu tun, also listet die Seite die Gründe nur auf.

Die Gründe sind bei der Speicherung verschlüsselt, wie alles andere, was Menschen in der Anwendung schreiben, daher hat diese Seite kein Suchfeld.

Website-Optionen

Der Bereich Website-Optionen bündelt die Einstellungen der öffentlichen Marketing-Website, also der Seiten, die ein Besucher vor der Anmeldung sieht. Diese Website ist auf einer selbst gehosteten Instanz standardmäßig aus (siehe Deine Instanz konfigurieren). Wenn du sie nie eingeschaltet hast, ändert hier nichts daran, was deine Nutzer sehen.

Das Ankündigungsbanner

Das Banner ist der schwarze Balken oben auf jeder Seite der Marketing-Website. Es ist der Platz für einen kurzen Satz: eine Version, die auffallen soll, ein Wartungsfenster, eine Veranstaltung.

Nötig ist nur der Satz. Alles andere ist optional:

• Banner anzeigen schaltet es ein und aus. Stell es auf Nein, und es erscheint kein Balken, egal was du sonst ausgefüllt hast.
• Version ist die kleine grüne Pille links, etwa v0.9. Lass das Feld leer, und die Pille verschwindet.
• Link ist die Adresse, auf die das Banner zeigt, und Linktext ist das, worauf ein Besucher klickt. Lass den Link leer für ein Banner, das nur etwas mitteilt.
• Satz ist die Ankündigung selbst.

Die Marketing-Website wird in mehreren Sprachen ausgeliefert, deshalb werden Satz und Linktext eine Sprache nach der anderen geschrieben, mit je einem Reiter. Eine Sprache, die du leer lässt, fällt auf Englisch zurück. Nur Englisch auszufüllen reicht also schon für ein Banner für alle Besucher. Der grüne Punkt auf einem Reiter zeigt, dass diese Sprache einen eigenen Satz hat.

Die Vorschau über dem Formular zeigt den Balken so, wie ein Besucher ihn sehen wird, in der Sprache des Reiters, auf dem du gerade bist. Das Speichern leert für dich den Cloudflare-Cache, die Änderung ist also sofort sichtbar.

Den Cloudflare-Cache leeren

Marketing-Seiten ändern sich selten, deshalb wird jede einmal gerendert und danach sieben Tage lang von Cloudflare vorgehalten. Das hält die öffentliche Website schnell, bedeutet aber auch, dass eine Änderung eine Woche lang ungesehen bleiben kann.

Cache leeren verwirft auf einen Schlag alle Seiten, die Cloudflare vorhält. Greif darauf zurück, wenn du etwas geändert hast, das die öffentliche Website zeigt und wovon die Anwendung nichts weiß, etwa eine Dokumentationsseite, die du auf dem Server bearbeitet hast. Das Speichern des Banners und das Moderieren einer Bewertung leeren ihn bereits von selbst.

Beim Leeren geht nichts verloren. Jede Seite wird beim nächsten Aufruf neu gerendert, und der einzige Preis ist, dass der erste Besucher auf dieses Rendern wartet. Dasselbe geht auf der Kommandozeile mit php artisan kollek:purge-cloudflare-cache, beschrieben in Mit der Kommandozeile verwalten.

Dieser Abschnitt erscheint nur auf einer Instanz hinter Cloudflare, also einer, auf der CLOUDFLARE_API_TOKEN und CLOUDFLARE_ZONE_ID gesetzt sind. Ohne sie gibt es nichts zu leeren: eine direkt ausgelieferte Instanz rendert jede Seite dann, wenn sie angefragt wird. Beachte, dass der Browser des Besuchers eine Seite fünf Minuten lang behält, was auch immer du tust, und dass kein Leeren diese Kopie erreicht.

Die destruktiven Aktionen

Drei Aktionen im Panel ändern oder entfernen Daten, und keine davon lässt sich rückgängig machen:

• Ein Konto löschen, wodurch das Konto mit jeder Sammlung, jedem Objekt, jedem Exemplar, jedem Mitglied und der gesamten Historie darin entfernt wird.
• Einen Benutzer löschen, wodurch diese Person aus ihrem Konto entfernt wird.
• Das Administrator-Flag eines anderen Benutzers umschalten, wodurch jemand anderem die Instanzadministration gewährt oder entzogen wird.

Zwei Schutzmechanismen bewahren die Instanz vor sich selbst: Ein Administrator kann sich sein eigenes Flag nicht entziehen und seinen eigenen Benutzer nicht über das Panel löschen. Wie auch immer es genutzt wird, die Instanz behält mindestens einen funktionierenden Administrator.

Was das Panel nicht ist

Das Panel ist bewusst nur im Web verfügbar. Die JSON-API ist auf ein einzelnes Konto beschränkt, und eine instanzweite Oberfläche hat dort keinen Platz, also existiert keine dieser Fähigkeiten als API-Endpunkt.

Die im Panel sichtbaren Bereiche Support und Bewertungen sind Platzhalter und noch nicht umgesetzt. Siehe Funktionsstatus und Roadmap.

Wie es weitergeht

• Vergib oder entziehe das Flag selbst in Instanzadministrator-Zugriff gewähren.
• Verstehe, was Kontoeigentümer bereits ohne dich tun können, in Mitglieder und Rollen verwalten.
• Sieh dir die anderen Betreiberwerkzeuge in Mit der Kommandozeile verwalten an.