Was dieses Plugin macht
Das LernHive Moodle-Core-Handbuch ergänzt den LernHive Help Hub um Schritt-für-Schritt-Anleitungen zu den Funktionen von Moodle selbst, zum Beispiel zu Kursen, Einschreibungen, Tests und der Bewertungsübersicht. Jedes Handbuch verlinkt seine Quelle in MoodleDocs und startet, wo LernHive eine anbietet, eine geführte Tour auf der passenden Moodle-Seite. Die Site-Administration kann eigene Handbücher für die Abläufe und Rollen ihrer Plattform ergänzen.
Für wen ist es
| Rolle | Was sie tut |
|---|---|
| Site-Administration | Lädt eigene Handbücher der Plattform hoch, aktualisiert und entfernt sie |
| Plattform-Administration | Liest die Moodle-Core- und die individuellen Handbücher im Help Hub und startet Touren |
| Trainer/in | Liest die Handbücher und startet Touren, sofern der Help Hub für sie freigegeben ist (siehe Relevante Einstellungen) |
Lernende und Führungskräfte erreichen den Help Hub nicht.
Kernkonzepte
- Help Hub: die Seite LernHive Handbuch, erreichbar über Hilfe im Launcher. Ihre Reiter sind LernHive (Handbücher der LernHive-Plugins), Moodle Core und Individuelle Konfiguration.
- Moodle-Core-Handbuch: ein Handbuch zu einer Moodle-Funktion, das mit diesem Plugin ausgeliefert wird, auf Deutsch und Englisch. Es lässt sich auf der Plattform nicht ändern.
- Individuelles Handbuch: eine Markdown-Datei (
.md), die die Site-Administration hochlädt. Sie erscheint im Reiter Individuelle Konfiguration. - Tour: eine geführte LernHive-Tour auf einer Moodle-Seite, bereitgestellt von LernHive Onboarding.
Abläufe nach Rolle
Site-Administration: individuelle Handbücher hinzufügen
- Schreiben Sie je Handbuch eine Markdown-Datei, gespeichert als UTF-8 mit der Endung
.md. Beginnen Sie mit einer Überschrift, zum Beispiel# Neue Trainer/innen einarbeiten, oder mit einem Kopfbereich:
---
titel: "Neue Trainer/innen einarbeiten"
---
Ergänzen Sie einen Abschnitt ## Worum es geht, dessen erster Absatz das Handbuch zusammenfasst; der Help Hub zeigt ihn auf der Kachel.
- Öffnen Sie Website-Administration → Plugins → Lokale Plugins → LernHive → LernHive Hilfe.
- Fügen Sie die Dateien im Feld Markdown-Handbücher hinzu, per Drag-and-drop oder über die Dateiauswahl.
- Wählen Sie Änderungen speichern. Die Meldung Die individuellen Handbücher wurden gespeichert. bestätigt das.
- Prüfen Sie das Ergebnis unter Hilfe (Launcher) → Individuelle Konfiguration.
Bereits hochgeladene Handbücher bleiben erhalten, wenn Sie die Seite erneut speichern.
Site-Administration: individuelles Handbuch aktualisieren oder entfernen
- Öffnen Sie Website-Administration → Plugins → Lokale Plugins → LernHive → LernHive Hilfe.
- Zum Aktualisieren löschen Sie die alte Datei im Feld Markdown-Handbücher und laden die neue Fassung hoch. Zum Entfernen wählen Sie die Datei aus und löschen sie.
- Wählen Sie Änderungen speichern.
Plattform-Administration: ein Moodle-Core-Handbuch lesen
- Öffnen Sie im Launcher Hilfe.
- Wählen Sie den Reiter Moodle Core. Grenzen Sie die Kacheln mit Handbücher durchsuchen … ein; die Suche umfasst den gesamten Handbuchtext.
- Öffnen Sie eine Kachel. Das Handbuch zeigt die Schritte; darunter finden Sie Original in MoodleDocs öffnen und, wo vorhanden, eine oder mehrere Schaltflächen Geführte Tour starten: ….
- Geführte Tour starten: … öffnet die Moodle-Seite der Tour und startet sie.
Ein Handbuch in einer anderen Sprache als Ihrer trägt das Kennzeichen Nur Englisch oder Nur Deutsch.
Plattform-Administration: individuelle Handbücher lesen
- Öffnen Sie im Launcher Hilfe und wählen Sie den Reiter Individuelle Konfiguration.
- Öffnen Sie eine Kachel, um das Handbuch zu lesen. Ist noch kein Handbuch hochgeladen, zeigt der Reiter Noch keine individuelle Dokumentation; die Site-Administration sieht dort zusätzlich einen Link LernHive Hilfe zur Upload-Seite.
Trainer/in: ein Handbuch lesen und eine Tour starten
- Öffnen Sie im Launcher Hilfe.
- Wählen Sie Moodle Core, öffnen Sie ein Handbuch und wählen Sie Geführte Tour starten: …, um den Schritt direkt in Moodle zu üben.
- Die individuellen Handbücher Ihrer Plattform finden Sie unter Individuelle Konfiguration.
Relevante Einstellungen
Das Plugin hat keine Einstellungen. LernHive Hilfe ist eine Verwaltungsseite für die Site-Administration. Der Zugriff wird über Berechtigungen gesteuert:
| Berechtigung | Wirkung | Standard |
|---|---|---|
moodle/site:config | Individuelle Handbücher auf LernHive Hilfe hochladen und entfernen | Site-Administration |
LernHive-Support anzeigen (local/lernhive:viewsupport) | Den Help Hub mit allen Reitern öffnen | Moodle-Rolle Manager/in; außerdem die Systemrolle LernHive Trainer/in aus LernHive Onboarding |
local/lernhive_onboarding:viewtours (im Systemkontext oder in mindestens einem Kurs) | Die Schaltflächen Geführte Tour starten: … sehen | Manager/in, Trainer/in und Trainer/in ohne Bearbeitungsrecht |
Trainer/innen, die nur eine Kursrolle haben, sehen Hilfe im Launcher erst, wenn die Site-Administration ihnen die Systemrolle LernHive Trainer/in (oder eine andere Rolle mit LernHive-Support anzeigen) zuweist.
Grenzen
- Die Moodle-Core-Handbücher stehen je Version fest und lassen sich auf der Plattform nicht bearbeiten. Beschreiben Sie Abweichungen Ihrer Plattform in einem individuellen Handbuch.
- Moodle-Core-Handbücher gibt es auf Deutsch und Englisch. Wer eine andere Sprache eingestellt hat, sieht die englische Fassung mit dem Kennzeichen Nur Englisch.
- Original in MoodleDocs öffnen öffnet die deutsche MoodleDocs-Seite, aus der das Handbuch abgeleitet ist, auch aus der englischen Fassung.
- Die Handbücher werden nicht automatisch aus MoodleDocs aktualisiert; sie sind gegen Moodle 5.2 geprüft.
- Tour-Schaltflächen erscheinen nur bei Moodle-Core-Handbüchern, nur wenn LernHive Onboarding installiert ist, und nur für LernHive-Touren der passenden Moodle-Seite. Manuell angelegte Touren der Plattform werden nie angeboten.
- Individuelle Handbücher:
- Nur
.md-Dateien lassen sich hochladen, im Rahmen der maximalen Upload-Größe der Plattform. Bilder lassen sich nicht hochladen, und relative Bildverweise werden nicht angezeigt. - Jedes Handbuch ist für alle sichtbar, die den Help Hub öffnen können, in jeder Sprache. Eine Auswahl nach Rolle oder Sprache gibt es nicht.
- Aus dem Kopfbereich wird nur
titel(odertitle) verwendet; andere Schlüssel haben keine Wirkung. Verwenden Sie nur einfache Zeilenschlüssel: wert, keine Listen oder verschachtelten Blöcke.
- Nur
- LernHive Hilfe steht nur der Site-Administration zur Verfügung.
Fehlerbehebung
| Symptom | Prüfen | Lösung |
|---|---|---|
| Der Reiter Moodle Core fehlt | Ist das LernHive Moodle-Core-Handbuch installiert? | Plugin installieren; ohne es zeigt der Help Hub nur LernHive und Individuelle Konfiguration |
| Individuelle Konfiguration zeigt nach einem Upload Noch keine individuelle Dokumentation | Wurde Änderungen speichern gewählt? Endet die Datei auf .md? | Datei erneut hochladen und speichern |
| Ein individuelles Handbuch trägt den Dateinamen als Titel | Kopfbereich und erste Überschrift | titel: "…" im Kopfbereich oder eine erste Zeile # … ergänzen |
| Die Kachel zeigt „Kuratiertes Handbuch zu einer Moodle-Core-Funktion.“ | Abschnitt ## Worum es geht, ## Purpose oder ## Overview | Abschnitt mit einem ersten Absatz ergänzen |
| Keine Schaltfläche Geführte Tour starten: … | LernHive Onboarding installiert? Tour aktiviert? Hat Ihre Rolle local/lernhive_onboarding:viewtours? | Tour installieren oder aktivieren bzw. Rolle zuweisen; manche Handbücher haben keine Tour |
| Nach Geführte Tour starten: … zeigt der Tour-Katalog Diese Tour ist gesperrt, bis Sie ihre Vorläufer-Tour abgeschlossen haben. | Reihenfolge der Touren im Katalog | Zuerst die vorhergehende Tour abschließen |
| Nach Geführte Tour starten: … erscheint Diese Tour gehört zu einem Funktionsbereich, der auf dieser Website abgeschaltet ist. | Funktionsbereiche von LernHive Onboarding | Die Site-Administration bitten, den Bereich einzuschalten |
| Hilfe fehlt im Launcher | LernHive-Support anzeigen | Rolle LernHive Trainer/in oder eine andere Rolle mit dieser Berechtigung zuweisen |
Screenshots
Noch keine Screenshots vorhanden.