Im Reiter Verbindung stellen Sie die Verbindung zwischen WebUntis und Ihrer Moodle-Instanz her.
Folgen Sie der Anleitung und tragen Sie anschließend URL und Token ein.
Schritt-für-Schritt: Moodle anbinden
Schritt 1 – Moodle-Plugin herunterladen
Klicken Sie auf „Moodle Plugin herunterladen“, um die ZIP-Datei zu speichern.
Die ZIP enthält eine README mit Installationshinweisen.
Schritt 2 – Plugin in Moodle installieren
In Moodle als Administrator:in zu Website-Administration → Plugins wechseln und die ZIP installieren/aktualisieren.
Schritt 3 – Moodle-URL eintragen
Tragen Sie die Basis-URL Ihrer Moodle-Instanz im Format https://moodle.example.com in URL ein.
💡 Hinweis: Moodle muss über HTTPS erreichbar sein. Ohne TLS/HTTPS können Anfragen blockiert werden.
Schritt 4 – Webservice-Token in Moodle erzeugen
In Moodle: Website-Administration → Server → Webservices → Token verwalten.
Erstellen Sie einen Token für das installierte Plugin bzw. für einen Service-User mit folgenden Berechtigungen (Capabilities):
- moodle/course:view
- moodle/course:update
- moodle/course:viewhiddencourses
- moodle/user:viewdetails
- moodle/user:viewhiddendetails
- moodle/course:useremail
- moodle/user:update
- moodle/site:accessallgroups
- moodle/course:viewparticipants
- moodle/user:create
- moodle/user:delete
- enrol/manual:enrol
- enrol/manual:unenrol
💡 Hinweis: Achten Sie darauf, dass der Token-User genau diese Rechte besitzt. Fehlende Berechtigungen führen zu Teil- oder Fehlschlägen (z. B. beim Einschreiben/Löschen).
Schritt 5 – URL & Token in WebUntis eintragen
Fügen Sie URL und Token in die Felder ein und klicken Sie auf „Verbindung testen“.
Wenn der Test erfolgreich ist, „Speichern“ – damit ist die Verbindung aktiv.
💡 Hinweis: Voraussetzung: Das Moodle-Plugin ist installiert und aktiviert.
💡 Hinweis: Wenn Moodle in einem iFrame geöffnet wird und Sie einen Proxy/Webserver (Nginx, Traefik, Apache) einsetzen, kann ein restriktiver X-Frame-Options-Header das Einbetten verhindern. Entfernen oder lockern Sie den X-Frame-Options-Header. Die Anpassung erfolgt in der Proxy/Webserver-Konfiguration.
Aktionen im Überblick
- Verbindung testen – prüft Erreichbarkeit und Token-Gültigkeit.
- Speichern – übernimmt die Verbindung dauerhaft.
- Verbindung trennen – deaktiviert die Verbindung zum Moodle