Installation d'outils, du filtre et de plug-ins de rapport Ally

Ally est compatible avec plusieurs thèmes et options d'hébergement de Moodle. Les versions et thèmes pris en charge dans Ally sont les suivants :

Moodle 3.11.x

  • Snap
  • Boost
  • Clean
  • Plus

Moodle 4.0.x

  • Snap
  • Boost

Moodle 4.1.x

  • Snap
  • Boost

Moodle 4.2.x

  • Snap
  • Boost

Moodle 4.3.x

  • Snap
  • Boost


Plug-in Ally pour les environnements OpenLMS 4.1
OpenLMS mettra à jour ses environnements vers la version 4.1 dans les prochaines fenêtres de maintenance. Consultez le calendrier des versions d'OpenLMS EDU. Le plug-in Ally pour la version 4.1 sera disponible après l'exécution des fenêtres de maintenance et devrait l'être dans la matrice des plug-ins OpenLMS.


Ally fonctionne avec les versions de Moodle antérieures à 3.10.x, mais les correctifs ne sont pas pris en charge. Nous vous suggérons de mettre à niveau votre version de Moodle. Consultez la page d'assistance de version de Moodle pour obtenir des instructions.

Remarque : les autres versions et thèmes non mentionnés ne sont pas pris en charge par Ally.

Pour configurer Ally avec Moodle sur les environnements auto-hébergés, configurez les plug-ins suivants :

  • Outils d'administration Ally
  • Filtre Ally
  • Rapports LTI Ally

Les environnements déployés par OpenLMS sont déjà intégrés à Ally.

