Ally in Moodle
Ally-Tools, -Filter und -Plugins für Berichte installieren
Ally ist mit mehreren Hosting-Optionen und -Themen von Moodle kompatibel. Folgende Versionen und Themen werden in Ally unterstützt:
Snap
Boost
Clean
Mehr
Snap
Boost
Snap
Boost
Snap
Boost
Snap
Boost
Snap
Boost
Snap
Boost
Boost
Anmerkung
Beachten Sie, dass das Snap-Theme im Gegensatz zu früheren Versionen für Moodle 5 nicht unterstützt wird.
Ally-Plugin für 4.1 OpenLMS-Umgebungen
OpenLMS wird seine Umgebungen in den kommenden Wartungsfenstern auf die Version 4.1 aktualisieren. Weitere Informationen finden Sie im OpenLMS EDU-Veröffentlichungsplan. Das Ally-Plugin für die Version 4.1 wird nach Ausführung der Wartungsfenster verfügbar sein und sollte in der OpenLMS-Plugin-Matrix verfügbar sein.
Ally funktioniert mit Moodle-Versionen vor 3.10.x, wobei Bugfixes jedoch nicht unterstützt werden. Wir empfehlen Ihnen, Ihre Moodle-Version zu aktualisieren. Anleitungen finden Sie unter Moodle-Versionsunterstützung.
Hinweis: Andere Versionen oder Themen, die nicht erwähnt werden, werden von Ally nicht unterstützt.
Um Ally mit Moodle in selbstgehosteten Umgebungen zu konfigurieren, konfigurieren Sie diese Plug-Ins:
Ally-Administratortools
Ally-Filter
Ally-Bericht-LTI
Von OpenLMS bereitgestellte Umgebungen sind bereits in ihre Ally.
Konfigurationsschritte
Herunterladen als ZIP-Datei
Ändern Sie bei Bedarf die Branch-Version.
Überprüfen Sie die version.php Datei, um festzustellen, ob die benötigte Moodle-Version ("erforderlich"), die Nummer und die Version mit Ihrer Moodle-Version übereinstimmen. D. h. Moodle 4.5
$plugin->Freigabe = '4.5.6';
$plugin->requires = 2021051700;
Die Version "4.5.6" sollte mit Moodle 4.5-Installationen funktionieren. Wenn diese Parameter nicht mit Ihrer Moodle-Installation übereinstimmen, müssen Sie den Zweig möglicherweise erneut ändern.
Laden Sie das Repository über Clone or download > Download ZIP‟ (Klonen oder herunterladen > ZIP herunterladen) herunter
Git-Repository wird geklont
Greifen Sie auf den Tools-Ordner zu.
cd [moodle-Standort]/admin/toolKlonen des Repositorys
Mit SSH
git clone git@github.com:anthology-ally/moodle-tool_ally allyMit HTTP
git clone https://github.com/anthology-ally/moodle-tool_ally.git ally
Checken Sie den entsprechenden Verzweigung aus, d.h. für Moodle 4.5 ist es MOODLE_450_STABLE
git checkout MOODLE_450_STABLEDas Auschecken des Zweigs kann auch zum Abrufen von Updates verwendet werden, wenn Sie also Ihre Moodle-Installation aktualisiert haben, können Sie einfach den entsprechenden Zweig auschecken. Wenn der Zweig nicht gefunden wird, ist Ihr Repository möglicherweise veraltet, dies kann behoben werden, indem Sie fetch ausführen:
git fetch
Herunterladen als ZIP-Datei
Ändern Sie bei Bedarf die Branch-Version
Überprüfen Sie die version.php Datei, um festzustellen, ob die benötigte Moodle-Version ("erforderlich"), die Nummer und die Version mit Ihrer Moodle-Version übereinstimmen. D. h. Moodle 4.5
$plugin->Freigabe = '4.5.6';
$plugin->requires = 2021051700;
Die Version "4.5.6" sollte mit Moodle 4.5-Installationen funktionieren. Wenn diese Parameter nicht mit Ihrer Moodle-Installation übereinstimmen, müssen Sie den Zweig möglicherweise erneut ändern.
Laden Sie das Repository über Clone or download > Download ZIP‟ (Klonen oder herunterladen > ZIP herunterladen) herunter
Git-Repository wird geklont
Greifen Sie auf den Ordner filters zu.
cd [moodle-Standort]/filterKlonen des Repositorys
Mit SSH
git clone git@github.com:anthology-ally/moodle-filter_ally allyMit HTTP
git clone https://github.com/anthology-ally/moodle-filter_ally.git ally
Checken Sie den entsprechenden Verzweigung aus, d.h. für Moodle 4.5 ist es MOODLE_450_STABLE
git checkout MOODLE_450_STABLEDas Auschecken des Zweigs kann auch zum Abrufen von Updates verwendet werden, wenn Sie also Ihre Moodle-Installation aktualisiert haben, können Sie einfach den entsprechenden Zweig auschecken. Wenn der Zweig nicht gefunden wird, ist Ihr Repository möglicherweise veraltet, dies kann behoben werden, indem Sie fetch ausführen:
git fetch
Herunterladen als ZIP-Datei
Ändern Sie bei Bedarf die Branch-Version
Überprüfen Sie die version.php Datei, um festzustellen, ob die benötigte Moodle-Version ("erforderlich"), die Nummer und die Version mit Ihrer Moodle-Version übereinstimmen. D. h. Moodle 4.5
$plugin->Freigabe = '4.5.6';
$plugin->requires = 2021051700;
Die Version "4.5.6" sollte mit Moodle 4.5-Installationen funktionieren. Wenn diese Parameter nicht mit Ihrer Moodle-Installation übereinstimmen, müssen Sie den Zweig möglicherweise erneut ändern.
Laden Sie das Repository über Clone or download > Download ZIP‟ (Klonen oder herunterladen > ZIP herunterladen) herunter
Git-Repository wird geklont
Greifen Sie auf den Berichtsordner zu
CD [Moodle-Standort]/BerichtKlonen des Repositorys
Mit SSH
git clone git@github.com:anthology-ally/moodle-report_allylti allyMit HTTP
git clone https://github.com/anthology-ally/moodle-report_allylti.git ally
Checken Sie den entsprechenden Verzweigung aus, d.h. für Moodle 4.5 ist es MOODLE_450_STABLE
git checkout MOODLE_450_STABLEDas Auschecken des Zweigs kann auch zum Abrufen von Updates verwendet werden, wenn Sie also Ihre Moodle-Installation aktualisiert haben, können Sie einfach den entsprechenden Zweig auschecken. Wenn der Zweig nicht gefunden wird, ist Ihr Repository möglicherweise veraltet, dies kann behoben werden, indem Sie fetch ausführen:
git fetch
Überprüfen Sie die Ordnerstruktur.
Das Verzeichnis des Admin-Tools sollte den Namen
allyhaben. Es sollte einen Pfad wie folgt haben:[yourmoodledir]/admin/tool/allyDas Filterverzeichnis sollte den Namen
allyhaben. Es sollte einen Pfad wie folgt haben:[deinmoodledir]/filter/verbündetDas Berichtsverzeichnis sollte den Namen
allyltihaben. Es sollte einen Pfad wie folgt haben:[deinmoodledir]/bericht/allyltiStellen Sie sicher, dass jeder Ordner und sein Inhalt von Ihrem Webserver gelesen werden kann.
Melden Sie sich als Admin-Benutzer auf Ihrer Moodle-Site an und öffnen Sie die Admin-Seite. Hierdurch sollte eine Überprüfung auf neue Plugins erfolgen und es sollte eine Option zum Aktualisieren der Moodle-Datenbank angezeigt werden. Wählen Sie diese Schaltfläche, um die Plugins zu installieren.
Navigieren Sie nach der Installation der Plugins zu Systemadministration > Plugins > Administrator-Werkzeuge > Ally.
Wählen Sie die Option zum automatischen Konfigurieren des Ally-Webservice.
Auf dem nächsten Bildschirm werden ein Webdienst-Token und eine URL zum Testen des ally-Webdienstes angezeigt.
Diese URL muss direkt über das Internet zugänglich sein, damit Ally sie verwenden kann.
Wenn dies erfolgreich ist, müssen Sie das Ally-Webdienst-Token und den Webdienst-Link kopieren und sie Ihrem technischen Ally-Service-Berater oder dem Supporttechniker zur Verfügung stellen. Sie werden sich mit Ihnen in Verbindung setzen, sobald alles eingerichtet ist, und Ihnen den "Schlüssel", das "Geheimnis", die "Start-URL", die "URL für Dateiaktualisierungen" und die "Client-ID" zur Verfügung stellen.
Wenn Ihre Moodle-Instanz benutzerdefinierte Pflichtfelder für Benutzerkonten verwendet, "Melden Sie sich an als" der Ally-Webservice-Benutzer, der vom Plugin erstellt wird, automatisch konfigurieren, um sicherzustellen, dass diese benutzerdefinierten Felder ausgefüllt und gespeichert werden.
Konfigurieren des Moodle-Plugins
Die technische Beratung von Ally erstellt den Ally-Client unter Verwendung des im vorherigen Abschnitt generierten Moodle-Webservice-Tokens und stellt Ihnen die Details zur Konfiguration des Ally-Plugins zur Verfügung.
Melden Sie sich als Moodle-Administrator an.
Unter Website-Administration Wählen Sie Plugins und Administrator-Tools. Wählen Sie Ally-Konfiguration.
Geben Sie die folgenden Details ein
Inhaltsautoren: Die Benutzerrollen, bei denen es sich um Inhaltsautoren handelt. Muss sein: Manager, Kursersteller, Lehrer (die Standardeinstellungen).
Wichtig
Dies sollte normalerweise nicht geändert werden müssen, bitte ändern Sie dies nicht ohne Rücksprache mit dem technischen Berater von Ally.
Schlüssel: Der LTI-Schlüssel, der vom technischen Berater von Ally bereitgestellt wurde
Secret: Das LTI-Secret, das vom technischen Berater von Ally zur Verfügung gestellt wurde
Start-URL: Die LTI-Start-URL, die Ihnen vom Ally Technical Consultant bereitgestellt wurde
Dateiaktualisierungs-URL: Die Dateiaktualisierungs-/Ereignis-URL, die vom technischen Berater von Ally bereitgestellt wurde.
https://[AllyEnvironment].ally.ac/api/v1/eventsClient-ID: Die Client-ID, die vom technischen Berater von Ally bereitgestellt wurde
Log-Bereich: Leicht
Speichern Sie die Änderungen.
Ally-Institutionsbericht
Sobald das Ally-Plugin konfiguriert wurde, können Sie auf den Ally-Institutionsbericht zugreifen.
Anmerkung
Der Bericht enthält erst dann Daten, wenn die Synchronisierung des Ally-Kurses erfolgt ist und der erste Bericht erstellt wurde.
Um auf den Ally-Institutionsbericht zuzugreifen, gehen Sie zu Website-Administration und wählen Sie Berichte. Wählen Sie Barrierefreiheit aus.
Ally-Filter
Wenn Sie bereit sind, die Ally-Indikatoren für die Barrierefreiheit und die Download-Option für alternative barrierefreie Versionen in Moodle zur Verfügung zu stellen, müssen Sie den Ally-Filter aktivieren.
Aktivieren des Ally-Filters
Wählen Sie in Website-Administration die Option Plugins und Plugin-Übersicht.
Gehen Sie zum Abschnitt Textfilter und aktivieren Sie den Ally-Filter.
Verschieben Sie den Ally-Filter an die oberste Position in der Liste Filter.
Zugriff auf die Benutzeroberfläche für die Verbündetenkonfiguration
Bei der Einrichtung erhalten Sie Anweisungen dazu, wie Sie die Ally-Konfiguration aufrufen. Wenn Sie keinen Zugriff haben, reichen Sie einen Supportfall im Anthology Global Support Center ein.
Konfigurieren von Kursen
Aktivieren Sie auf der Seite Ally-Konfiguration Ally für alle Kurse oder für einzelne Kurse. Ganz, wie Sie möchten.
Zeigen Sie die Anzahl Ihrer Kurse an, die Ally verwenden.
Sie können Ally für alle vorhandenen Kurse aktivieren oder deaktivieren. Entscheiden Sie sich rechtzeitig, wenn Ally auch für alle zukünftigen Kurse aktiviert werden soll.
Suchen Sie nach einzelnen Kursen oder filtern Sie alle Kurse nach „Aktiviert“, „Deaktiviert“ und „Kursabschnitt“.
Sie können Ally für alle vorhandenen Kurse aktivieren oder deaktivieren.
Ally für einen einzelnen Kurs ein- oder ausschalten
Wenn Ally aktiviert ist, profitieren Dozenten und Teilnehmer von den Bewertungen der Barrierefreiheit, vom Dozentenfeedback und von den durch Ally bereitgestellten Alternativformaten.
Anmerkung
Der Einrichtungsbericht ist für alle Kurse verfügbar. Dabei spielt es keine Rolle, ob Ally in einem Kurs aktiviert ist oder nicht. Der Kurs erscheint im Einrichtungsbericht.
Suchen Sie unter Ally-Konfiguration den Kurs, den Sie aktualisieren möchten. Im Feld Suchen können Sie anhand von Filtern nach Kurstitel, Kurs-ID und Kurscode suchen.
Wählen Sie in der Spalte Aktiviert die Option Aktivieren oder Deaktivieren, um Ally zu aktivieren bzw. zu deaktivieren.
Ally ist deaktiviert: Wählen Sie Integration der Kurs-UI aktivieren aus, um die Option zu aktivieren
Ally ist aktiviert: Wählen Sie Integration der Kurs-Benutzeroberfläche deaktivieren aus, um die Option zu deaktivieren
Ally für alle Kurse aktivieren oder deaktivieren
Tipp
Sie sind sich nicht sicher, ob alle Kurse Ally verwenden oder nicht? Oben auf der Seite "Ally-Konfiguration" wird angezeigt, wie viele Kurse zurzeit Ally nutzen.
Wenn Ally aktiviert ist, profitieren Dozenten und Teilnehmer von den Bewertungen der Barrierefreiheit, vom Dozentenfeedback und von den durch Ally bereitgestellten Alternativformaten.
Anmerkung
Der Einrichtungsbericht ist für alle Kurse verfügbar. Dabei spielt es keine Rolle, ob Ally in einem Kurs aktiviert ist oder nicht. Der Kurs erscheint im Einrichtungsbericht.
Sie können Ally für jeden vorhandenen Kurs auf der Seite Ally-Konfiguration aktivieren oder deaktivieren. Wählen Sie Alle Kurse deaktivieren/aktivieren und anschließend Deaktivieren oder Aktivieren.
Wählen Sie In zukünftigen Kursen aktivieren, wenn Ally automatisch in allen neuen Kursen aktiviert sein soll.
Tipp
Wenn Sie diese Option nicht aktivieren, ist Ally in neuen Kursen nicht aktiviert. Wenn Sie Ally zu einem späteren Zeitpunkt aktivieren möchten, aktivieren Sie Ally für einzelne Kurse.
Nachdem Sie für jeden Kurs die Entscheidung über die Aktivierung bzw. Deaktivierung getroffen haben, müssen Sie die Entscheidung bestätigen. Wählen Sie je nach Auswahl Aktivieren oder Deaktivieren. Wählen Sie Abbrechen, wenn Sie es sich anders überlegt haben und doch nichts ändern möchten.
Ally nur für alle neuen Kurse aktivieren
Wenn Ally aktiviert ist, profitieren Dozenten und Teilnehmer von den Bewertungen der Barrierefreiheit, vom Dozentenfeedback und von den durch Ally bereitgestellten Alternativformaten.
Anmerkung
Der Einrichtungsbericht ist für alle Kurse verfügbar. Dabei spielt es keine Rolle, ob Ally in einem Kurs aktiviert ist oder nicht. Der Kurs erscheint im Einrichtungsbericht.
Wählen Sie In zukünftigen Kursen aktivieren, wenn Ally automatisch in allen neuen Kursen aktiviert sein soll.
Tipp
Wenn Sie diese Option nicht aktivieren, ist Ally in neuen Kursen nicht aktiviert. Wenn Sie Ally zu einem späteren Zeitpunkt aktivieren möchten, aktivieren Sie Ally für einzelne Kurse.
Konfigurieren der Einstellungen für die Ally-Benutzerhilfe
Konfigurieren Sie eigene Hilfemeldungen, die in den Modulen Alternative Formate und Kursleiterfeedback angezeigt werden. Die benutzerdefinierten Hilfemeldungen können verwendet werden, um Teilnehmer und Kursleiter auf vorhandene institutionelle Dokumente zu verweisen, Kontaktinformationen zu teilen usw. Wenn keine benutzerdefinierte Nachricht konfiguriert wurde, verweisen die Hilfe-Links auf diese Seiten in der Blackboard-Hilfe:
Alternative Formate: Auf dieser Seite wird erklärt, wie und wann die verschiedenen alternativen Formate verwendet werden können
Kursleiter-Hilfe: Alles, was Kursleiter über Ally in ihren Kursen wissen müssen
Der benutzerdefinierte Hilfeinhalt kann in der Benutzeroberfläche Ally-Konfiguration konfiguriert werden und verwendet das Format Markdown, um eine strukturierte und zugängliche Nachricht bereitzustellen.
Gehen Sie zu Ally-Konfiguration und wählen Sie Hilfeeinstellungen aus.
Wählen Sie die standardmäßige oder benutzerdefinierte Option für die Kursleiterfeedback-Hilfe und die Hilfe zu alternativen Formaten.
Wenn Sie die benutzerdefinierte Option auswählen, bearbeiten Sie die benutzerdefinierte Nachricht.
Tipp
Verwenden Sie das Markdown-Format, um eine strukturierte (und barrierefreie) Nachricht bereitzustellen.
Wählen Sie Änderungen speichern aus.
Expertenhilfe konfigurieren
Stellen Sie Ihren Kursleitern und Teilnehmern einfachen Zugang zu Ihrem Team von Barrierefreiheitsexperten bereit. Aktivieren Sie Expertenhilfe, um Ihren Benutzern die Möglichkeit zu geben, direkt Hilfe zu den alternativen Formaten und zu den Kursleiterfeedback-Feldern anzufordern.
Wenn eine Anfrage gestellt wird, wird eine E-Mail mit der Hilfeanfrage und den Details über den aktuellen Kurs, das Inhaltselement und den Benutzer an die von Ihnen konfigurierte E-Mail-Adresse gesendet.
Gehen Sie zu Ally-Konfiguration und wählen Sie Hilfeeinstellungen aus.
Wählen Sie für die Kursleiterfeedback-Hilfe und die Hilfe zu alternativen Formaten Benutzerdefiniertes Feedback bereitstellen aus.
Wählen Sie Expertenhilfe aktivieren aus.
Geben Sie die E-Mail-Adresse Ihres Expertenteams für Barrierefreiheit ein.
Wählen Sie Änderungen speichern aus.
Wichtig
Sie müssen dem Ally-API-Benutzer für die Blackboard Learn-Integration die Berechtigung „Administrator Panel (Users) > Users“ oder „system.user.view“ zuweisen, damit Ally den Namen und die E-Mail-Adresse des Teilnehmers in die Hilfeanfrage-E-Mail einfügen kann. Sie müssen dem Ally-API-Benutzer für die Moodle-Integration die Berechtigung „moodle/user:viewalldetails“ zuweisen, damit Ally den Namen und die E-Mail-Adresse des Teilnehmers in die Hilfeanfrage-E-Mail einfügen kann.
Hilfe zu alternativen Formaten anfordern
Hilfe beim Feedback von Kursleitern anfordern
Flags für Ally-Funktionen anpassen
Sie können einige Funktionen aktivieren bzw. deaktivieren, um Ally entsprechend den Wünschen Ihrer Institution anzupassen.
Legen Sie in der Ally-Konfiguration fest, welche Funktionen aktiviert werden sollen.
Wechseln Sie zu Ally-Konfiguration und wählen Sie Funktionen aus.
Suchen Sie nach der Funktion, die Sie aktivieren bzw. deaktivieren möchten, und wählen Sie sie aus.
KI-Generierung alternativer Beschreibungen für Bilder: Wenn Bilder keinen Alternativtext enthalten, können Kursleiter den KI-Alt-Text-Assistenten nutzen, um mühelos Vorschläge zu generieren. Durch die Aktivierung dieser Funktion erklären Sie sich mit unseren Nutzungsbedingungen einverstanden. Detaillierte Informationen zu den Risiken und Einschränkungen dieser Funktion finden Sie in unserem Transparenzhinweis.
Alternatives Format des plastischen Readers: Mit dieser Onlinefunktion können Teilnehmer das Leseerlebnis verbessern.
Übersetzte Version alternatives Format: Teilnehmer können ein übersetztes alternatives Format einer Originaldatei herunterladen.
BeeLine Reader alternatives Format: Teilnehmer können ein alternatives BeeLine Reader-Format herunterladen.
Punkteindikatoren in allen Kursen für Administratoren: Administratoren können die Bewertungsindikatoren für die Barrierefreiheit von Ally in allen Kursen sehen, einschließlich Kursen, in denen Ally in der Ally-Konfigurationsoberfläche nicht aktiviert ist. Auf diese Weise können sie Probleme beheben, ohne Ally im Kurs aktivieren zu müssen.
Wichtig
Dieses Funktionsflag ist für D2L Brightspace, Instructure Canvas, Moodle und Schoology verfügbar.
Greifen Sie über den institutionellen Bericht auf das Feedback des Kursleiters zu: Gewähren Sie Administratoren, Behindertendiensten und Instruktionsdesignern Zugriff auf das Feedback des Kursleiters.
Kursleiter-Feedback für WYSIWYG-Inhalte (Rich-Text-Editor-Inhalte): Kursleiter und Administratoren können auf Feedback für Inhalte zugreifen, die in Ihrem LMS-WYSIWYG-Editor erstellt wurden. Aktivieren Sie das Kontrollkästchen "Auch den integrierten LMS-Checker aktivieren", um beide Barrierefreiheitsprüfungen zu aktivieren.
Anmerkung
Dieses Feature-Flag deaktiviert das Kursleiter-Feedback oder Quick Fixes für HTML-Dateien, die in D2L Brightspace hochgeladen oder erstellt wurden.
Integration von Ally-Daten in Impact by Instructure (ehemals EesySoft): Institutionen mit einer Impact by Instructure-Lizenz können eine detailliertere Überwachung der Interaktionen in dem Modul „Alternative Formate“, im Feedback des Kursleiters und im Bericht zur Kursbarrierefreiheit ermöglichen. Institutionen können diese Daten für Akzeptanzberichte und Kampagnen in Impact by Instructure nutzen. Die Impact by Instructure-Integration ist standardmäßig deaktiviert.
Anmerkung
Für diese Integration ist eine Impact by Instructure-Lizenz erforderlich.
Wählen Sie Aktivieren oder Deaktivieren aus, um die Funktion zu aktivieren bzw. zu deaktivieren.
