Handbuch YuLinc Plugin für Ilias

netucate · YuLinc

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.

Gilt für ILIAS 9 (Plugin 3.6.4) und ILIAS 10 (Plugin 4.7.3). Die Bedienung ist in beiden Versionen gleich, Unterschiede sind an Ort und Stelle genannt. Aufzeichnungen sowie Statistik und Lernfortschritt brauchen einen Lizenzschlüssel, alle übrigen Funktionen sind frei. Den Schlüssel erhalten Sie bei Herrn Schwinger, sales@netucate.com.
Teil 1 · Für Lehrende

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:

ReiterWofürWer sieht ihn
ZugriffTermin, Dauer und die Schaltfläche „Session betreten“alle mit Leserecht
InfoILIAS-Infoseite des ObjektsSchreibrecht
Eigenschaften bearbeitenalle Einstellungen der SessionSchreibrecht
Mitgliederwer eingetragen ist und mit welcher RolleSchreibrecht
AufnahmenAufzeichnungen abspielen und herunterladenalle mit Leserecht, mit Lizenz
StatistikTeilnahmezeiten und LernfortschrittSchreibrecht, mit Lizenz
Livewer gerade im Raum istSchreibrecht, mit Lizenz
RechteILIAS-Rechteverwaltung des ObjektsRecht „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. 1

    Objekt hinzufügen

    Öffnen Sie den Kurs (oder die Gruppe, den Ordner) und wählen Sie Neues Objekt hinzufügen → YuLinc Session.

  2. 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. 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.

Neue YuLinc Session hinzufügenBeispieldaten
Magazin › Fortbildung › Grundlagen Arbeitsschutz
Neue YuLinc Session hinzufügen
Produktiv-Account
Legt fest, für wie viele Teilnehmende der YuLinc-Raum ausgelegt wird. Bestehende Räume behalten ihre bisherige Einstellung.
Zugriff
Erlaube Betreten erst in Minuten bevor die Session startet.
Allen Benutzern im Breakout-Raum automatisch Übertragungsrechte freischalten.
Erlaube Teilnehmern, sich selbständig zwischen Breakout-Räumen zu bewegen.
Chat Emoji-Feedback aktivieren
YuLinc Session hinzufügenAbbrechen
FeldBedeutung
YuLinc-AccountNur 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/StartzeitEinstellbar in 5-Minuten-Schritten. Danach richten sich Kalendereintrag und Auswertung.
Dauer in MinutenILIAS 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.
OnlineOhne Haken sehen nur Personen mit Schreibrecht die Session.
Teilnahme beschränkenDer Raum öffnet erst die eingestellte Zahl an Minuten vor Beginn (5 bis 60, Vorgabe 20).
Lobby aktivierenTeilnehmende warten, bis ein Moderator sie hereinlässt. Grau, wenn Ihr YuLinc-Konto keine Lobby hat.
Break-Out RäumeGruppenarbeit 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 BenutzerSperrt den Raum für Gäste über einen geteilten Link. Wer über ILIAS kommt, ist immer eingetragen.
Maximal einen geöffneten InhaltIm Raum kann immer nur ein Inhalt gleichzeitig geöffnet sein.
Chat-Emojis / Emoji-FeedbackEmojis im Chat und Reaktionen auf Beiträge.
Teilnehmerliste verbergenDie 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.

Reiter „Zugriff“Beispieldaten
Y
Online-Seminar Modul 3
Gefährdungsbeurteilung in der Praxis
ZugriffInfoEigenschaften bearbeitenMitgliederAufnahmenStatistikLiveRechte

Zugriff auf die YuLinc Session

Startdatum/Startzeit: 12.11.2026 10:00

Dauer in Minuten: 60 Minuten

YuLinc-Account: Produktiv-Account

Session betreten

Meeting läuft gerade – 24 Teilnehmer eingeladen
  • 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.

Reiter „Mitglieder“Beispieldaten
ZugriffInfoEigenschaften bearbeitenMitgliederAufnahmenStatistikLiveRechte
Mitglieder hinzufügen
BenutzernameVornameNachnameeMailEingetragen alsOptionen
a.beispielAnnaBeispiela.beispiel@example.orgModeratorändern Entfernen
j.musterJonasMusterj.muster@example.orgTeilnehmerändern Entfernen
p.probePetraProbep.probe@example.orgTeilnehmerä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.

Reiter „Aufnahmen“Beispieldaten
ZugriffInfoEigenschaften bearbeitenMitgliederAufnahmenStatistikLiveRechte
TitelDatumDauerGrößeAktionen
Modul 3 – Vormittag12.11.2026 10:0452 min310 MB▶ Abspielen Umbenennen Löschen
Modul 3 – Fragerunde12.11.2026 11:0114 min88 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.