Étapes de configuration

  1. Télécharger ou cloner la version requise de l'outil d'administration Ally à partir de GitHub.

    1. Téléchargement en tant que fichier ZIP
      1. Modifiez la version de branche si nécessaire.

      2. Consultez le fichier version.php pour vérifier que le numéro de version (« requires ») requis et la version Moodle requise correspondent à votre version de Moodle. Par exemple, pour Moodle 3.11 :

        $plugin->release = '3.11.6';

        $plugin->requires = 2021051700;

        La version « 3.11.6 » devrait fonctionner avec les installations de Moodle 3.11. Si ces paramètres ne correspondent pas à votre installation Moodle, vous devrez peut-être modifier à nouveau la branche.

        En savoir plus sur les versions et numéros de version de Moodle correspondants.

      3. Téléchargez le répertoire à l'aide de l'option « Cloner ou télécharger > Télécharger le ZIP ».
    2. Clonage du répertoire git

      1. Accédez au dossier d'outils.

        cd [moodle location]/admin/tool

      2. Clonez le répertoire

        • En utilisant SSH

          git clone [email protected]:anthology-ally/moodle-tool_ally ally

        • En utilisant HTTP

          git clone https://github.com/anthology-ally/moodle-tool_ally.git ally

      3. Extrayez la branche correspondante. Par exemple, pour Moodle 3.11, il s'agit de MOODLE_311_STABLE.

        git checkout MOODLE_311_STABLE

        Extraire une branche permet également d'obtenir des mises à jour. Par conséquent, si vous avez mis à jour votre installation Moodle, vous pouvez simplement extraire la branche correspondante. Si la branche est introuvable, votre répertoire est peut-être obsolète. Ceci peut être résolu grâce à la commande fetch :

        git fetch

  2. Télécharger ou cloner la version requise du filtre Ally à partir de GitHub.

    1. Téléchargement en tant que fichier ZIP
      1. Modifiez la version de branche si nécessaire.

      2. Consultez le fichier version.php pour vérifier que le numéro de version (« requires ») et la version Moodle requis correspondent à votre version de Moodle. Par exemple, pour Moodle 3.11 :

        $plugin->release = '3.11.6';

        $plugin->requires = 2021051700;

        La version « 3.11.6 » devrait fonctionner avec les installations de Moodle 3.11. Si ces paramètres ne correspondent pas à votre installation Moodle, vous devrez peut-être modifier à nouveau la branche.

        En savoir plus sur les versions et numéros de version de Moodle correspondants.

      3. Téléchargez le répertoire à l'aide de l'option « Cloner ou télécharger > Télécharger le ZIP ».
    2. Clonage du répertoire git

      1. Accédez au dossier de filtres.

        cd [moodle location]/filter

      2. Clonez le répertoire

        • En utilisant SSH

          git clone [email protected]:anthology-ally/moodle-filter_ally ally

        • En utilisant HTTP

          git clone https://github.com/anthology-ally/moodle-filter_ally.git ally

      3. Extrayez la branche correspondante. Par exemple, pour Moodle 3.11, il s'agit de MOODLE_311_STABLE.

        git checkout MOODLE_311_STABLE

        Extraire une branche permet également d'obtenir des mises à jour. Par conséquent, si vous avez mis à jour votre installation Moodle, vous pouvez simplement extraire la branche correspondante. Si la branche est introuvable, votre répertoire est peut-être obsolète. Ceci peut être résolu grâce à la commande fetch :

        git fetch

  3. Télécharger ou cloner la version requise de l'outil LTI de rapport Ally à partir de GitHub.

    1. Téléchargement en tant que fichier ZIP
      1. Modifiez la version de branche si nécessaire.

      2. Consultez le fichier version.php pour vérifier que le numéro de version (« requires ») et la version Moodle requis correspondent à votre version de Moodle. Par exemple, pour Moodle 3.11 :

        $plugin->release = '3.11.6';

        $plugin->requires = 2021051700;

        La version « 3.11.6 » devrait fonctionner avec les installations de Moodle 3.11. Si ces paramètres ne correspondent pas à votre installation Moodle, vous devrez peut-être modifier à nouveau la branche.

        En savoir plus sur les versions et numéros de version de Moodle correspondants.

      3. Téléchargez le répertoire à l'aide de l'option « Cloner ou télécharger > Télécharger le ZIP ».
    2. Clonage du répertoire git

      1. Accédez au dossier de rapports.

        cd [moodle location]/report

      2. Clonez le répertoire

        • En utilisant SSH

          git clone [email protected]:anthology-ally/moodle-report_allylti ally

        • En utilisant HTTP

          git clone https://github.com/anthology-ally/moodle-report_allylti.git ally

      3. Extrayez la branche correspondante. Par exemple, pour Moodle 3.11, il s'agit de MOODLE_311_STABLE.

        git checkout MOODLE_311_STABLE

        Extraire une branche permet également d'obtenir des mises à jour. Par conséquent, si vous avez mis à jour votre installation Moodle, vous pouvez simplement extraire la branche correspondante. Si la branche est introuvable, votre répertoire est peut-être obsolète. Ceci peut être résolu grâce à la commande fetch :

        git fetch

  4. Vérifier la structure du dossier.

    Le nom du répertoire de l'outil d'administration doit être ally. Le chemin d'accès doit être le suivant :

    [yourmoodledir]/admin/tool/ally

    Le nom du répertoire du filtre doit être ally. Le chemin d'accès doit être le suivant :

    [yourmoodledir]/filter/ally

    Le nom du répertoire du rapport doit être allylti. Le chemin d'accès doit être le suivant :

    [yourmoodledir]/report/allylti

  5. Assurez-vous que chaque dossier et son contenu sont lisibles par votre serveur Web.
  6. Connectez-vous en tant qu'administrateur à votre site Moodle et ouvrez la page administrateur. Les nouveaux plug-ins disponibles seront recherchés et affichés le cas échéant, ainsi qu'une option permettant de Mettre à jour la base de données Moodle maintenant. Sélectionnez le bouton correspondant pour installer les plug-ins.
  7. Après avoir installé les plug-ins, accédez à Administration du système > Plug-ins > Outils d'administration > Ally.

  8. Sélectionnez Configurer automatiquement le service Web Ally.

    Sur l'écran suivant seront affichés un jeton de service Web et une URL pour tester le service Web Ally.

    Cette URL doit être directement accessible à partir d'Internet pour qu'Ally puisse l'utiliser.

    Si l'opération réussit, copiez le jeton du service Web d'Ally et le lien du service Web. Vous devrez ensuite le fournir à votre conseiller technique Ally ou à un technicien de l'assistance. Il vous contactera une fois tous les éléments configurés de son côté et vous fournira une « clé », un « secret », une « URL de lancement », ainsi qu'une « URL de mise à jour de fichier » et un « code client ».

    Si votre instance Moodle utilise des champs obligatoires personnalisés pour les comptes utilisateur, connectez-vous au compte utilisateur du service Web Ally créé par le plug-in d'auto-configuration pour vous assurer que les champs personnalisés sont renseignés et enregistrés.

