Instal·lació d'eines, filtres i complements d'informes d'Ally

Les versions 3.3 dels complements són compatibles amb Moodle 3.2.

  1. Descarregueu o cloneu de github la versió que necessiteu de l'eina d'administració d'Ally.

    1. Descàrrega en format ZIP
      1. Canvieu la versió de branca, si escau.
      2. Reviseu el fitxer version.php per comprovar si el número de versió de Moodle coincideix amb la vostra versió de Moodle. Per exemple, per a Moodle 3.4

        $plugin->release = '3.4.3';

        $plugin->requires = 2017111300;

        La versió "3.4.3" hauria de ser compatible amb les instal·lacions de Moodle 3.4. Si aquest paràmetres no coincideixen amb la vostra instal·lació de Moodle, és possible que hàgiu de tornar a canviar de branca.

        Més informació sobre les versions de Moodle i els números de versió

      3. Descarregueu el repositori des de "Clona o descarrega > Descarrega el ZIP"
    2. Clonació del repositori git
      1. Accediu a la carpeta d'eines

        cd [moodle location]/admin/tool

      2. Clonació del repositori
        • Amb SSH

          git clone [email protected]:blackboard-open-source/moodle-tool_ally ally

        • Amb HTTP

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

      3. Comproveu la branca corresponent, per exemple, per a Moodle 3.4 és MOODLE_34_STABLE

        git checkout MOODLE_34_STABLE

        Comprovar la branca també pot servir per obtenir actualitzacions, de manera que si heu actualitzat la instal·lació de Moodle, només cal que comproveu quina branca li correspon. Si no la trobeu, és possible que la vostra reposició estigui obsoleta, cosa que es pot solucionar de la manera següent:

        git fetch

  2. Descarregueu o cloneu de github la versió que necessiteu del filtre d'Ally.

    1. Descàrrega en format ZIP
      1. Canvieu la versió de branca si escau.
      2. Reviseu el fitxer version.php per comprovar si el número de versió de Moodle coincideix amb la vostra versió de Moodle. Per exemple, per a Moodle 3.4

        $plugin->release = '3.4.3';

        $plugin->requires = 2017111300;

        La versió "3.4.3" hauria de ser compatible amb les instal·lacions de Moodle 3.4. Si aquest paràmetres no coincideixen amb la vostra instal·lació de Moodle, és possible que hàgiu de tornar a canviar de branca.

        Més informació sobre les versions de Moodle i els números de versió.

      3. Descarregueu el repositori des de "Clona o descarrega > Descarrega el ZIP"
    2. Clonació del repositori git
      1. Accediu a la carpeta de fitxers.

        cd [moodle location]/filter

      2. Clonació del repositori
        • Amb SSH

          git clone [email protected]:blackboard-open-source/moodle-filter_ally ally

        • Amb HTTP

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

      3. Comproveu la branca corresponent, per exemple, per a Moodle 3.4 és MOODLE_34_STABLE

        git checkout MOODLE_34_STABLE

        Comprovar la branca també pot servir per obtenir actualitzacions, de manera que si heu actualitzat la instal·lació de Moodle, només cal que comproveu quina branca li correspon. Si no la trobeu, és possible que la vostra reposició estigui obsoleta, cosa que es pot solucionar de la manera següent:

        git fetch

  3. Descarregueu de github la versió que necessiteu de l'eina LTI de l'informe d'Ally.

    1. Descàrrega en format ZIP
      1. Canvieu la versió de branca si escau.
      2. Reviseu el fitxer version.php per comprovar si el número de versió de Moodle coincideix amb la vostra versió de Moodle. Per exemple, per a Moodle 3.4

        $plugin->release = '3.4.3';

        $plugin->requires = 2017111300;

        La versió "3.4.3" hauria de ser compatible amb les instal·lacions de Moodle 3.4. Si aquest paràmetres no coincideixen amb la vostra instal·lació de Moodle, és possible que hàgiu de tornar a canviar de branca.

        Més informació sobre les versions de Moodle i els números de versió.

      3. Descarregueu el repositori des de "Clona o descarrega > Descarrega el ZIP"
    2. Clonació del repositori git
      1. Accediu a la carpeta d'informes

        cd [moodle location]/report

      2. Clonació del repositori
        • Amb SSH

          git clone [email protected]:blackboard-open-source/moodle-report_allylti ally

        • Amb HTTP

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

      3. Comproveu la branca corresponent, per exemple, per a Moodle 3.4 és MOODLE_34_STABLE

        git checkout MOODLE_34_STABLE

        Comprovar la branca també pot servir per obtenir actualitzacions, de manera que si heu actualitzat la instal·lació de Moodle, només cal que comproveu quina branca li correspon. Si no la trobeu, és possible que la vostra reposició estigui obsoleta, cosa que es pot solucionar de la manera següent:

        git fetch

  4. Verifiqueu l'estructura de carpetes

    El directori d'eines d'administració s'hauria d'anomenar ally. Hauria de tenir un camí com aquest:

    [yourmoodledir]/admin/tool/ally

    El directori de filtres s'hauria d'anomenar ally. Hauria de tenir un camí com aquest:

    [yourmoodledir]/filter/ally

    El directori d'eines d'informe s'hauria d'anomenar allylti. Hauria de tenir un camí com aquest:

    [yourmoodledir]/report/allylti

  5. Assegureu-vos que el vostre servidor web pot llegir totes les carpetes i els continguts que contenen.
  6. Inicieu la sessió com a usuari administrador al vostre lloc de Moodle i obriu la pàgina d'administració. En fer-ho, es comprova si hi ha nous complements i s'ofereix l'opció Actualitza la base de dades de Moodle ara. Seleccioneu aquest botó per instal·lar els complements.
  7. Després d'instal·lar els complements, aneu a Administració del sistema > Complements > Eines d'administració > Ally.
  8. Seleccioneu Configura el servei Ally automàticament'.

    A la pantalla següent hi haurà un testimoni del servei web i un URL per provar el servei web d'Ally.

    Perquè Ally pugui fer-lo servir, aquest URL ha de ser accessible directament des d'Internet.

    Si funciona correctament, haureu de copiar el testimoni del servei web d'Ally i l'enllaç del servei web i proporcionar-lo a l'assessor tècnic d'Ally a través de l'espai compartit d'IronBox perquè us el configuri i us hi doni accés a través d'un enllaç enviat per correu electrònic. Quan ho hagin configurat tot, us ho comunicaran i us enviaran la clau, el secret, l'URL de llançament, l'URL d'actualitzacions de fitxer i l'identificador de client.

    Si la vostra instància de Moodle utilitza els camps obligatoris personalitzats per als comptes d'usuari, inicieu la sessió amb l'usuari del servei web d'Ally que crea el complement de configuració automàtica per assegurar que els camps personalitzats s'emplenen i es desen.


