Ally-tools, filters en plugins voor rapporten installeren
Ally is compatibel met meerdere Moodle-hostingopties en -thema's. Dit zijn de ondersteunde versies en thema's in Ally:
Moodle 3.11.x
- Snap
- Boost
- Clean
- More
Moodle 4.0.x
- Snap
- Boost
Moodle 4.1.x
- Snap
- Boost
Moodle 4.2.x
- Snap
- Boost
Moodle 4.3.x
- Snap
- Boost
Ally-plugins voor 4.1 OpenLMS-omgevingen
OpenLMS zal zijn omgevingen bijwerken naar de versie 4.1 in aankomende onderhoudsvensters. Zie het release-schema van OpenLMS EDU. De Ally-plugins voor versie 4.1 wordt beschikbaar nadat de onderhoudsvensters zijn uitgevoerd en moet beschikbaar zijn in de matrix van plugins van OpenLMS.
Ally werkt met Moodle-versies ouder dan 3.10.x, maar oplossingen worden niet ondersteund. We raden je aan om je Moodle-versie te upgraden. Richtlijnen zijn beschikbaar bij ondersteuning voor Moodle-versies.
Opmerking: andere versies of thema's die niet worden genoemd, worden niet ondersteund door Ally.
Configureer de volgende plugins als je Ally met Moodle in zelfgehoste omgevingen wilt configureren:
- Ally-beheerderstools
- Ally-filter
- LTI Ally-rapport
Omgevingen die door OpenLMS worden geïmplementeerd, zijn al geïntegreerd met Ally.
Configuratiestappen
Download of kloon de benodigde versie van de Ally-beheertool via github.
- Wordt gedownload als zip-bestand
- Je kunt, indien nodig, de versie van de branch wijzigen.
Bekijk het bestand version.php om te zien of het benodigde nummer en de benodigde release van Moodle ('vereiste') overeenkomt met je versie van Moodle. D.w.z. voor Moodle 3.11
$plugin->release = '3.11.6';
$plugin->requires = 2021051700;
De release ‘3.11.6’ zou met jouw Moodle 3.11-installatie moeten werken. Als deze parameters niet overeenkomen met die van je Moodle-installatie, moet je de branch mogelijk opnieuw wijzigen.
Meer informatie over de bijbehorende releases en versienummers van Moodle
- Download de bestanden naar de opslaglocatie met ‘Klonen of downloaden > Zip downloaden’
- Git-opslaglocatie klonen
De map met tools openen.
cd [moodle location]/admin/tool
- De opslaglocatie klonen
SSH gebruiken
git clone [email protected]:anthology-ally/moodle-tool_ally ally
HTTP gebruiken
git clone https://github.com/anthology-ally/moodle-tool_ally.git ally
Check de bijbehorende branch uit. D.w.z.: voor Moodle 3.11 is het MOODLE_311_STABLE
git checkout MOODLE_311_STABLE
Het uitchecken van de branch kan ook worden gebruikt voor het ontvangen van updates. Als je je Moodle-installatie dus hebt bijgewerkt, kun je de bijbehorende branch uitchecken. Als de branch niet gevonden is, kan het zijn dat je opslaglocatie verouderd is. Dit kan worden verholpen met een ophaalactie:
git fetch
- Wordt gedownload als zip-bestand
Download of kloon de benodigde versie van het Ally-filter via github.
- Wordt gedownload als zip-bestand
- Je kunt, indien nodig, de versie van de branch wijzigen.
Bekijk het bestand version.php om te zien of het benodigde nummer en de benodigde release van Moodle ('vereiste') overeenkomt met jouw versie van Moodle. D.w.z. voor Moodle 3.11
$plugin->release = '3.11.6';
$plugin->requires = 2021051700;
De release ‘3.11.6’ zou met jouw Moodle 3.11-installatie moeten werken. Als deze parameters niet overeenkomen met die van je Moodle-installatie, moet je de branch mogelijk opnieuw wijzigen.
Meer informatie over de bijbehorende releases en versienummers van Moodle.
- Download de bestanden naar de opslaglocatie met ‘Klonen of downloaden > Zip downloaden’
- Git-opslaglocatie klonen
De map met filters openen.
cd [moodle location]/filter
- De opslaglocatie klonen
SSH gebruiken
git clone [email protected]:anthology-ally/moodle-filter_ally ally
HTTP gebruiken
git clone https://github.com/anthology-ally/moodle-filter_ally.git ally
Check de bijbehorende branch uit. D.w.z.: voor Moodle 3.11 is het MOODLE_311_STABLE
git checkout MOODLE_311_STABLE
Het uitchecken van de branch kan ook worden gebruikt voor het ontvangen van updates. Als je je Moodle-installatie dus hebt bijgewerkt, kun je de bijbehorende branch uitchecken. Als de branch niet gevonden is, kan het zijn dat je opslaglocatie verouderd is. Dit kan worden verholpen met een ophaalactie:
git fetch
- Wordt gedownload als zip-bestand
Download de benodigde versie van de LTI-tool voor Ally-rapporten via github.
- Wordt gedownload als zip-bestand
- Je kunt, indien nodig, de versie van de branch wijzigen.
Bekijk het bestand version.php om te zien of het benodigde nummer en de benodigde release van Moodle ('vereiste') overeenkomt met jouw versie van Moodle. D.w.z. voor Moodle 3.11
$plugin->release = '3.11.6';
$plugin->requires = 2021051700;
De release ‘3.11.6’ zou met jouw Moodle 3.11-installatie moeten werken. Als deze parameters niet overeenkomen met die van je Moodle-installatie, moet je de branch mogelijk opnieuw wijzigen.
Meer informatie over de bijbehorende releases en versienummers van Moodle.
- Download de bestanden naar de opslaglocatie met ‘Klonen of downloaden > Zip downloaden’
- Git-opslaglocatie klonen
De map met rapporten openen
cd [moodle location]/report
- De opslaglocatie klonen
SSH gebruiken
git clone [email protected]:anthology-ally/moodle-report_allylti ally
HTTP gebruiken
git clone https://github.com/anthology-ally/moodle-report_allylti.git ally
Check de bijbehorende branch uit. D.w.z.: voor Moodle 3.11 is het MOODLE_311_STABLE
git checkout MOODLE_311_STABLE
Het uitchecken van de branch kan ook worden gebruikt voor het ontvangen van updates. Als je je Moodle-installatie dus hebt bijgewerkt, kun je de bijbehorende branch uitchecken. Als de branch niet gevonden is, kan het zijn dat je opslaglocatie verouderd is. Dit kan worden verholpen met een ophaalactie:
git fetch
- Wordt gedownload als zip-bestand
Controleer de mappenstructuur.
De map van de beheertool moet ally worden genoemd. Het pad moet als volgt zijn:
[yourmoodledir]/admin/tool/ally
De map met filters moet ally worden genoemd. Het pad moet als volgt zijn:
[yourmoodledir]/filter/ally
De map met rapporten moet allylti worden genoemd. Het pad moet als volgt zijn:
[yourmoodledir]/report/allylti
- Zorg dat elke map en de inhoud ervan leesbaar zijn door je webserver.
- Log in als beheerder van je Moodle-site en open de beheerpagina. Er wordt vervolgens gecontroleerd op nieuwe plugins en de volgende optie wordt weergegeven: Moodle-database nu upgraden. Klik op deze knop om de plugins te installeren.
- Na het installeren van de plugins navigeer je naar Systeembeheerder > Plugins > Beheertools > Ally.
Kies voor Ally-webservice automatisch configureren.
Op het volgende scherm wordt een webservice-token en een URL voor het testen van de Ally-webservice weergegeven.
Deze URL moet direct beschikbaar zijn via internet, zodat Ally er gebruik van kan maken.
Indien dit is gelukt, kopieer je de token van de Ally-webservice en de koppeling naar de webservice. Deel deze met de technische consultant of de technische supportmedewerker. Ze nemen contact met je op zodra alles aan hun kant is ingesteld en geven je de 'sleutel', het 'geheim', de 'opstart-URL', de 'URL voor het bijwerken van bestanden' en de 'client-ID'.
Als jouw Moodle-installatie gebruikmaakt van aangepaste verplichte velden voor gebruikersaccount, 'log dan in als' de gebruiker van de Ally-webservice die wordt aangemaakt door de plugin voor automatische configuratie om te garanderen dat deze velden ingevuld en opgeslagen zijn.
De Moodle-plugin configureren
De technische ondersteuning van Ally maakt de Ally-client aan met de Moodle Webservice Token die in een eerder deel is gegenereerd en geeft je technische informatie over het configureren van de Ally-plugin.
- Log in als Moodle-beheerder.
- Kies in Sitebeheer voor Plugins en Beheertools. Selecteer Ally-configuratie.
- Geef de volgende gegevens op
Inhoudsauteurs: De gebruikersrollen die contentauteurs zijn. Moet als volgt zijn: Manager, Cursusmaker, Docent (de standaardwaarden).
Deze mogen normaal gesproken niet worden gewijzigd. We willen je vragen om contact op te nemen met de technische ondersteuning van Ally om deze waarden te wijzigen.
- Sleutel: De LTI-sleutel die door de technische ondersteuning van Ally is verstrekt
- Geheim: Het LTI-geheim dat door de technische ondersteuning van Ally is verstrekt
- Opstart-URL: De LTI opstart-URL die door de technische ondersteuning van Ally is verstrekt
- URL voor het bijwerken van bestanden: De URL voor het bijwerken van bestanden/gebeurtenissen die door de technische ondersteuning van Ally is verstrekt. https://[AllyEnvironment].ally.ac/api/v1/events
- Client-ID: De Client-ID die door de technische ondersteuning van Ally is verstrekt
- Logboekbereik: Licht
- Wijzigingen opslaan.
Ally-instellingsrapport
Zodra de Ally-plugin is geconfigureerd, kun je het Ally-instellingsrapport openen.
Er worden geen gegevens in het rapport weergegeven tot synchronisatie van de Ally is uitgevoerd en het eerste rapport is gegenereerd.
Om het Ally-instellingsrapport te openen, ga je naar Sitebeheer en kies je voor Rapporten. Selecteer Toegankelijkheid.
Ally-filter
Wanneer je er klaar voor bent om de downloadopties voor de Ally-toegankelijkheidsscore en alternatieve toegankelijke versies beschikbaar te stellen in Moodle, moet je het Ally-filter activeren.
Het Ally-filter inschakelen
- Kies in Sitebeheer voor Plugins en Plugins-overzicht.
- Ga naar het gedeelte Tekstfilters en schakel het Ally-filter in.
- Verplaats het Ally-filter naar de hoogste positie in de Filter-lijst.
UI Ally-configuratie openen
We geven je instructies voor het openen van de Ally-configuratie tijdens de installatie. Dien een aanvraag in op Behind the Blackboard als je geen toegang hebt.
Cursussen configureren met Ally
Cursussen configureren
Ga naar de pagina Ally-configuratie en schakel Ally in voor alle cursussen of alleen voor bepaalde cursussen. De keuze is aan jou.
- Hier zie je in hoeveel cursussen Ally wordt gebruikt.
- Schakel Ally in of uit voor alle bestaande cursussen. Bepaal vooraf of je Ally ook wilt inschakelen voor alle nieuwe cursussen.
- Zoek naar specifieke cursussen of filter alle cursussen op Ingeschakeld, Uitgeschakeld en Semester.
- Ally in- of uitschakelen voor specifieke cursussen.
Ally in- of uitschakelen voor een bepaalde cursus
Als Ally is ingeschakeld, kunnen cursusleiders en studenten hun voordeel doen met de toegankelijkheidsscores, feedback voor cursusleiders en alternatieve formaten van Ally.
Het instellingsrapport is beschikbaar voor alle cursussen. Het doet er niet toe of Ally ingeschakeld of uitgeschakeld is in een cursus. De cursus verschijnt in het instellingsrapport.
Zoek vanuit Ally-configuratie de cursus die je wilt bijwerken. Gebruik het zoekvak en de filters om te zoeken op titel, ID en code van een cursus.
Selecteer Inschakelen of Uitschakelen in de kolom Ingeschakeld om Ally in of uit te schakelen.
- Ally is uitgeschakeld: Selecteer UI-integratie cursus inschakelen om in te schakelen
- Ally is ingeschakeld: Selecteer UI-integratie cursus uitschakelen om uit te schakelen
Ally in- of uitschakelen voor alle cursussen
Weet je niet zeker of Ally voor alle cursussen wordt gebruikt? Boven aan de pagina Ally-configuratie zie je voor hoeveel cursussen Ally op dit moment is ingeschakeld.
Als Ally is ingeschakeld, kunnen cursusleiders en studenten hun voordeel doen met de toegankelijkheidsscores, feedback voor cursusleiders en alternatieve formaten van Ally.
Het instellingsrapport is beschikbaar voor alle cursussen. Het doet er niet toe of Ally ingeschakeld of uitgeschakeld is in een cursus. De cursus verschijnt in het instellingsrapport.
Via de pagina Ally-configuratie kun je Ally voor elke bestaande cursus in- of uitschakelen. Selecteer Alle cursussen uitschakelen/inschakelen en selecteer Uitschakelen of Inschakelen.
Selecteer Inschakelen in toekomstige cursussen als Ally automatisch moet worden gebruikt in alle nieuwe cursussen.
Als je deze optie niet selecteert, wordt Ally niet gebruikt in nieuwe cursussen. Als je Ally op een later moment wilt inschakelen, moet je Ally inschakelen voor afzonderlijke cursussen.
Als je hebt aangegeven dat je Ally wilt uit- of inschakelen voor alle cursussen, moet je die keuze bevestigen. Selecteer Inschakelen in alle cursussen of Uitschakelen in alle cursussen, afhankelijk van wat je eerder hebt gekozen. Selecteer Annuleren als je van mening bent veranderd en niets wilt wijzigen.
Ally alleen inschakelen voor volledig nieuwe cursussen
Als Ally is ingeschakeld, kunnen cursusleiders en studenten hun voordeel doen met de toegankelijkheidsscores, feedback voor cursusleiders en alternatieve formaten van Ally.
Het instellingsrapport is beschikbaar voor alle cursussen. Het doet er niet toe of Ally ingeschakeld of uitgeschakeld is in een cursus. De cursus verschijnt in het instellingsrapport.
Selecteer Inschakelen in toekomstige cursussen als Ally automatisch moet worden gebruikt in alle nieuwe cursussen.
Als je deze optie niet selecteert, wordt Ally niet gebruikt in nieuwe cursussen. Als je Ally op een later moment wilt inschakelen, moet je Ally inschakelen voor afzonderlijke cursussen.
Help-instellingen configureren voor Ally
De instellingen voor Ally-gebruikershulp configureren
Configureer aangepaste hulpmeldingen die worden weergegeven in de modules Alternatieve formaten en Feedback voor cursusleiders. De aangepaste hulpmeldingen kunnen worden gebruikt om studenten en cursusleiders naar bestaande instellingsdocumenten te leiden, contactgegevens te delen, enzovoort. Wanneer er geen aangepaste meldingen zijn geconfigureerd, verwijzen de Help-koppelingen door naar deze pagina's in Blackboard Help:
- Alternatieve formaten: Op deze pagina wordt uitgelegd hoe en wanneer de verschillende alternatieve formaten gebruikt kunnen worden
- Help voor cursusleiders: Alle informatie over Ally waarvan cursusleiders op de hoogte moeten zijn voor hun cursussen
De inhoud van de aangepaste hulp kan worden geconfigureerd in de UI Ally-configuratie en maakt gebruik van de indeling Markdown om een gestructureerde (en toegankelijke) melding weer te geven.
- Ga naar Ally-configuratie en kies voor Help-instellingen.
- Kies de standaard of aangepaste hulp-optie voor zowel de help van de feedback voor cursusleiders als de help van de alternatieve formaten.
- Als je de aangepaste optie kiest, bewerk dan de aangepaste melding.
Gebruik de indeling Markdown om een gestructureerde (en toegankelijke) melding in te stellen.
- Selecteer Wijzigingen opslaan.
Hulp van expert configureren
Geef je cursusleiders en studenten eenvoudig toegang tot je team van toegankelijkheidsexperts. Schakel hulp van een expert in en geef je gebruikers een manier om meer hulp rechtstreeks aan te vragen in de alternatieve formaten en de deelvensters Feedback voor cursusleider.
Wanneer er een verzoek wordt ingediend, wordt er een e-mail met het helpverzoek en gegevens over de huidige cursus, het inhoudsitem en de gebruiker naar het e-mailadres verzonden dat jij configureert.
- Ga naar Ally-configuratie en kies voor Help-instellingen.
- Kies de Aangepaste hulp bieden voor zowel de help van de feedback voor cursusleiders als de help van de alternatieve formaten.
- Selecteer Hulp van expert inschakelen.
- Typ het e-mailadres voor je team van toegankelijkheidsexperts.
- Selecteer Wijzigingen opslaan.
De Ally API-gebruiker voor de Blackboard Learn-integratie moet de toestemming van 'Configuratiescherm voor systeembeheer (gebruikers) > Gebruikers' of 'system.user.view' hebben zodat Ally de studentnaam en het e-mailadres in de e-mail met het hulpverzoek zet. De Ally API-gebruiker voor de Moodle-integratie moet de toestemming van 'moodle/user:viewalldetails' hebben zodat Ally de studentnaam en het e-mailadres in de e-mail voor het hulpverzoek zet.
Ally-functies aanpassen
Ally-functievlaggen aanpassen
Je kunt sommige functies in- of uitschakelen om Ally aan te passen aan de voorkeuren van je instelling.
Ga naar Ally-configuratie en bepaal welke functies je wilt inschakelen.
- Ga naar Ally-configuratie en selecteer Functies.
- Zoek de functie die je wilt in- of uitschakelen en selecteer deze.
- AI-generatie van alternatieve beschrijvingen voor afbeeldingen: Wanneer afbeeldingen geen alternatieve tekst bevatten, kunnen cursusleiders gebruikmaken van de AI-assistent voor alternatieve tekst om moeiteloos suggesties te genereren. Door deze functie in te schakelen, ga je akkoord met onze Gebruiksvoorwaarden. Voor gedetailleerde informatie over de risico's en beperkingen van deze functie, zie onze Transparantie-opmerking.
- De insluitende lezer als alternatieve indeling: studenten kunnen de leeservaring verbeteren met deze online functie.
- Alternatieve indeling - vertaalde versie: Studenten kunnen een vertaalde alternatieve indeling van een origineel bestand downloaden.
- BeeLine Reader als alternatieve indeling: Studenten kunnen een BeeLine Reader als alternatieve indeling downloaden.
- Score-indicatoren in alle cursussen voor beheerders: beheerders kunnen de Ally-toegankelijkheidsscores zien in alle cursussen, ook cursussen waarbij Ally niet is ingeschakeld in de UI Ally-configuratie. Hierdoor kunnen ze problemen oplossen zonder dat ze Ally hoeven in te schakelen in de cursus.
Deze functievlag is beschikbaar voor D2L Brightspace, Instructure Canvas, Moodle en Schoology.
- De feedback van de cursusleider openen vanuit het instellingsrapport: Geef beheerders, diensten voor studenten met een beperking en instructieontwerpers toegang tot de feedback van cursusleiders.
- Feedback voor cursusleider voor WYSIWYG-inhoud (inhoud van de teksteditor): Cursusleiders en beheerders hebben toegang tot feedback voor inhoud die in je LMS WYSIWYG-editor is gemaakt. Vink het vakje 'LMS ingebouwde controle ook inschakelen' in om beide toegankelijkheidscontroles in te schakelen.
Meer informatie over WYSIWYG-toegankelijkheid voor cursusleiders
Deze functievlag schakelt de feedback voor cursusleiders of snelle correcties uit die worden uitgevoerd op HTML-bestanden die geüpload worden naar of aangemaakt worden in D2L Brightspace.
Gegevensintegratie van Ally in Impact by Instructure (voorheen EesySoft): Instellingen met een Impact by Instructure-licentie kunnen de interacties in de module Alternatieve formaten, de feedback van de cursusleider en het toegankelijkheidsrapport van de cursus gedetailleerder controleren. Instellingen kunnen deze gegevens gebruiken voor implementatierapporten en -campagnes binnen Impact by Instructure. De Impact by Instructure-integratie is standaard uitgeschakeld.
Voor deze integratie is een Impact by Instructure-licentie vereist.
- Selecteer Inschakelen of Uitschakelen om de functie in of uit te schakelen.