Configurer le plug-in Moodle

Le conseiller technique Ally crée le client Ally à l'aide du jeton de service Web Moodle généré à l'étape précédente et vous fournit les détails de la configuration du plug-in Ally.

  1. Connectez-vous en tant qu'administrateur Moodle.
  2. Dans Administration du site sélectionnez Plug-ins et Outils d'administration. Sélectionnez Configuration Ally.
  3. Saisissez les détails suivants :

    • Auteurs de contenu : les rôles utilisateurs pouvant créer du contenu. Il s'agit généralement des personnes suivantes : gestionnaire, créateur de cours, professeur (valeurs par défaut).

      Il n'est normalement pas nécessaire de modifier ce paramètre, veuillez ne pas le modifier sans consulter le conseiller technique Ally.

    • Clé : la clé LTI fournie par le conseiller technique Ally
    • Secret : le secret LTI fourni par le conseiller technique Ally
    • URL de lancement : l'URL de lancement LTI fournie par le conseiller technique Ally
    • URL de mise à jour du fichier : l'URL d'événement / de mise à jour du fichier fournie par le conseiller technique Ally https://[AllyEnvironment].ally.ac/api/v1/events
    • Code client : le code client fourni par le conseiller technique Ally
    • Étendue du journal : faible
  4. Enregistrez les modifications.

Rapport d'établissement Ally

Une fois le plug-in Ally configuré, vous pourrez accéder au rapport d'établissement Ally.

Aucune donnée ne sera présente dans le rapport avant la synchronisation de cours Ally et la génération du rapport initial.

Pour accéder au rapport d'établissement Ally, rendez-vous sous Administration du site et sélectionnez Rapports. Sélectionnez Accessibilité.

En savoir plus sur le rapport d'établissement Ally

Filtre Ally

Lorsque vous êtes prêt à activer les indicateurs de résultat d'accessibilité et l'option de téléchargement de versions accessibles alternatives Ally au sein de Moodle, vous devez activer le filtre Ally.

Activer le filtre Ally

  1. Dans Administration du site, sélectionnez Plug-ins et Vue d'ensemble des plug-ins.
  2. Descendez jusqu'à la section Filtres de texte et activez le filtre Ally.
  3. Déplacez le filtre Ally vers le haut de la liste Filtre.

Accéder à l'interface d'utilisateur de configuration d'Ally

Lors de la configuration, nous vous fournissons les instructions pour accéder à la configuration Ally. Si vous n'avez pas accès à Ally, créez un ticket sur Behind the Blackboard.

Configuration de cours Ally

Configurer des cours

Accédez à votre page Configuration Ally et activez Ally pour tous les cours ou choisissez les cours qui vous intéressent. À vous de choisir.

  1. Découvrez combien de cours utilisent Ally.
  2. Activez ou désactivez Ally pour tous les cours existants. Décidez à l'avance si vous souhaitez l'activer également pour tous les cours à venir.
  3. Recherchez des cours spécifiques ou filtrez tous les cours selon leur statut d'activation ou le trimestre concerné.
  4. Activez ou désactivez Ally pour des cours spécifiques.

Activation ou désactivation d'Ally pour un cours spécifique

Lorsqu'Ally est activé, les professeurs et les étudiants accèdent aux résultats d'accessibilité, au feed-back du professeur et aux formats alternatifs offerts par la solution.

Le rapport d'établissement est disponible pour tous les cours, qu'Ally soit activé ou non. Le cours apparaît dans le rapport d'établissement.

Sur la page Configuration Ally, recherchez le cours à mettre à jour. Utilisez le champ Rechercher un cours et les filtres pour effectuer une recherche par titre ou par code de cours.