Reiter „Statistik“Beispieldaten
ZugriffInfoEigenschaften bearbeitenMitgliederAufnahmenStatistikLiveRechte
Erforderliche Mindest-Teilnahmezeit: 45 min
Statistik von YuLinc aktualisierenCSV Herunterladen

▸ Auswertungszeitraum: automatisch ab Session-Start: 12.11.2026 10:00

LoginNameE-MailErster BeitrittLetzter BeitrittBeitritteDauerLernfortschritt
j.musterJonas Musterj.muster@example.org12.11. 09:5812.11. 10:01261 minBestanden
p.probePetra Probep.probe@example.org12.11. 10:2012.11. 10:20131 minTeilgenommen (Mindestzeit nicht erreicht)
m.mustermannMalte Mustermannm.mustermann@example.org––00 minNicht 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.

Teil 2 · Für die ILIAS-Administration

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.

ILIASPlugin-Ordner
9Customizing/global/plugins/Services/Repository/RepositoryObject/YuLinc im ILIAS-Verzeichnis
10public/Customizing/global/plugins/Services/Repository/RepositoryObject/YuLinc im ILIAS-Verzeichnis
  1. 1

    Dateien einspielen

    Das Zip entpacken und den Ordner YuLinc an die genannte Stelle legen. Er muss dem Webserver-Benutzer gehören.

    chown -R www-data:www-data YuLinc
  2. 2

    Autoload neu erzeugen

    Im ILIAS-Hauptverzeichnis:

    sudo -u www-data composer dump-autoload
  3. 3

    In ILIAS installieren

    Administration → ILIAS erweitern → Plugins, beim Eintrag YuLinc nacheinander Installieren, Aktivieren und Sprachen aktualisieren.

  4. 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.

Konfiguration des Plugins YuLinc SessionBeispieldaten
Installiert: 4.7.3  ·  Verfügbar: 4.7.3   Jetzt prüfen

Lizenzschlüssel Licensed

Geben Sie Ihren YuLinc-Plugin-Lizenzschlüssel ein.

Speichern

Account-Konfigurationen

Neue Account-Konfiguration
Account-NameYuLinc API URLAdmin LoginStatusAnzahl SessionsAktionen
Produktiv-Accounthttps://—-.netucate.net/api/2/——–Aktiv148Bearbeiten Deaktivieren

Cron-Job Einstellungen

Puffer nach Session-Ende Speichern

Anzeige-Einstellungen

Reiter „Aufzeichnungen“ anzeigen
Statistik- und Live-Reiter anzeigen
Lernfortschritt-Kästchen bei YuLinc-Sessions ausblenden
Abgelaufene Sessions automatisch ausblenden   Ausblenden nach Tage Stunden

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.

FeldInhalt
Account-Namefreie Bezeichnung, erscheint bei Lehrenden als „YuLinc-Account“
YuLinc API URLBasisadresse der Schnittstelle, ohne Benutzernamen am Ende. Die Vorgabe steht neben dem Feld.
API TimeoutWartezeit in Sekunden, Vorgabe 20
Admin Login / Admin KennwortZugangsdaten des YuLinc-Kontos, die Sie von netucate erhalten. Beim Bearbeiten das Kennwort leer lassen, um es zu behalten.
AktivNur aktive Konfigurationen stehen beim Anlegen zur Wahl.
SortierungReihenfolge in der Auswahlliste, kleinere Zahlen zuerst
Zugewiesene RollenWelche 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-JobWas er tutVorgabe
YuLinc: Abgelaufene Sessions synchronisierenholt die Daten von Sessions, deren geplante Zeit plus Puffer vorbei iststündlich, von selbst aktiv
YuLinc: Alle Sessions vollständig synchronisierengleicht alle Sessions nacheinander ab, als Sicherheitsnetzalle 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 SessionWirkung
Sichtbar / Lesezugriffsieht die Session und kann als Teilnehmer beitreten
Einstellungen bearbeitenwird Moderator, sieht Mitglieder, Statistik und Live
Löschendarf die Session löschen
Rechteeinstellungen ändernsieht 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.

Die eingebetteten Ansichten sind Nachbildungen der echten Oberflächen mit Beispieldaten — kein Kundenmaterial; die gezeigten Namen und Adressen sind Platzhalter. Je nach ILIAS-Version und Skin sieht die Oberfläche etwas anders aus. Fragen beantwortet der netucate-Support.