LernHive Onboarding

Was dieses Plugin macht

LernHive Onboarding bringt Trainer/innen ihre Plattform Schritt für Schritt bei. Geführte, interaktive Touren begleiten eine/n Trainer/in durch jede Funktion des aktuellen LernHive-Levels — Nutzer/innen anlegen, einschreiben, Kurse aufbauen, Aktivitäten hinzufügen, kommunizieren — direkt in der echten Oberfläche. Ein Dashboard-Banner lädt neue Trainer/innen ein, ein Tour-Katalog verfolgt den Fortschritt pro Thema, und abgeschlossene Level bereiten auf das nächste vor.

Für wen ist es

Die Onboarding-Zielgruppe ist fähigkeitsbasiert: Das Banner erfordert Trainer-Onboarding-Banner auf dem Dashboard sehen (nur über die dedizierte Rolle LernHive Trainer/in vergeben), der Katalog erfordert Onboarding-Touren anzeigen im Systemkontext oder in mindestens einem Kurs. Trainer/innen und Trainer/innen ohne Bearbeitungsrecht haben das Recht in ihren Kursen, eine Kursrolle genügt also. Die Systemrolle LernHive Trainer/in (lernhive_trainer, Website-Administration → Nutzer/innen → Rechte ändern → Globale Rollen zuweisen) vergibt es an Trainer/innen ohne Kursrolle. Manager/innen und Website-Administrator/innen haben es standardmäßig. Lernende sehen im aktuellen Release kein Onboarding; die Erweiterung der Zielgruppe für das LXP-Flavour ist geplant, nicht im aktuellen Release.

Kernkonzepte

Tour

Ein interaktiver Schritt-für-Schritt-Rundgang auf Basis von Moodles User-Tour-Engine — z. B. Einzelne/n Nutzer/in anlegen, Manuelle Einschreibung, Kurs erstellen, Ankündigungen posten. Touren starten nie von selbst, wenn Sie eine Seite öffnen; eine Tour läuft nur, wenn Sie sie starten. Wer eine Tour aus dem Katalog startet, wird auf die exakte Zielseite weitergeleitet, wo die Tour abspielt; am Ende kehren Sie automatisch zur Onboarding-Übersicht zurück. Die Namen der Touren folgen Ihrer Sprache; die Schritttexte sind vorerst deutsch.

Kategorie

Eine thematische Gruppe von Touren mit eigenem Fortschritts-Chip — Level 1 liefert Nutzer/innen anlegen, Nutzer/innen einschreiben, Kurse anlegen, Kurseinstellungen, Aktivitäten anlegen, Kommunikation; Level 2 ergänzt Aufgaben, Foren vertieft, BigBlueButton.

Level-Paket

Die Touren sind entlang der LernHive-Level organisiert (Explorer → Creator → Pro → Expert → Master). Alle fünf Pakete sind ausgeliefert und startbar: Level 3 (Leistungsüberprüfung, Gruppen), Level 4 (Zusammenarbeit, Bewertungen, Berichte, Einschreibung, Dashboard) und Level 5 (Fortgeschrittene Inhalte, Kurs-Lebenszyklus) sind seit 0.3.58 autoriert. Die Tour zur Aktivität Umfrage erscheint nur auf Moodle-Versionen, die dieses Modul noch mitliefern.

Tour-Verkettung

Eine Tour kann eine Vorgänger-Tour voraussetzen. Gesperrte Touren erscheinen mit Wird freigeschaltet, sobald Sie abgeschlossen haben: … und lassen sich erst starten, wenn die Voraussetzung erfüllt ist. Sobald Sie eine verkettete Tour abschließen und zur Übersicht zurückkehren, erscheint oberhalb des Rasters ein Band Geschafft. Weiter geht es mit: … mit einem Jetzt starten-Button — so gelangen Sie direkt in die frisch freigeschaltete Folge-Tour, ohne sie suchen zu müssen. Das Band erscheint nur nach einem echten Abschluss; wenn Sie eine Tour vorzeitig schließen, bleibt die Folge-Tour gesperrt und es wird kein Band angezeigt.

Wann eine Tour als erledigt gilt

