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

Ally prend en charge Moodle 3.4 et les versions ultérieures.

  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 ») et la version Moodle requis correspondent à votre version de Moodle. Par exemple, pour Moodle 3.4 :

        $plugin->release = '3.4.3';

        $plugin->requires = 2017111300;

        La version « 3.4.3 » devrait fonctionner avec les installations de Moodle 3.4. 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]:blackboard-open-source/moodle-tool_ally ally

        • En utilisant HTTP

          git clone https://github.com/blackboard-open-source/moodle-tool_ally.git ally

      3. Extrayez la branche correspondante, par ex. pour Moodle 3.4, il s'agit de MOODLE_34_STABLE.

        git checkout MOODLE_34_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.4 :

        $plugin->release = '3.4.3';

        $plugin->requires = 2017111300;

        La version « 3.4.3 » devrait fonctionner avec les installations de Moodle 3.4. 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]:blackboard-open-source/moodle-filter_ally ally

        • En utilisant HTTP

          git clone https://github.com/blackboard-open-source/moodle-filter_ally.git ally

      3. Extrayez la branche correspondante, par ex. pour Moodle 3.4, il s'agit de MOODLE_34_STABLE.

        git checkout MOODLE_34_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.4 :

        $plugin->release = '3.4.3';

        $plugin->requires = 2017111300;

        La version « 3.4.3 » devrait fonctionner avec les installations de Moodle 3.4. 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]:blackboard-open-source/moodle-report_allylti ally

        • En utilisant HTTP

          git clone https://github.com/blackboard-open-source/moodle-report_allylti.git ally

      3. Extrayez la branche correspondante, par ex. pour Moodle 3.4, il s'agit de MOODLE_34_STABLE.

        git checkout MOODLE_34_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 que 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. Pour se faire, il configurera un partage IronBox et vous enverra le lien d'accès correspondant par e-mail. 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

Nous vous fournissons les instructions pour accéder à la Configuration Ally lors de la configuration. 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 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.
    • 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.
    • 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 de l'éditeur de texte enrichi : les professeurs et les administrateurs peuvent accéder au feed-back pour le contenu créé dans votre éditeur WYSIWYG LMS.

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

    • 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.