YuLinc für ILIAS
Das Handbuch zum YuLinc-Plugin: wie Lehrende Online-Sessions im Kurs anlegen und auswerten und wie die ILIAS-Administration das Plugin einrichtet.
01 Überblick
Eine YuLinc Session ist ein Objekt in ILIAS wie ein Test oder eine Datei. Sie legen sie in einem Kurs, einer Gruppe oder einem Ordner an. Dahinter steht ein virtueller Raum auf dem YuLinc-Server, den das Plugin beim Anlegen automatisch einrichtet. Wer die Session in ILIAS öffnen darf, kommt mit einem Klick in den Raum, ohne eigene Zugangsdaten und ohne Einladungsmail.
Welche Reiter Sie in einer Session sehen, hängt von Ihren Rechten ab:
| Reiter | Wofür | Wer sieht ihn |
|---|---|---|
| Zugriff | Termin, Dauer und die Schaltfläche „Session betreten“ | alle mit Leserecht |
| Info | ILIAS-Infoseite des Objekts | Schreibrecht |
| Eigenschaften bearbeiten | alle Einstellungen der Session | Schreibrecht |
| Mitglieder | wer eingetragen ist und mit welcher Rolle | Schreibrecht |
| Aufnahmen | Aufzeichnungen abspielen und herunterladen | alle mit Leserecht, mit Lizenz |
| Statistik | Teilnahmezeiten und Lernfortschritt | Schreibrecht, mit Lizenz |
| Live | wer gerade im Raum ist | Schreibrecht, mit Lizenz |
| Rechte | ILIAS-Rechteverwaltung des Objekts | Recht „Rechteeinstellungen ändern“ |
Schreibrecht haben im Kurs normalerweise Kursadministratoren und Kursbetreuer. Die Administration kann die Reiter „Aufnahmen“ sowie „Statistik“ und „Live“ für die ganze Installation ausblenden. Fehlt bei Ihnen ein Reiter, ist er dort vielleicht abgeschaltet.
02 Session anlegen
- 1
Objekt hinzufügen
Öffnen Sie den Kurs (oder die Gruppe, den Ordner) und wählen Sie Neues Objekt hinzufügen → YuLinc Session.
- 2
Formular ausfüllen
Pflicht sind nur Titel und Startdatum. Alle anderen Felder haben sinnvolle Vorgaben. Was die Felder bedeuten, steht in der Tabelle unter der Abbildung.
- 3
Speichern
Mit YuLinc Session hinzufügen legt das Plugin den Raum auf dem YuLinc-Server an und trägt den Termin in den Kalender des Kurses ein. Sie selbst sind als Ersteller immer Moderator.
| Feld | Bedeutung |
|---|---|
| YuLinc-Account | Nur sichtbar, wenn Ihre Einrichtung mehrere YuLinc-Konten nutzt. Gibt es nur eines, steht es dort als Hinweis. Später lässt es sich nicht mehr ändern. |
| Startdatum/Startzeit | Einstellbar in 5-Minuten-Schritten. Danach richten sich Kalendereintrag und Auswertung. |
| Dauer in Minuten | ILIAS 10: 15 bis 240 Minuten. ILIAS 9: 15 bis 480 Minuten. Danach richten sich Kalendereintrag und Auswertung. |
| Raumgröße | „über 100 Teilnehmende“ nur wählen, wenn tatsächlich so viele kommen. |
| Online | Ohne Haken sehen nur Personen mit Schreibrecht die Session. |
| Teilnahme beschränken | Der Raum öffnet erst die eingestellte Zahl an Minuten vor Beginn (5 bis 60, Vorgabe 20). |
| Lobby aktivieren | Teilnehmende warten, bis ein Moderator sie hereinlässt. Grau, wenn Ihr YuLinc-Konto keine Lobby hat. |
| Break-Out Räume | Gruppenarbeit in Nebenräumen. Darunter: ob alle dort sofort Kamera und Mikrofon nutzen dürfen und ob man selbst den Raum wechseln darf. |
| Nur eingeladene oder registrierte Benutzer | Sperrt den Raum für Gäste über einen geteilten Link. Wer über ILIAS kommt, ist immer eingetragen. |
| Maximal einen geöffneten Inhalt | Im Raum kann immer nur ein Inhalt gleichzeitig geöffnet sein. |
| Chat-Emojis / Emoji-Feedback | Emojis im Chat und Reaktionen auf Beiträge. |
| Teilnehmerliste verbergen | Die Liste der Anwesenden wird im Raum verborgen. |
Später ändern
Alle Einstellungen lassen sich im Reiter Eigenschaften bearbeiten ändern. Dort gibt es zusätzlich den Abschnitt Darstellung mit dem Kachelbild (siehe Abschnitt 07) und den Abschnitt Lernfortschritt mit der Mindest-Teilnahmezeit (siehe Abschnitt 06). Änderungen an Startzeit, Dauer und Raumgröße gehen beim Speichern an den YuLinc-Server, der Kalendereintrag zieht mit.
03 An der Session teilnehmen
Teilnehmende klicken die Session im Kurs an und landen im Reiter Zugriff. Ein Klick auf Session betreten öffnet den Raum in einem neuen Browser-Tab. Läuft die Session bereits, steht das grün darunter.
Zugriff auf die YuLinc Session
Startdatum/Startzeit: 12.11.2026 10:00
Dauer in Minuten: 60 Minuten
YuLinc-Account: Produktiv-Account
Session betreten
- Wer den Reiter „Zugriff“ zum ersten Mal öffnet, wird automatisch in die Session eingetragen. Dabei bekommt die Person die passende Rolle, siehe Abschnitt 04.
- Ist „Teilnahme beschränken“ gesetzt, lässt sich der Raum erst kurz vor Beginn betreten.
- Anonyme Konten und Konten ohne gültige E-Mail-Adresse können nicht eingetragen werden. ILIAS zeigt dann einen Hinweis. Abhilfe: mit einem persönlichen Konto anmelden oder die E-Mail-Adresse im Profil ergänzen.
- Ändert jemand seine E-Mail-Adresse in ILIAS, legt das Plugin beim nächsten Betreten automatisch einen passenden YuLinc-Nutzer an.
04 Rollen und Mitglieder
In der Session gibt es zwei Rollen: Moderator (steuert den Raum, gibt Rechte, startet Aufnahmen) und Teilnehmer. Ist es in Ihrem YuLinc-Konto freigeschaltet, gibt es eine dritte Rolle, die nur von Hand vergeben wird.
Wer wird automatisch Moderator?
- wer die Session angelegt hat, immer,
- Kursadministratoren und Kursbetreuer des Kurses, auch wenn die Session in einer Gruppe oder einem Ordner tiefer im Kurs liegt,
- Gruppenadministratoren, wenn die Session in einer Gruppe liegt,
- alle, die an der Session das Recht „Einstellungen bearbeiten“ haben (siehe Abschnitt 11).
Alle anderen werden Teilnehmer. Die Rolle wird bei jedem Betreten an die aktuelle ILIAS-Rolle angeglichen: Wer Kursbetreuer wird, ist beim nächsten Mal Moderator, wer es nicht mehr ist, wird wieder Teilnehmer.
| Benutzername | Vorname | Nachname | Eingetragen als | Optionen | ||
|---|---|---|---|---|---|---|
| a.beispiel | Anna | Beispiel | a.beispiel@example.org | Moderator | ändern Entfernen | |
| j.muster | Jonas | Muster | j.muster@example.org | Teilnehmer | ändern Entfernen | |
| p.probe | Petra | Probe | p.probe@example.org | Teilnehmer | ändern Entfernen |
Rolle von Hand ändern
Mit ändern setzen Sie eine Person auf Moderator, Teilnehmer oder die dritte Rolle. Eine von Hand gesetzte Rolle bleibt erhalten und wird beim Betreten nicht mehr angeglichen. Mit Mitglieder hinzufügen tragen Sie Personen ein, bevor sie die Session selbst öffnen. Mit Entfernen tragen Sie sie aus. Mindestens ein Moderator muss bleiben.
05 Aufnahmen
Starten Moderatoren im Raum eine Aufnahme, erscheint sie nach dem Ende der Session im Reiter Aufnahmen. Alle mit Leserecht können sie dort abspielen und herunterladen. Umbenennen und Löschen dürfen nur Personen mit Schreibrecht.
| Titel | Datum | Dauer | Größe | Aktionen |
|---|---|---|---|---|
| Modul 3 – Vormittag | 12.11.2026 10:04 | 52 min | 310 MB | ▶ Abspielen Umbenennen Löschen |
| Modul 3 – Fragerunde | 12.11.2026 11:01 | 14 min | 88 MB | ▶ Abspielen Umbenennen Löschen |
Gelöscht ist gelöscht
Löschen entfernt die Aufnahme auf dem YuLinc-Server, nicht nur in ILIAS. Sie lässt sich nicht wiederherstellen.
06 Statistik, Live und Lernfortschritt
Der Reiter Statistik zeigt je Person, wann sie zuerst und zuletzt im Raum war, wie oft sie beigetreten ist und wie lange sie insgesamt da war. Daraus ergibt sich der Lernfortschritt.
▸ Auswertungszeitraum: automatisch ab Session-Start: 12.11.2026 10:00
| Login | Name | Erster Beitritt | Letzter Beitritt | Beitritte | Dauer | Lernfortschritt | |
|---|---|---|---|---|---|---|---|
| j.muster | Jonas Muster | j.muster@example.org | 12.11. 09:58 | 12.11. 10:01 | 2 | 61 min | Bestanden |
| p.probe | Petra Probe | p.probe@example.org | 12.11. 10:20 | 12.11. 10:20 | 1 | 31 min | Teilgenommen (Mindestzeit nicht erreicht) |
| m.mustermann | Malte Mustermann | m.mustermann@example.org | – | – | 0 | 0 min | Nicht teilgenommen |
Wann die Zahlen da sind
Der YuLinc-Server stellt die Teilnahmedaten etwa 10 Minuten nach Ende der Session bereit. Danach holt ILIAS sie automatisch über einen Cron-Job ab. Wollen Sie nicht warten, klicken Sie Statistik von YuLinc aktualisieren. Mit CSV Herunterladen erhalten Sie die Tabelle für Excel.
Mindest-Teilnahmezeit
Im Reiter „Eigenschaften bearbeiten“, Abschnitt Lernfortschritt, legen Sie fest, wie viele Minuten jemand mindestens dabei sein muss, um als Bestanden zu gelten. Bei 0 zählt jede Teilnahme. Wer kürzer da war, steht auf „Teilgenommen“. Diesen Status übernimmt der ILIAS-Lernfortschritt des Kurses.
Auswertungszeitraum
Normalerweise zählt die Zeit ab Session-Start. Klicken Sie auf Auswertungszeitraum, um ihn aufzuklappen. Dort stellen Sie mit „Auswertung ab“ und „Auswertung bis“ einen eigenen Zeitraum ein. „Zeit vor Auswertungsbeginn einbeziehen“ rechnet auch die Minuten vor dem Start mit, etwa wenn alle früher hereinkommen. Übernehmen & synchronisieren rechnet neu, Zeiten auf Session-Start zurücksetzen stellt die Vorgabe wieder her.
Reiter „Live“
Zeigt, wer gerade im Raum ist, mit Rolle und Beitrittszeit. Aktualisieren lädt die Liste neu. Ist niemand da, steht dort „Gerade ist niemand in der Session.“
07 Im Kurs: Kalender, Kacheln, Verschieben
Kalender
Jede Session steht automatisch im Kalender des Kurses oder der Gruppe. Ein Klick auf den Eintrag führt direkt zur Session. Ändern Sie Startzeit oder Dauer, zieht der Eintrag mit.
Kachelbild
Unter „Eigenschaften bearbeiten“ → Darstellung hinterlegen Sie ein eigenes Bild für die Kachelansicht. Kacheln zeigt der Kurs nur, wenn er darauf eingestellt ist: Kurs → Einstellungen → Darstellung → Ansicht „Kacheln“.
Abgelaufene Sessions
Hat die Administration es eingeschaltet, verschwinden Sessions eine bestimmte Zeit nach ihrem Start für Teilnehmende aus dem Kurs. Sie als Lehrende sehen sie weiter, Statistik und Aufnahmen bleiben vollständig erhalten.
In einen anderen Kurs verschieben
Über das Aktionsmenü der Session → Verschieben. Es bleibt derselbe Raum, Statistik und Lernfortschritt gehen nicht verloren.
Nach dem Verschieben einmal speichern
Öffnen Sie danach „Eigenschaften bearbeiten“ und klicken Sie Speichern. Erst dann wandert der Kalendereintrag in den neuen Kurs. Personen, die im alten Kurs von Hand eingetragen waren, sind danach nicht mehr eingetragen.
Kopieren ist bewusst abgeschaltet. Eine Kopie würde auf denselben Raum zeigen. Legen Sie für einen neuen Termin eine neue Session an.
08 Installation und Update
Das Plugin ist ein Repository-Objekt mit der Kennung xyvc. Es gibt je eine Fassung für
ILIAS 9 und ILIAS 10, die nicht untereinander austauschbar sind.
| ILIAS | Plugin-Ordner |
|---|---|
| 9 | Customizing/global/plugins/Services/Repository/RepositoryObject/YuLinc im ILIAS-Verzeichnis |
| 10 | public/Customizing/global/plugins/Services/Repository/RepositoryObject/YuLinc im ILIAS-Verzeichnis |
- 1
Dateien einspielen
Das Zip entpacken und den Ordner
YuLincan die genannte Stelle legen. Er muss dem Webserver-Benutzer gehören.chown -R www-data:www-data YuLinc - 2
Autoload neu erzeugen
Im ILIAS-Hauptverzeichnis:
sudo -u www-data composer dump-autoload - 3
In ILIAS installieren
Administration → ILIAS erweitern → Plugins, beim Eintrag YuLinc nacheinander Installieren, Aktivieren und Sprachen aktualisieren.
- 4
Konfigurieren
Beim selben Eintrag Konfigurieren wählen und mindestens eine Account-Konfiguration anlegen (Abschnitt 09).
Updates
Die Plugin-Konfiguration zeigt oben die installierte und die verfügbare Version, mit Download und Changelog. Jetzt prüfen fragt sofort nach. Das Plugin aktualisiert sich nie von selbst.
Ein Update spielen Sie wie die Installation ein: Ordner ersetzen, Autoload neu erzeugen, dann unter Plugins Aktualisieren wählen, falls ILIAS das anbietet, und Sprachen aktualisieren. Der Changelog steht jeweils in der Wissensdatenbank: ILIAS 9 unter support.netucate.net/?p=1415, ILIAS 10 unter support.netucate.net/?p=1148.
09 Plugin-Konfiguration
Die Seite unter Plugins → YuLinc → Konfigurieren hat fünf Bereiche, von oben nach unten: Update-Hinweis, Lizenzschlüssel, Account-Konfigurationen, Cron-Job-Einstellungen und Anzeige-Einstellungen.
Lizenzschlüssel Licensed
Geben Sie Ihren YuLinc-Plugin-Lizenzschlüssel ein.
Speichern
Account-Konfigurationen
| Account-Name | YuLinc API URL | Admin Login | Status | Anzahl Sessions | Aktionen |
|---|---|---|---|---|---|
| Produktiv-Account | https://—-.netucate.net/api/2/ | ——– | Aktiv | 148 | Bearbeiten Deaktivieren |
Cron-Job Einstellungen
Puffer nach Session-Ende Speichern
Anzeige-Einstellungen
Lizenzschlüssel
Schaltet die Reiter „Aufnahmen“, „Statistik“ und „Live“ frei. Ein leeres Feld deaktiviert die Lizenz nach einer Sicherheitsabfrage. Das blendet nur diese Reiter aus. Die Lernfortschritt-Kästchen bleiben, dafür gibt es einen eigenen Schalter in den Anzeige-Einstellungen.
Account-Konfigurationen
Eine Account-Konfiguration verbindet ILIAS mit einem YuLinc-Konto. Die meisten Einrichtungen brauchen genau eine. Mehrere sind sinnvoll, wenn zum Beispiel Fachbereiche eigene YuLinc-Konten haben.
| Feld | Inhalt |
|---|---|
| Account-Name | freie Bezeichnung, erscheint bei Lehrenden als „YuLinc-Account“ |
| YuLinc API URL | Basisadresse der Schnittstelle, ohne Benutzernamen am Ende. Die Vorgabe steht neben dem Feld. |
| API Timeout | Wartezeit in Sekunden, Vorgabe 20 |
| Admin Login / Admin Kennwort | Zugangsdaten des YuLinc-Kontos, die Sie von netucate erhalten. Beim Bearbeiten das Kennwort leer lassen, um es zu behalten. |
| Aktiv | Nur aktive Konfigurationen stehen beim Anlegen zur Wahl. |
| Sortierung | Reihenfolge in der Auswahlliste, kleinere Zahlen zuerst |
| Zugewiesene Rollen | Welche ILIAS-Rollen mit diesem Konto Sessions anlegen dürfen |
Ohne zugewiesene Rolle sieht niemand das Konto
Haken Sie unter „Zugewiesene Rollen“ alle Rollen an, die Sessions anlegen sollen, zum Beispiel die Kursadministratoren. Sonst erscheint beim Anlegen „Keine aktive Account-Konfiguration vorhanden“.
Beim Speichern testet das Plugin die Verbindung und meldet das Ergebnis sofort: „Verbindung zum YuLinc-Server erfolgreich getestet“ oder die Ursache, etwa falsche Zugangsdaten oder eine Firewall. Eine Konfiguration, an der noch Sessions hängen, lässt sich nur deaktivieren, nicht löschen.
Anzeige-Einstellungen
- Reiter „Aufzeichnungen“ anzeigen und Statistik- und Live-Reiter anzeigen blenden diese Reiter in allen Sessions ein oder aus. Die Daten bleiben erhalten.
- Lernfortschritt-Kästchen bei YuLinc-Sessions ausblenden nimmt die Lernfortschritt-Anzeige nur bei YuLinc-Sessions weg, für alle Nutzer der Installation. Andere Objekte bleiben unverändert. Sind YuLinc-Sessions in die Lernfortschritt-Auswahl eines Kurses aufgenommen, zählen sie dort weiter.
- Abgelaufene Sessions automatisch ausblenden verbirgt Sessions die eingestellte Zeit nach dem Start vor Kursmitgliedern. Wer Schreibrecht hat, sieht sie weiter. Gelöscht wird nichts.
10 Cron-Jobs
Das Plugin bringt zwei Cron-Jobs mit, die die Teilnahmedaten vom YuLinc-Server holen. Sie stehen in der ILIAS-Administration in der Cron-Job-Verwaltung. Voraussetzung ist, dass der ILIAS-Cron auf dem Server regelmäßig läuft.
| Cron-Job | Was er tut | Vorgabe |
|---|---|---|
| YuLinc: Abgelaufene Sessions synchronisieren | holt die Daten von Sessions, deren geplante Zeit plus Puffer vorbei ist | stündlich, von selbst aktiv |
| YuLinc: Alle Sessions vollständig synchronisieren | gleicht alle Sessions nacheinander ab, als Sicherheitsnetz | alle 3 Stunden, muss von Hand aktiviert werden |
Den Puffer nach Session-Ende stellen Sie in der Plugin-Konfiguration ein (0 bis 120 Minuten, Vorgabe 15). Der vollständige Abgleich belastet den Server mehr. Lassen Sie ihn deshalb nicht häufiger als nötig laufen.
11 Rechte und Moderatoren
ILIAS-Installationen sind bei Rollen und Rechten sehr unterschiedlich aufgebaut. Das Plugin verlässt sich deshalb nicht auf feste Rollennamen, sondern auf die Rechteverwaltung von ILIAS:
| Recht an der YuLinc Session | Wirkung |
|---|---|
| Sichtbar / Lesezugriff | sieht die Session und kann als Teilnehmer beitreten |
| Einstellungen bearbeiten | wird Moderator, sieht Mitglieder, Statistik und Live |
| Löschen | darf die Session löschen |
| Rechteeinstellungen ändern | sieht den Reiter „Rechte“ |
Damit lässt sich je Rolle festlegen, wer moderiert, auch für eigene Rollen und für Sessions außerhalb eines Kurses, etwa in einer Kategorie. Wer Sessions anlegen darf, regelt das Recht „Erzeuge YuLinc Session“ am Kurs, an der Gruppe, dem Ordner oder der Kategorie.
ILIAS-Systemadministratoren werden nicht automatisch Moderator, obwohl sie überall Schreibrecht haben. Sonst wären sie in jeder Session Moderator.
Bestehende Kurse übernehmen Rollenänderungen nicht
Kurse und Gruppen übernehmen die Rechte einer globalen Rolle nur beim Anlegen. Ändern Sie eine Rolle später, setzen Sie das Recht in bestehenden Kursen einmal nach: Reiter Rechte des Kurses, Abschnitt YuLinc Session, mit Bereits vorhandene YuLinc Sessions ändern.
12 Häufige Fragen
„Keine aktive Account-Konfiguration vorhanden“ beim Anlegen
Entweder ist keine Account-Konfiguration aktiv, oder der Rolle der Person ist keine zugewiesen. Beides prüfen Sie in der Plugin-Konfiguration.
„Fehler: Keine Verbindung zum YuLinc Server!“
Der ILIAS-Server erreicht die YuLinc-Schnittstelle nicht. Meist blockiert eine Firewall oder ein Proxy ausgehende HTTPS-Verbindungen, oder die Zugangsdaten stimmen nicht. Speichern Sie die Account-Konfiguration erneut, dann zeigt der Verbindungstest die Ursache.
Die Statistik ist leer
Die Daten kommen erst etwa 10 Minuten nach Ende der Session. Klicken Sie danach „Statistik von YuLinc aktualisieren“, oder prüfen Sie, ob der Cron-Job „Abgelaufene Sessions synchronisieren“ läuft.
Die Reiter „Aufnahmen“ oder „Statistik“ fehlen
Entweder ist kein gültiger Lizenzschlüssel eingetragen, oder die Reiter sind in den Anzeige-Einstellungen abgeschaltet. „Statistik“ und „Live“ sehen außerdem nur Personen mit Schreibrecht.
Ein Kursbetreuer kommt als Teilnehmer in den Raum
Die Rolle wird beim Betreten über den Reiter „Zugriff“ angeglichen. Lassen Sie die Person die Session neu über ILIAS betreten. Wurde sie früher von Hand auf Teilnehmer gesetzt, ändern Sie das im Reiter „Mitglieder“.
Kann man den Raum auch ohne ILIAS betreten?
Für Teilnehmende ist ILIAS der vorgesehene Weg: Nur dann stimmen Rolle, Statistik und Lernfortschritt. Mit „Nur eingeladene oder registrierte Benutzer“ verhindern Sie, dass jemand über einen weitergegebenen Link hineinkommt.