Eine Tour gilt erst als erledigt, wenn Sie ihren letzten Schritt erreichen. Schließen Sie sie vorher — über das Schließen-Element, die Esc-Taste oder Tour überspringen —, zählt das nicht: Weder steigt Ihr Fortschritt, noch wird die nächste Tour oder das nächste Level freigeschaltet. Touren, die Sie vor Einführung dieser Regel abgeschlossen haben, bleiben erledigt, und eine Wiederholung nimmt einen Abschluss nie zurück.

Sandbox-Kurs

Ein verborgener Übungskurs (LernHive Onboarding-Sandbox, mit Demo-Aufgabe: Feedback üben und Demo-Ankündigungen), den Touren mit Kurskontext beim Start aus dem Katalog als sicheres Ziel verwenden. Starten Sie eine solche Tour aus dem Katalog, werden Sie im Übungskurs als Trainer/in eingeschrieben (einmalig), ohne Kurs-Willkommensmail, solange die Einstellung Willkommensmail beim Übungskurs senden aus ist. In Ihren eigenen Kursen werden Touren nur angeboten (siehe unten) und starten nie von selbst.

Tour-Angebot

Öffnen Sie in Ihrem eigenen Kurs eine Seite, die eine Tour erklärt — etwa das Formular für einen neuen Test —, erscheint oberhalb des Inhalts der Hinweis Zu dieser Seite gibt es eine geführte Tour: … mit Tour starten und Nicht mehr anzeigen. Eine Seite zeigt höchstens ein Angebot: die Tour genau zu dieser Seite (auf Aktivitätsformularen zum Aktivitätstyp, den Sie anlegen). Angeboten wird sie nur, wenn sie zu Ihrem aktuellen Level gehört, ihre Vorgänger-Tour abgeschlossen ist, Sie sie noch nicht abgeschlossen und das Angebot nicht abgeschaltet haben.

Abläufe nach Rolle

Trainer/in: das Onboarding vom Dashboard aus starten

