LernHive Konfiguration

Was dieses Plugin macht

Das Konfigurations-Cockpit macht die LernHive-relevanten Einstellungen einer Site an einem Ort überprüfbar. Es zeigt die aktuellen Werte einer kuratierten Menge verwalteter Einstellungen, vergleicht sie mit einer gewählten Flavour-Basis und lässt einen Administrator einen Snapshot dieser Werte zur Dokumentation erfassen. Der einzige schreibende Weg im Cockpit ist das Wiederherstellen eines Snapshots; das Anwenden einer Flavour-Basis geschieht auf der eigenen Seite Flavour-Setup.

Für wen ist es

Der Zugriff erfordert die Fähigkeit local/lernhive_configuration:manage, die standardmäßig dem Archetyp manager gewährt wird. Das Cockpit steht für alle mit dieser Fähigkeit in der Website-Administration: Site-Administratoren finden Konfigurations-Cockpit unter Website-Administration → Plugins → Lokale Plugins → LernHive, die Plattform-Administration direkt unter Lokale Plugins. Auch die Kachel Einrichtung im Admin-Cockpit verlinkt es.

Kernkonzepte

Verwaltete Einstellung

Eine Einstellung aus einer festen Allowlist von local_lernhive-Einstellungen, die das Cockpit anzeigt — derzeit: Standard-LernHive-Level, Level-Bar anzeigen, Kurserstellung für Lehrende erlauben, Nutzererstellung für Lehrende erlauben, Nutzerliste für Lehrende freigeben, Elternkategorie für Lehrende. Die Werte werden aus Moodles normalem Konfigurationsspeicher gelesen; es gibt keine zweite Quelle der Wahrheit.

Flavour

Eine benannte, empfohlene Basis von Werten: Schule, LXP, Higher Ed, Corporate. Die Wahl eines Flavours ändert nur, wogegen der Vergleich vergleicht — es wird nichts angewendet.

Abweichung

Eine verwaltete Einstellung, deren aktueller Wert vom empfohlenen Wert des gewählten Flavours abweicht. Der Überblick zeigt einen Zähler Flavour-Abweichungen.

Snapshot

Eine mit Zeitstempel und Urheber versehene Erfassung der aktuellen verwalteten Werte, die als Verlauf gespeichert wird. Snapshots haben eine Bezeichnung, einen Quelltyp (manuell, Flavour-Anwendung oder Rollback) und einen Erstellungszeitpunkt. Ein früherer Snapshot kann in der Historie ausgewählt und wiederhergestellt werden; dabei entstehen eigene Vorher-/Nachher-Snapshots und ein Audit-Eintrag.

Abläufe nach Rolle

Plattform-Administration: verwaltete Einstellungen gegen eine Flavour-Basis prüfen

1. Öffnen Sie das Konfigurations-Cockpit (Website-Administration → Plugins → Lokale Plugins → LernHive → Konfigurations-Cockpit, die Kachel Einrichtung im Admin-Cockpit oder /local/lernhive_configuration/manage.php).
2. Die Karte Überblick zeigt Aktives Flavour, die Anzahl Verwaltete Einstellungen und den Zähler Flavour-Abweichungen.
3. Wählen Sie unter Flavour-Basis ein Flavour im Dropdown und klicken Sie auf Flavour anzeigen. Eine Kurzbeschreibung des gewählten Flavours erscheint.
4. Die Tabelle Verwaltete Einstellungen listet jede Einstellung mit Gruppe, Einstellung, Aktueller Wert, Flavour-Wert und Status — Entspricht dem Flavour, Überschrieben oder Im Flavour nicht gesetzt. Boolesche Werte erscheinen als Ja / Nein; fehlende Werte als Nicht gesetzt.
5. Um Abweichungen zu ändern, öffnen Sie Flavour-Setup. Selektive Flavour-Anwendungen und ihre Sicherheitsprüfung erfolgen auf dieser eigenen Seite.

Plattform-Administration: einen Konfigurations-Snapshot erfassen

1. Klicken Sie auf derselben Seite unter Historie auf Snapshot anlegen.
2. Die aktuellen verwalteten Werte werden als Manueller Snapshot gespeichert; die Bestätigung Snapshot angelegt. erscheint.
3. Die letzten fünf Snapshots werden darunter in der Form „Bezeichnung (Typ) am Datum" gelistet. Vor der ersten Erfassung steht dort Es wurden noch keine Snapshots angelegt.

Plattform-Administration: einen Snapshot wiederherstellen