Activez ou désactivez Ally dans la colonne Activé.

  • Ally est désactivé : sélectionnez Enable course UI integration (Activer l'intégration du cours dans l'interface utilisateur) pour l'activer.
  • Ally est activé : sélectionnez Disable course UI integration (Désactiver l'intégration du cours dans l'interface utilisateur) pour le désactiver.

Activation ou désactivation d'Ally pour tous les cours

Vous ne savez pas vraiment si tous les cours utilisent Ally ou non ? Vous pouvez voir le nombre de cours qui utilisent actuellement Ally en haut de la page Configuration Ally.

Lorsqu'Ally est activé, les professeurs et les étudiants accèdent aux résultats d'accessibilité, au feed-back du professeur et aux formats alternatifs offerts par la solution.

Le rapport d'établissement est disponible pour tous les cours, qu'Ally soit activé ou non. Le cours apparaît dans le rapport d'établissement.

Vous pouvez activer ou désactiver Ally pour chaque cours existant sur la page Configuration Ally. Sélectionnez Disable/enable all courses (Désactiver/activer tous les cours), puis sélectionnez Désactiver ou Activer.

Sélectionnez Activer dans les prochains cours si vous souhaitez activer Ally automatiquement pour tous les nouveaux cours.

Si vous ne sélectionnez pas cette option, Ally ne sera pas activé pour les nouveaux cours. Si vous souhaitez activer Ally ultérieurement, activez Ally pour des cours spécifiques.

Après avoir choisi de désactiver ou d'activer Ally pour tous les cours, vous devez confirmer votre choix. Sélectionnez Activer ou Désactiver. Sélectionnez Annuler si vous avez changé d'avis et ne souhaitez rien modifier.

Activation d'Ally pour tous les nouveaux cours uniquement

Lorsqu'Ally est activé, les professeurs et les étudiants accèdent aux résultats d'accessibilité, au feed-back du professeur et aux formats alternatifs offerts par la solution.

Le rapport d'établissement est disponible pour tous les cours, qu'Ally soit activé ou non. Le cours apparaît dans le rapport d'établissement.

Sélectionnez Activer dans les prochains cours si vous souhaitez activer Ally automatiquement pour tous les nouveaux cours.

Si vous ne sélectionnez pas cette option, Ally ne sera pas activé pour les nouveaux cours. Si vous souhaitez activer Ally ultérieurement, activez Ally pour des cours spécifiques.

Configuration des paramètres d'aide Ally

Configurer les paramètres d'aide pour les utilisateurs d'Ally

Configurez les messages d'aide personnalisés qui s'affichent dans les modaux Formats alternatifs et Feed-back du professeur. Les messages d'aide personnalisés peuvent être utilisés pour indiquer aux étudiants et professeurs une documentation d'établissement existante, partager des informations de contact, etc. Si aucun message personnalisé n'a été configuré, les liens Aide dirigent vers ces pages de l'aide Blackboard :

  • Formats alternatifs : cette page explique comment et quand les différents formats alternatifs peuvent être utilisés
  • Aide pour les professeurs : Tous les professeurs doivent savoir comment fonctionne Ally pour leurs cours.

Le contenu de l'aide personnalisée peut être configuré dans le menu Configuration Ally. Le format Markdown y est utilisé pour fournir un message structuré et accessible.

  1. Accédez à votre Configuration Ally et sélectionnez Paramètres de l'aide.
  2. Choisissez l'option d'aide par défaut ou personnalisée pour les aides relatives au feed-back du professeur et aux formats alternatifs.
  3. Si vous choisissez l'option de personnalisation, modifiez le message personnalisé.

    Utilisez le format Markdown pour rédiger un message structuré (et accessible).

  4. Sélectionnez Enregistrer les modifications.

Configurer l'aide d'experts

Permettez à vos professeurs et aux étudiants de consulter facilement votre équipe d'experts en matière d'accessibilité. Activez l'aide d'experts pour mettre à la disposition de vos utilisateurs une aide supplémentaire, directement accessible à partir des volets de formats alternatifs et de feed-back du professeur.