1. Melden Sie sich an und öffnen Sie das Dashboard (/my/). Solange Level 1 unvollständig ist, erscheint das Banner Ihr Trainer-Onboarding: „Starten Sie Ihr Schritt-für-Schritt-Onboarding — geführte Touren zeigen Ihnen jede Funktion von Level 1."
2. Klicken Sie auf Onboarding starten (bzw. Onboarding fortsetzen mit Fortschritt wie „3 von 10 Touren", sobald Sie begonnen haben). Eine Popup-Variante der Einladung lässt sich mit Später vertagen.
3. Das Schließen des Banners über sein Schließen-Element blendet es dauerhaft aus; es verschwindet auch automatisch, sobald Level 1 abgeschlossen ist.

Trainer/in: den Tour-Katalog durcharbeiten

1. Öffnen Sie Ihr Onboarding (/local/lernhive_onboarding/tours.php): „Schritt für Schritt durch LernHive — interaktive Touren führen Sie durch alle wichtigen Funktionen."
2. Der Kopfbereich zeigt Ihr Level-Badge (Level 1: Explorer) und den Gesamtfortschritt („x von y Touren").
3. Jede Kategoriekarte listet ihre Touren mit Status — Nicht gestartet, In Arbeit, Erledigt — und hebt die empfohlene nächste Tour unter Als nächstes mit einem Weiter-Button hervor.
4. Klicken Sie auf Tour starten. Sie werden auf die exakte Zielseite weitergeleitet, und die Tour spielt automatisch ab; danach landen Sie wieder auf der Onboarding-Übersicht.
5. Gesperrte Touren zeigen Wird freigeschaltet, sobald Sie abgeschlossen haben: … — schließen Sie zuerst die Vorgänger-Tour ab.
6. Nach dem Abschluss einer verketteten Tour begrüßt Sie die Übersicht mit Geschafft. Weiter geht es mit: … und einem Jetzt starten-Button für die nächste Tour der Kette — ein Klick, um weiterzumachen.
7. Wenn alles auf dem Level erledigt ist: Sie haben alle Touren auf diesem Level abgeschlossen. Schalten Sie Level X (…) frei, sobald Sie bereit sind. Klicken Sie auf Level X: … freischalten — ein grünes Band nennt das neue Level, darunter stehen sofort die neuen Touren. Der bloße Aufruf der Übersicht ändert Ihr Level nie. Hat Ihre Administration die automatische Freischaltung abgeschaltet, sagt die Zeile stattdessen, dass die Administration das Level vergibt, und es gibt keine Schaltfläche.

Trainer/in: eine Tour im eigenen Kurs nutzen

1. Öffnen Sie eine Seite, die eine Tour erklärt, und legen Sie zum Beispiel in einem Ihrer Kurse einen Test an.
2. Oberhalb des Formulars erscheint der Hinweis Zu dieser Seite gibt es eine geführte Tour: …. Es startet nichts, bevor Sie sich entscheiden.
3. Klicken Sie auf Tour starten, um die Tour direkt auf dieser Seite abzuspielen; danach bleiben Sie auf der Seite. Die Tour gilt als erledigt, wenn Sie ihren letzten Schritt erreichen.
4. Oder klicken Sie auf Nicht mehr anzeigen: Diese Tour wird Ihnen nicht mehr angeboten. Im Bereich Ihr Onboarding können Sie sie weiterhin jederzeit starten.

Trainer/in: eine abgeschlossene Tour wiederholen

1. Abgeschlossene Touren behalten eine Wiederholungs-Pille (Wiederholen: … / Wiederholen) auf ihrer Kategoriekarte.
2. Klicken Sie darauf, um die Tour von vorn abzuspielen — nützlich zur Auffrischung, bevor Sie die Aufgabe an echten Inhalten erledigen.

Website-Administrator/in: die Kurskategorie für Trainer/innen festlegen

1. Öffnen Sie die Onboarding-Einstellungen (Website-Administration → Plugins → Lokale Plugins → Onboarding-Einstellungen oder das Einstellungs-Zahnrad in der Onboarding-Shell — /local/lernhive_onboarding/configuration.php). Die Seite erfordert Website-Konfigurationsrechte.
2. Setzen Sie Kurskategorie für Trainer/innen — „Die Kurskategorie, in der die Onboarding-Tour „Kurs erstellen" neue Trainer/innen landen lässt." Richten Sie sie auf die Kategorie aus, in der Ihre Trainer/innen Kurse anlegen sollen, besonders auf mandantenfähigen Installationen, auf denen Verschiedenes typischerweise ausgeblendet ist.
3. Speichern. Die Auswahl einer nicht mehr existierenden Kategorie wird mit Die ausgewählte Kurskategorie ist nicht verfügbar. abgelehnt.

Website-Administrator/in: den Willkommens-Assistenten wieder öffnen

1. Öffnen Sie die Onboarding-Einstellungen (/local/lernhive_onboarding/configuration.php).
2. Wählen Sie unter Willkommens-Assistenten wieder öffnen die Person aus, der der Willkommens-Assistent erneut angezeigt werden soll.
3. Klicken Sie auf Assistenten für diese Person wieder öffnen. Der Assistent beginnt wieder mit der ersten Folie.

Website-Administrator/in: Inhalte des Willkommens-Assistenten

Ab Werk zeigt der Willkommens-Assistent vier neutrale Folien — Willkommen, Dashboard, Onboarding und Support — in der Sprache der jeweiligen Person. Die Folien zu Onboarding und Support sehen nur Personen, die diese Seiten öffnen dürfen. Solange Sie die Texte nicht ändern, legt das Speichern der Onboarding-Einstellungen keine Kopie an; der Standard folgt so weiter der Sprache jeder Person. Bearbeitete Folien werden so gespeichert, wie Sie sie eingeben. Das Update auf 0.3.78 ersetzt einen unverändert gespeicherten früheren deutschen Standardtext durch den neutralen; bearbeitete Folien und hochgeladene Dateien bleiben erhalten.

Website-Administrator/in: festlegen, welche Funktionsbereiche Touren anbieten

1. Öffnen Sie die Onboarding-Einstellungen (/local/lernhive_onboarding/configuration.php).
2. Nehmen Sie unter Funktionsbereiche mit Touren den Haken bei jedem Bereich heraus, den Sie nicht einsetzen — zum Beispiel Level 2: BigBlueButton, wenn Live-Räume in den Kursen Ihrer Lernenden abgeschaltet sind.
3. Speichern. Ein abgewählter Bereich verschwindet aus den geführten Touren, zählt nicht mehr für den Level-Fortschritt (kann den Level-Aufstieg also nie blockieren), und seine Touren werden in Moodle deaktiviert, sodass niemand sie starten kann. Ein erneuter Haken stellt sie wieder her.

Die Bereiche sind pro Level geschlüsselt: Level 1: Kommunikation und Level 2: Kommunikation lassen sich unabhängig voneinander schalten.

Bereiche, die an ein Aktivitätsmodul gebunden sind (derzeit BigBlueButton), schalten sich selbst ab, solange das Modul unter Website-Administration → Plugins → Aktivitäten deaktiviert ist, und kommen wieder, sobald es aktiviert wird. Solange erscheinen sie nicht im Formular, weil das Häkchen daran nichts ändern könnte.

Relevante Einstellungen

Wer das Onboarding erhält, steuert die Rollenzuweisung, nicht eine Einstellung: Weisen Sie die vom Plugin erstellte Rolle LernHive Trainer/in zu, um einer Person das Dashboard-Banner zu geben.

Grenzen

• Die Tour-Pakete für Level 1 bis 5 sind ausgeliefert und startbar.
• Das nächste Level schalten Sie mit Level X: … freischalten frei, sobald das aktuelle vollständig abgeschlossen ist (Einstellung local_lernhive/auto_levelup, standardmäßig aktiv). Ist sie deaktiviert, vergibt die Administration die Level im LernHive-Admin-Dashboard.
• Das Dashboard-Banner erscheint nur für Inhaber/innen der Rolle LernHive Trainer/in und verschwindet, sobald Level 1 abgeschlossen oder das Banner geschlossen wurde.
• Touren für optionale Module (z. B. BigBlueButton) blenden sich automatisch aus, wenn das erforderliche Plugin oder die Fähigkeit nicht verfügbar ist.
• Das Plugin speichert personenbezogene Daten nur als Nutzereinstellungen: den Zeitpunkt, zu dem Sie eine Tour abgeschlossen haben (letzter Schritt erreicht), jedes Tour-Angebot, das Sie abgeschaltet haben, die Einstellung „Banner geschlossen“ und den Stand des Willkommens-Assistenten.
• Auf einer Kursseite braucht ein Tour-Angebot Onboarding-Touren anzeigen in diesem Kurs (eine Trainer-Rolle dort genügt); außerhalb eines Kurses gilt die Zielgruppe des Katalogs. Das Recht lässt sich je Kurs überschreiben.
• Das Löschen des Sandbox-Kurses macht die Ziele der Kurskontext-Touren unbrauchbar, bis er neu bereitgestellt wird.
• Beim Deinstallieren bleiben die Touren unter Website-Administration → Darstellung → Geführte Touren erhalten, werden aber deaktiviert und starten nicht von selbst; auch der Sandbox-Kurs bleibt.

Fehlerbehebung

Ein/e Trainer/in sieht das Onboarding-Banner nicht. → Prüfen Sie, ob die Person die Rolle LernHive Trainer/in hat (Fähigkeit Trainer-Onboarding-Banner auf dem Dashboard sehen). → Das Banner blendet sich automatisch aus, wenn Level 1 abgeschlossen ist oder nachdem es geschlossen wurde (Nutzereinstellung local_lernhive_onboarding_bannerdismissed).

Eine Tour öffnet eine falsche oder ungültige Seite. → Prüfen Sie zuerst die Einstellung Kurskategorie für Trainer/innen und die Platzhalter-Konfiguration. → Wenn der Sandbox-Kurs gelöscht wurde, führen Sie das Plugin-Upgrade aus, um ihn neu bereitzustellen und die Demo-Ziele wiederherzustellen.

Eine Tour leitet korrekt weiter, startet aber nicht. → Der Pfadabgleich der Tour ist nicht mehr synchron mit ihrer Start-URL — importieren Sie das Tour-Paket neu, indem Sie das Plugin-Upgrade ausführen.

Eine Tour ist gesperrt, obwohl die/der Trainer/in sie starten möchte. → Beabsichtigt: Diese Tour ist gesperrt, bis Sie ihre Vorläufer-Tour abgeschlossen haben. Schließen Sie die im Hinweis Wird freigeschaltet, sobald Sie abgeschlossen haben: … genannte Tour ab.