Configuració del complement de Moodle

L'assessor tècnic d'Ally crearà el client d'Ally amb el testimoni del servei web de Moodle que es genera a la secció anterior i us proporcionarà els detalls per configurar el complement d'Ally.

  1. Inicia la sessió com a administrador de Moodle.
  2. A Administració del lloc, seleccioneu Complements i Eines d'administració. Seleccioneu Configuració d'Ally.
  3. Introduïu els detalls següents
    • Autors de contingut: Els rols d'usuari que són autors de contingut. Han de ser: Gestor, Creador de curs, Docent (els predeterminats).

      Això generalment no s'ha de canviar i es recomana que no ho feu sense consultar-ho abans amb l'assessor tècnic d'Ally.

    • Clau: La clau d'LTI que us ha proporcionat l'assessor tècnic d'Ally.
    • Secret: El secret d'LTI que us ha proporcionat l'assessor tècnic d'Ally.
    • URL de llançament: L'URL de llançament que us ha proporcionat l'assessor tècnic d'Ally.
    • URL d'actualització del fitxer: L'URL d'esdeveniment o actualització del fitxer que us ha proporcionat l'assessor tècnic d'Ally. https://[AllyEnvironment].ally.ac/api/v1/events
    • Identificador de client: L'identificador de client que us ha proporcionat l'assessor tècnic d'Ally.
  4. Deseu els canvis.

Informe institucional d'Ally

Quan s'hagi configurat el complement d'Ally, podreu accedir a l'informe institucional d'Ally.

No hi haurà cap dada a l'informe fins que s'hagi dut a terme la sincronització del curs d'Ally i s'hagi generat l'informe inicial.

Per accedir a l'informe institucional d'Ally, aneu a Administració del lloc i seleccioneu Informes. Seleccioneu Accessibilitat.

Més informació sobre l'informe institucional d'Ally


Filtre d'Ally

Quan estigueu preparat per tenir els indicadors de puntuació d'accessibilitat d'Ally i l'opció de descàrrega de la versió accessible alternativa dins de Moodle, haureu d'activar el filtre d'Ally.

