Moodle App - Anleitung für Administrator/innen
Mobile Services auf der Moodle-Website aktivieren
Sie müssen auf Ihrer Moodle-Website den mobilen Zugriff aktivieren, bevor die Moodle-App genutzt werden kann.
Für Moodle-Websites, die unter https laufen, ist dieser mobile Zugriff bei Neuinstallationen ab Moodle 3.0 automatisch aktiviert.
Für Moodle-Websites, die unter http laufen, kann die Moodle-Administration den mobilen Zugriff wie folgt aktivieren:
- Gehen Sie auf die Seite Website-Administration (oder im Block Einstellungen > Website-Administration) > Mobile App > Mobile Einstellungen und markieren Sie die Checkbox Webservice für mobile Endgeräte aktivieren.
- Klicken Sie auf den Button Änderungen sichern.
Wenn Ihre Moodle-Website ein SSL-Zertifikat verwendet, muss das ein vertrauenswürdiges Zertifikat sein, das von einer Zertifizierungsstelle ausgestellt wurde. Aus Sicherheitsgründen funktioniert die App nicht mit selbstsignierten Zertifikaten.
Sie können auf der Seite https://www.geocerts.com/ssl_checker prüfen, ob Ihr Zertifikat gültig ist (Sie sollten keine Warnungen sehen).
Wenn Ihre Moodle-Website das Verzeichnis moodle/login gesperrt hat (kommt häufig bei Shibboleth-Authentifierung vor), dann müssen Sie den Zugriff auf das Skript moodle/login/token.php sicherstellen.
Einbettung von Frames
Wenn Ihre Moodle-Website reCAPTCHA, Vimeo-Videos oder angepasste Menüeinträge (wie unten beschrieben) verwendet, dann müssen Sie die Einstellung Frame-Einbettung erlauben (allowframembedding) aktivieren.
Mobile Authentifizierung
Wenn Ihre Moodle-Site eine Single-Sign-On-Authentifizierungsmethode verwendet (CAS, Shibboleth, LDAP, ...), dann wählen Sie auf der Seite Website-Administration (oder im Block Einstellungen > Website-Administration) > Mobile App > Mobile Authentifizierung im Auswahlmenü Login die Option Im Browser (für SSO) oder Im intergrierten Browser (für SSO) aus. (Diese Einstellung wurde für ältere Moodle-Versionen durch das Plugin Moodle App - Zusatzfunktionen bereitgestellt.)
Wenn Sie die Option Im Browser (für SSO) wählen, wird die Moodle-Site bei der Weiterleitung zur Eingabe der Anmeldedaten im Standardbrowser geöffnet. Wenn Sie die Option Im intergrierten Browser (für SSO) verwendet, wird die Moodle-Site eingebettet in die App geöffnet. Komfortabler für die Nutzer/innen ist die Option Im intergrierten Browser (für SSO), aber nicht alle Authentifizierungs-Plugins funktionieren mit dieser Option (z.B. wenn JavaScript Popups für die Authentifizierung erforderlich sind, funktioniert das nur im normalen Browser). Die Moodle-Administration sollte prüfen, ob beide Optionen funktionieren und falls ja, die Option Im integrierten Browser (für SSO) wählen.
Wenn Sie die Google-Authentifizierung verwenden, müssen Sie die Browser-Fenster-Methode verwenden, da Google kürzlich die Authentifizierung im integrierten Browser geblockt hat.
Wenn Ihre Organisation den Branded Moodle App Service nutzt (siehe unten) und die Einstellung Login ist auf Im Browser (für SSO) oder Im intergrierten Browser (für SSO) gesetzt, dann können Sie ein URL Scheme angeben. Damit stellen Sie sicher, dass Ihre Moodle-Site nur mit der Markenzeichen-Mobile-App funktioniert, aber nicht mit der Standard-Moodle-Mobile-App.
Das App-Design anpassen
Die App kann Ihre angepassten Style-Sheets verwenden. Da es sich bei der App um eine HTML5 App handelt, können Sie alle CSS, CSS2 und CSS3 Style-Elemente verwenden.
Gehen Sie auf die Seite Website-Administration (oder im Block Einstellungen > Website-Administration) > Mobile App > Mobile Darstellung und tragen Sie im Textfeld CSS den Pfad zu einer entsprechenden CSS-Datei ein.
Die CSS-Datei sollte in Ihrem Moodle-Installationsverzeichnis liegen: in Ihrem Design (unter moodle/theme/mydesign) oder in einem lokalen Plugin (unter moodle/local/myplugin)
Beispiel: https://mymoodlesite.com/theme/mytheme/style/mymobileapp.css
Sobald sich Nutzer/innen in der App anmelden, wird die CSS-Datei für die Darstellung auf dem mobilen Endgerät verwendet.
Wenn Nutzer/innen die App zum ersten Mal aufrufen, dann wird das orange Standard-Design angezeigt. Das angepasste Design wird verwendet, sobald Ihre Moodle-Site in der App eingetragen wird.
Weitere Informationen finden Sie in der Entwickler-Dokumentation Moodle App Designs.
Wenn Sie die App als Markenzeichen Ihrer Organisation verwenden wollen, bietet Moodle dafür den Branded Moodle App Service an. Detaillierte Informationen dazu finden Sie auf der Seite https://moodle.com/mobileapp/.
Moodle Mobile Zusatzfunktionen für ältere Moodle-Websites
Für ältere Moodle-Websites empfehlen wir, das Plugin Moodle App - Zusatzfunktionen zu installieren.
Benachrichtigungen
Auch wenn sie manchmal nerven, so halten Benachrichtigungen Sie auf dem Laufenden über Entwicklungen in der App. Moodle schickt nur Benachrichtigungen, wenn neue Funktionalitäten entwickelt wurden oder Störungen auftreten.
Die Aktivierung der Benachrichtigungen erfolgt durch die Moodle-Administration. Die Moodle-Administration muss die Moodle-Site mit unserem freien Benachrichtigungs-Server verbinden (dieser Service funktioniert nur für registrierte Moodle-Sites).
Einen Zugangsschlüssel erhalten Sie über die Seite Website-Administration (oder im Block Einstellungen > Website-Administration) > Plugins > Mitteilungskanäle > Übersicht. In der Zeile Mobile klicken Sie auf den Link Einstellungen und auf der Einstellungsseite auf den Link Zugangsschlüssel anfordern.
Detaillierte Informationen zu den Einstellungen finden Sie im Artikel Moodle App - Systemnachrichten.
Werbebanner
Werbebanner machen Ihre Nutzer/innen darauf aufmerksam, dass die Moodle App für Ihre Moodle-Site verfügbar ist. Die Banner werden nur angezeigt, wenn Sie über den Browser Ihres mobilen Endgerätes auf Moodle zugreifen.
Ab Moodle 3.3 werden Werbebanner für Android und iOS unterstützt.
Werbebanner sind standardmäßig deaktiviert. Sie können auf der Seite Website-Administration (oder im Block Einstellungen > Website-Administration) > Mobile App > Mobile Darstellung aktiviert werden.
Wenn Sie eine Markenzeichen-Moodle-App verwenden, müssen Sie die Felder Eindeutige ID der iOS-App und Eindeutige ID der Android-App ausfüllen. Wenn Sie die standardmäßige Moodle-App verwenden, dann können Sie die Standardeinstellungen stehen lassen.
Beachten Sie Folgendes:
- App-Banner für iOS-Geräte (iPhone, iPad oder iPod) werden nur angezeigt, wenn Sie über den Safari-Brwoser auf die Moodle-Site zugreifen.-
- App-Banner für Android-Geräte werden nur in neueren Chrome-Browser-Versionen angezeigt und wenn die App nicht installiert ist. Beachten Sie das Chrome eine Heuristik verwendet, so dass das Banner nur unter vbestimmten Bedingungen angezeigt wird, z.B. bei Interaktionen mit der Moodle-Site, beim letzten Zugriff, etc. Sie können diese Beschränkungsprüfungen aufheben, indem Sie dieses spezielle Chrome-Flag deaktivieren: chrome://flags/#bypass-app-banner-engagement-checks.
Moodle App Link
Ab Moodle 3.4 wird in der Fußzeile jeder Moodle-Seite der Link Laden Sie die mobile App angezeigt, um die Nutzer/innen zur Verwendung der Moodle App aufzufordern.
Standardmäßig führt der Link zu https://download.moodle.org/mobile, aber die Einstellung Download für mobile App (tool_mobile|setuplink) kann für Moodle-Sites geändert werden, die eine angepasste App mit Werbebanner verwenden.
Wenn in Ihrer Moodle-Installation keine mobilen Services aktiviert sind, wird der Link nicht angezeigt.
Um die Anzeige des Links zu verhindern, löschen Sie die URL in der Einstellung Download für mobile App (tool_mobile|setuplink) und speichern Sie diese Änderung.
Die App in Moodle konfigurieren
Ab Moodle 3.3 oder mit dem das Plugin Moodle App - Zusatzfunktionen können Sie die App über die Moodle-Site konfigurieren.
- Ab Moodle 3.3 gehen Sie dazu auf die Seite Website-Administration (oder im Block Einstellungen > Website-Administration) > Mobile App > Mobile Funktionen.
- In älteren Moodle-Versionen, die das Zusatz-Plugin verwenden, gehen Sie auf die Seite Website-Administration (oder im Block Einstellungen > Website-Administration) > Plugins > Lokale Plugins > Moodle Mobile - Zusatzfeatures.
Abmeldung erzwingen
Wenn Sie diese Checkbox markieren, dann wird der Menüpunkt Website wechseln in der App geändert in Abmelden. Damit werden Nutzer/innen vollständig aus der Website abgemeldet und müssen ihr Kennwort beim nächsten Zugriff erneut eingeben. Diese Einstellung ist insbesondere sinnvoll für Markenzeichen-Moodle-Mobile-Apps, denn es gibt keinen Grund für die Nutzer/innen, zu einer anderen (Moodle-)Website zu wechseln.
Deaktivierte Funktionen
Hier können Sie Moodle-Funktionen deaktivieren, so dass sie nicht in der App verfügbar sind.
Folgende Einstellungen sind möglich:
- Offline-Nutzung
- Neues Konto anlegen?
- Hauptmenü
- Meine Kurse
- Moodle-Start
- Bewertungen
- Meine Lernpläne
- Systemnachrichten
- Mitteilungen
- Kalender
- Dateien
- Webseite
- Hilfe
- Kurse
- Suchen
- Kompetenzen
- Teilnehmer/innen
- Bewertungen
- Kursabschluss
- Anmerkungen
- Kurs herunterladen
- Kurse herunterladen
- Nutzer/in
- Auszeichnungen
- Kompetenzen
- Kursabschluss
- Bewertungen
- Mitteilung senden
- Kontakt hinzufügen
- Kontakt blockiene
- Neue Anmerkung hinzufügen
- Nutzerbild
- Dateien
- Meine Dateien
- Dateien der Website
- Hochladen
Benutzerdefinierte Menüpunkte
Hier können Sie zusätzliche Einträge für das Hauptmenü der App eintragen.
Jeder Menüeintrag sollte folgendes Format haben: Text des Menüeintrags, zugehörige URL, Methode zum Öffnen des Links, Sprachcode (optional). Alle Angaben müssen mit senkrechten Strichen | getrennt werden.
Es gibt folgende Methoden zum Öffnen des Links:
- app - wenn Sie auf eine Aktivität zu verlinken, die von der App unterstützt wird (das sind fast alle Aktivitäten, siehe Moodle App - Funktionalitäten).
- inappbrowser - wenn Sie auf eine externe URL verlinken oder auf eine Moodle-Funktionalität, die nicht von der App unterstützt wird. Der Link wird dann in einem Browser innerhalb der App geöffnet.
- browser - wie bei inappbrowser, der Link wird jedoch im Standardbrowser Ihres mobilen Endgeräts geöffnet, d.h. außerhalb der App.
- embedded - wie bei inappbrowser, der Link wird jedoch in einem iframe auf einer neuen Seite der App geöffnet (für diese Option müssen Sie auf der Seite Website-Administration (oder im Block Einstellungen > Website-Administration) > Sicherheit > HTTP-Sicherheit die Checkbox Frame-Einbettung erlauben markieren.)
Tipp: Wenn Sie benutzerdefinierte Menüpunkte hinterlegt haben und der Menüeintrag wird nicht in der App angezeigt, dann überprüfen Sie noch einmal, ob Sie den Eintrag korrekt formatiert haben.
Wenn die App eine Sprache verwendet, die nicht in der angegebenen Liste vorkommt, dann wird der Texteintrag in die Sprache übersetzt, die in der Liste zuerst vorkommt.
Wenn Sie einen Menüeintrag nur in einer bestimmten Sprache angezeigt haben möchten, dann hängen Sie ein _only an den Sprachcode an, z.B. en_only oder de_only. Dann werden die entsprechenden Menüeinträge nur angezeigt, wenn die App-Sprache englisch oder deutsch ist.
Angepasste Sprach-Strings
Wörter und Texteinträge, die in der App angezeigt werden, können hier angepasst werden.
Tragen Sie jeden benutzerdefinierten Text in eine neue Zeile ein und verwenden Sie für jeden Eintrag das folgende Format: Text-ID, benutzerdefinierter Text und Sprachcode (optional). Alle Angaben müssen mit senkrechten Strichen | getrennt werden.
mm.user.student|Learner|en mm.user.student|Aprendiz|es
Die vollständige Liste der Sprach-Strings finden Sie unter https://raw.githubusercontent.com/moodlehq/moodlemobile-phonegapbuild/master/assets/lang/en.json. Die Text-ID des Sprach-Strings steht vor dem Doppelpunkt.
Beispiel:
"mm.user.student": "Student"
bedeutet, dass der Sprach-String "Student" die Text-ID "mm.user.student" hat.
Gültigkeitsdauer von Webservices-Tokens
Ab Moodle 3.4 kann die Moodle-Administration festlegen, wie lange ein Webservice Token, das von Nutzer/innen erzeugt wurde (z.B. über die Moodle App), gültig ist. In früheren Moodle-Versionen betrug die Gültigkeitsdauer 3 Monate.
App-Cache
Die App speichert Webservice-Anfrage im Cache, um das datenvolumen zu reduzieren und die Geschwindigkeit der App zu erhöhen. Wenn die App Daten von Moodle benötigt, wird die zwischengespeicherte Anfrage verwendet, solange sie nicht abgelaufen ist.
Der Cache wurde in Moodle App 3.7.0 verbessert, jetzt gibt es verschiedene Cache-Speicherzeiten, abhängig vom angeforderten webservice. D.h. dass einige Anfragen häufiger ablaufen als andere. Wenn Nutzer/innen keine WiFi-Verbindung nutzen, ist die Ablaufdauer ebenfalls länger, um das Datenvolumen zu reduzieren. Die Cache-Speicherzeiten können nicht über eine Moodle-Einstellung konfiguriert werden.
Siehe auch
- Moodle App - FAQ
- Moodle App Roadmap - Entwickler-Dokumentation (englisch)
- Moodle App Release Notes (englisch)
- Moodle App Entwickler-Dokumentation (englisch)
- Zusatz-Plugin
- Mobile Webservices