1. Suchen Sie unter Historie den gewünschten Snapshot in der Liste der letzten fünf.
2. Klicken Sie in dessen Zeile auf Snapshot wiederherstellen. Eine Bestätigungsseite nennt den Snapshot und weist darauf hin, dass die verwalteten Einstellungen mit seinen Werten überschrieben werden; bestätigen Sie mit Snapshot wiederherstellen. Die verwalteten Werte werden nur über die Registry-Allowlist wiederhergestellt.
3. Bestätigen Sie sicherheitsrelevante Änderungen über Ich habe die sicherheitsrelevanten Änderungen geprüft; ohne diese Bestätigung wird eine Wiederherstellung mit sensiblen Werten abgelehnt. Die Rollback-Historie bleibt erhalten; kein vorhandener Snapshot wird gelöscht.
4. Die Tabelle Angewendete Änderungen unter der Snapshot-Liste protokolliert jeden Vorgang mit Zeitpunkt, Art (Flavour angewendet / Snapshot wiederhergestellt), betroffenem Flavour, geänderten Einstellungen und auslösendem Konto.

Plattform-Administration: verwaltetes Wording und Metadatenfelder einsehen

1. Die Karte Verwaltete Wording-Registry listet kuratierte Beschriftungen, Überschriften, Handlungsaufforderungen und Formular-Hilfetexte mit Kategorie und Sensibilität. Sie ist reine Metadatenbeschreibung — es werden keine Moodle-Sprachanpassungen geschrieben.
2. Die Karte Kurs-Metadatenfelder listet die gewünschten Custom-Field-Definitionen mit Kurzname, Feld und Moodle-Feldtyp. Auch sie werden von dieser Seite weder angelegt noch geändert.

Plattform-Administration: Unterschiede vergleichen und exportieren

1. Die Karte Konfigurationsunterschiede zeigt unter Aktuell gegen zuletzt angewendet, wie die heutigen Werte vom Stand nach dem letzten protokollierten Vorgang abweichen. Ohne protokollierten Vorgang steht dort Es liegt keine angewendete Konfiguration zum Vergleich vor.
2. Unter Snapshots vergleichen wählen Sie zwei Snapshots als Vorher und Nachher und klicken auf Snapshots vergleichen. Die Tabelle markiert jede Zeile als Hinzugefügt, Entfernt, Geändert oder Unverändert. Mit weniger als zwei Snapshots erscheint stattdessen Legen Sie mindestens zwei Snapshots an, um sie zu vergleichen.
3. Ist JSON-Export erlauben aktiviert, exportiert Aktuelle Einstellungen exportieren den heutigen Stand als JSON-Datei; neben jedem Snapshot in der Historie steht dafür JSON exportieren. Sensibel eingestufte Einstellungen sind in beiden Exporten und in allen Vergleichen ausgenommen.

Site-Administrator (eLeDia): die eigenen Einstellungen des Cockpits prüfen

1. Gehen Sie zu Website-Administration → Plugins → Lokale Plugins → Konfigurations-Einstellungen.
2. Die Seite enthält eine Option, JSON-Export erlauben. Sie ist standardmäßig aus; erst mit ihr erscheinen die Export-Links im Cockpit.

Relevante Einstellungen

Grenzen

• Das Anwenden eines Flavours und das Zurückrollen sind auf registrierte Einstellungen begrenzt und werden mit Vorher-/Nachher-Snapshots protokolliert.
• Nur die sechs kuratierten local_lernhive-Schlüssel werden verwaltet; andere Moodle-Einstellungen erscheinen nie.
• Snapshots lassen sich paarweise vergleichen und über die Historie wiederherstellen; einen Einzelsnapshot in der Oberfläche zu öffnen, ist nicht vorgesehen — dafür gibt es den JSON-Export.
• Vergleiche und Exporte lassen sensibel eingestufte Einstellungen grundsätzlich aus; sie erscheinen nur in der Tabelle Verwaltete Einstellungen.
• Apply- und Rollback-Vorgänge werden protokolliert und unter Angewendete Änderungen angezeigt.
• Die Flavour-Liste dieses Plugins ist ein statischer Katalog zum Vergleichen; sie ist unabhängig vom Anwenden eines Flavours über LernHive Flavour.

Fehlerbehebung

Eine Einstellung zeigt „Überschrieben", obwohl ich sie nie geändert habe. → „Überschrieben" bedeutet, dass der aktuelle Wert von der Empfehlung des gewählten Flavours abweicht — einschließlich Werten aus Installationsvorgaben oder einem anderen Flavour. Stellen Sie das Flavour-Dropdown auf die Basis, der Ihre Site tatsächlich folgt.

Eine Einstellung zeigt „Im Flavour nicht gesetzt". → Das gewählte Flavour empfiehlt für diesen Schlüssel schlicht keinen Wert; das ist informativ, kein Fehler.

Ich möchte eine Abweichung direkt im Cockpit beheben. → Das Cockpit selbst liest nur. Nutzen Sie Flavour-Setup öffnen, um Flavour-Abweichungen anzuwenden, oder ändern Sie den Wert auf den LernHive-Admin-Einstellungsseiten (z. B. Level-Konfiguration) und laden Sie das Cockpit neu, um zu bestätigen, dass der Status auf Entspricht dem Flavour gewechselt ist.

Die Cockpit-Seite ist für eine/n Nutzer/in nicht erreichbar. → Sie erfordert die Fähigkeit local/lernhive_configuration:manage (standardmäßig Plattform-Administration / Archetyp manager und Site-Admins).