Activació del filtre d'Ally

  1. Des de l'opció Administració del lloc seleccioneu Complements i Descripció general dels complements.
  2. Baixeu fins a la secció Filtres de text i activeu el filtre d'Ally.
  3. Moveu el filtre d'Ally a dalt de tot de la llista de filtres.

Accés a la IU de configuració d'Ally

Us proporcionem les instruccions per accedir a la Configuració d’Ally  durant la instal·lació. Si no hi teniu accés, envieu una sol·licitud a Behind the Blackboard.

Ally Configure Courses


Configure courses

Go to your Ally Configuration page and turn Ally on for all courses or decide course-by-course. It's up to you.

  1. View how many of your courses use Ally.
  2. Turn Ally on or off for all existing courses. Decide ahead of time if you want it enabled for all future courses as well.
  3. Search for individual courses or filter all course by enabled, disabled, and term.
  4. Turn Ally on or off for individual courses.

Turn Ally on or off for a single course

When Ally is on, instructors and students benefit from the accessibility scores, instructor feedback and alternative formats that Ally provides.

The Institutional report is available for all courses. It doesn't matter if Ally is on or off in a course. The course appears in the Institutional report.

From Ally Configuration, find the course you want to update. Use the Search field and filters to search by course title, course ID and course code.

Select Enable or Disable under the Enabled column to turn Ally on or off.

  • Ally is off: Select Enable course UI integration to turn on
  • Ally is on: Select Disable course UI integration to turn off

Turn Ally on or off for all courses

Not sure if all courses are using Ally or not? At the top of the Ally Configuration page, see how many of your courses are currently using Ally.

When Ally is on, instructors and students benefit from the accessibility scores, instructor feedback and alternative formats that Ally provides.

The Institutional report is available for all courses. It doesn't matter if Ally is on or off in a course. The course appears in the Institutional report.

You can turn Ally on or off in every existing course from the Ally Configuration page. Select Disable/enable all courses and select Disable or Enable.

Select Enable in future courses if you want Ally automatically on in all new courses.

If you don't select this, new courses will not have Ally enabled. If you want Ally on at a later date, turn Ally on for single courses.

After you choose to disable or enable in all courses, you need to confirm your choice. Select Enable or Disable, depending on your choice. Select Cancel if you changed your mind and don't want to change anything.


Turn Ally on for all new courses only

When Ally is on, instructors and students benefit from the accessibility scores, instructor feedback and alternative formats that Ally provides.

The Institutional report is available for all courses. It doesn't matter if Ally is on or off in a course. The course appears in the Institutional report.

Select Enable in future courses if you want Ally automatically on in all new courses.

If you don't select this, new courses will not have Ally enabled. If you want Ally on at a later date, turn Ally on for single courses.

Ally Configure Help Settings


Configure Ally user help settings

Configure custom help messages that display in the Alternative formats and Instructor feedback modals. The custom help messages can be used to point students and instructors to existing institutional documentation, share contact information, and so on. The custom help content can be configured in the Ally Configuration UI, and uses the Markdown format to help provide a structured (and accessible) message.

When no custom message has been configured, the Help links point to these pages in Blackboard help:

  • Alternative formats: This page explains how and when the different alternative formats can be used
  • Instructor help: Everything instructors need to know about Ally in their courses
  1. Go to your Ally Configuration and select Help settings.
  2. Choose the default or custom help option for both the Instructor feedback help and Alternative formats help.
  3. If you choose the custom option, edit the Custom message.

    Use the Markdown format to help provide a structured (and accessible) message.

  4. Select Save changes.

Configure expert help

Give your instructors and students easy access to your team of accessibility experts. Enable expert help to add a way for your users to request more help directly from in the alternative formats and instructor feedback panels.

When a request is made, an email containing the help request and details about the current course, content item and user is sent to the email address you configure.

  1. Go to your Ally Configuration and select Help settings.
  2. Choose Provide custom help for both the Instructor feedback help and Alternative formats help.
  3. Select Enable expert help.
  4. Type the email address for your team of accessibility experts.
  5. Select Save changes.

The Ally API user for the Blackboard Learn integration needs to be given the "Administrator Panel (Users) > Users" or "system.user.view" permission to allow Ally to include the student name and email address in the help request email. The Ally API user for the Moodle integration needs to be given the “moodle/user:viewalldetails” permission to allow Ally to include the student name and email address in the help request email.

Request alternative formats help

Request instructor feedback help