Lorsqu'une aide est sollicitée, un e-mail contenant la demande et les détails relatifs au cours, à l'élément de contenu et à l'utilisateur concernés est envoyé à l'adresse e-mail que vous configurez.

  1. Accédez à votre Configuration Ally et sélectionnez Paramètres de l'aide.
  2. Sélectionnez Fournir une aide personnalisée pour les aides relatives au feed-back du professeur et aux formats alternatifs.
  3. Sélectionnez Activer l'aide d'experts.
  4. Saisissez l'adresse e-mail de votre équipe d'experts en matière d'accessibilité.
  5. Sélectionnez Enregistrer les modifications.

L'utilisateur de l'API d'Ally pour l'intégration de Blackboard Learn doit disposer de l'autorisation « Panneau de configuration de l'administrateur (utilisateurs) > Utilisateurs » ou « system.user.view » pour permettre à Ally d'inclure le nom et l'adresse e-mail de l'étudiant dans l'e-mail de demande d'aide. L'utilisateur de l'API d'Ally pour l'intégration de Moodle doit disposer de l'autorisation « moodle/user:viewalldetails » pour permettre à Ally d'inclure le nom et l'adresse e-mail de l'étudiant dans l'e-mail de demande d'aide.

Personnaliser les fonctionnalités Ally

Personnaliser les indicateurs de fonctionnalités Ally

Vous pouvez activer ou désactiver certaines fonctionnalités pour personnaliser Ally en fonction des préférences de votre établissement.

Dans Configuration Ally, choisissez les fonctionnalités que vous souhaitez activer.

  1. Accédez à Configuration Ally et sélectionnez Fonctionnalités.
  2. Recherchez la fonctionnalité que vous souhaitez activer ou désactiver, puis sélectionnez-la.
    • Génération par l'IA de descriptions alternatives pour les images : Lorsque les images ne comportent pas de texte alternatif, les professeurs peuvent utiliser AI Alt Text Assistant pour générer facilement des suggestions. En activant cette fonctionnalité, vous acceptez nos Conditions d'utilisation. Pour des informations détaillées sur les risques et les limitations de cette fonctionnalité, consultez notre Note de transparence.
    • Format alternatif Lecteur immersif : cette fonctionnalité en ligne permet aux étudiants d'améliorer l'expérience de lecture.
    • Format alternatif de la version traduite : les étudiants peuvent télécharger un format alternatif traduit d'un fichier original.
    • Format alternatif BeeLine Reader : les étudiants peuvent télécharger un format alternatif BeeLine Reader.
    • Indicateurs de résultat dans tous les cours pour les administrateurs : Les administrateurs peuvent voir les indicateurs de résultat d'accessibilité Ally dans tous les cours, y compris ceux où Ally n'est pas activé dans l'interface utilisateur de configuration Ally. Cela leur permet de résoudre les problèmes sans devoir activer Ally dans le cours.

    • Cet indicateur de fonctionnalité est disponible pour D2L BrightSpace, Instructure Canvas, Moodle et Schoology.

    • Accéder au feed-back du professeur depuis le rapport d'établissement : permet aux administrateurs, aux services en charge de l'accessibilité pour les personnes handicapées et aux concepteurs d'établissement d'accéder au feed-back du professeur.
    • Feed-back du professeur pour le contenu WYSIWYG (de l'éditeur de texte enrichi) : les professeurs et administrateurs peuvent accéder au feed-back pour le contenu créé dans l'éditeur WYSIWYG de leur LMS. Cochez la case « Activer également le vérificateur intégré du LMS » pour activer les deux vérificateurs d'accessibilité.

    • En savoir plus sur l'accessibilité WYSIWYG pour les professeurs

      Cet indicateur de fonctionnalité désactive le feed-back du professeur ou les correctifs rapides sur les fichiers HTML chargés ou créés dans D2L BrightSpace.

    • Intégration des données Ally dans Impact by Instructure (anciennement EesySoft) : les établissements disposant d'une licence Impact by Instructure peuvent autoriser une surveillance plus détaillée des interactions dans les formats alternatifs modaux, le feed-back du professeur et le rapport d'accessibilité au cours. Les établissements peuvent utiliser ces données pour les rapports et les campagnes d'adoption dans Impact by Instructure. L'intégration Impact by Instructure est désactivée par défaut.

      Cette intégration nécessite une licence Impact by Instructure.

  3. Sélectionnez Activer ou Désactiver.