Instal·lació d’eines, filtre i complements d’informe d’Ally

Ally és compatible amb un repertori d'opcions d'allotjament i temes de Moodle. Les versions i temes admesos a Ally són els següents:

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


Complement d'Ally per a entorns OpenLMS 4.1
OpenLMS actualitzarà els seus entorns a la versió 4.1 en properes finestres de manteniment. Consulteu el calendari de publicació d'OpenLMS EDU. El complement d'Ally per a la versió 4.1 estarà disponible un cop executades les finestres de manteniment i hauria d'estar disponible a la matriu de complements d'OpenLMS.


Ally funciona amb versions de Moodle anteriors a la 3.10.x, però no s'admeten les correccions. Us recomanem que actualitzeu la versió de Moodle. Trobareu orientacions a Compatibilitat de la versió de Moodle. 

Nota: Ally no admet versions o temes que no s'hagin mencionat.

Per configurar Ally amb Moodle en entorns d'allotjament propi, configureu aquests complements:

  • Eines d'administració d'Ally
  • Filtre d'Ally
  • LTI d'informe d'Ally

Els entorns desplegats per OpenLMS ja estan integrats a Ally. 

Passos per a la configuració

  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 i la publicació de la versió de Moodle necessària coincideixen amb la vostra versió de Moodle. P. ex., per a Moodle 3.11

        $plugin->release = '3.11.6';

        $plugin->requires = 2021051700;

        La versió "3.11.6" hauria de ser compatible amb les instal·lacions de Moodle 3.11. Si aquests 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]:anthology-ally/moodle-tool_ally ally

        • Amb HTTP

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

      3. Comproveu la branca corresponent, és a dir, per a Moodle 3.11 és MOODLE_311_STABLE

        git checkout MOODLE_311_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. P. ex., per a Moodle 3.11

        $plugin->release = '3.11.6';

        $plugin->requires = 2021051700;

        La versió "3.11.6" hauria de ser compatible amb les instal·lacions de Moodle 3.11. Si aquests 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]:anthology-ally/moodle-filter_ally ally

        • Amb HTTP

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

      3. Comproveu la branca corresponent, és a dir, per a Moodle 3.11 és MOODLE_311_STABLE

        git checkout MOODLE_311_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. P. ex., per a Moodle 3.11

        $plugin->release = '3.11.6';

        $plugin->requires = 2021051700;

        La versió "3.11.6" hauria de ser compatible amb les instal·lacions de Moodle 3.11. Si aquests 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]:anthology-ally/moodle-report_allylti ally

        • Amb HTTP

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

      3. Comproveu la branca corresponent, és a dir, per a Moodle 3.11 és MOODLE_311_STABLE

        git checkout MOODLE_311_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'informes 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 o a l'enginyer d'assistència. 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.
    • Interval del registre: Clar
  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.

Configuració d’Ally per als cursos

Configureu els cursos

Aneu a la pàgina Configuració d’Ally i activeu Ally per a tots els cursos o trieu si activar-lo o no curs per curs. És decisió vostra.

  1. Consulteu quants dels vostres cursos utilitzen Ally.
  2. Activeu o desactiveu Ally per a tots els cursos existents. Decidiu amb antelació si voleu activar-lo també per als cursos futurs.
  3. Cerqueu cursos individuals o filtreu tots els cursos segons si el tenen activat o no i segons el trimestre.
  4. Activeu o desactiveu Ally per a cursos individuals.

Activació o desactivació d’Ally per a un sol curs

Quan Ally està activat, els instructors i els estudiants es beneficien de les puntuacions d'accessibilitat, els comentaris de l'instructor i els formats alternatius que proporciona Ally.

L'Informe institucional està disponible per a tots els cursos. No importa si Ally està activat o desactivat en un curs. El curs figura a l’Informe institucional.

A Configuració d’Ally, cerqueu el curs que voleu actualitzar. Utilitzeu el camp Cerca i els filtres per cercar per títol, identificador i codi del curs.

Seleccioneu Activa o Desactiva a la columna Activat per activar o desactivar Ally.

  • Ally està desactivat:
  • Ally està activat:

Activació o desactivació d’Ally per a tots els cursos

Teniu dubtes de si tots els cursos utilitzen Ally o no? Podeu consultar el nombre de cursos que utilitzen Ally actualment a la part superior de la pàgina Configuració d'Ally.

Quan Ally està activat, els instructors i els estudiants es beneficien de les puntuacions d'accessibilitat, els comentaris de l'instructor i els formats alternatius que proporciona Ally.

L'Informe institucional està disponible per a tots els cursos. No importa si Ally està activat o desactivat en un curs. El curs figura a l’Informe institucional.

Podeu activar o desactivar Ally en qualsevol curs existent des de la pàgina Configuració d'Ally. Seleccioneu Activa/Desactiva tots els cursos i seleccioneu Desactiva o Activa.

Seleccioneu Activa en cursos futurs si voleu que Ally s'activi automàticament a tots els cursos nous.

Si no seleccioneu aquesta opció, els cursos nous no tindran Ally activat. Si voleu utilitzar Ally més endavant, activeu-lo per a cursos individuals.

Després de triar entre activar o desactivar Ally a tots els cursos, heu de confirmar-ho. Seleccioneu Activa o Desactiva, segons què trieu. Seleccioneu Cancel·la si heu canviat d'idea i no voleu modificar res.

Activació d’Ally només per als cursos nous

Quan Ally està activat, els instructors i els estudiants es beneficien de les puntuacions d'accessibilitat, els comentaris de l'instructor i els formats alternatius que proporciona Ally.

L'Informe institucional està disponible per a tots els cursos. No importa si Ally està activat o desactivat en un curs. El curs figura a l’Informe institucional.

Seleccioneu Activa en cursos futurs si voleu que Ally s'activi automàticament a tots els cursos nous.

Si no seleccioneu aquesta opció, els cursos nous no tindran Ally activat. Si voleu utilitzar Ally més endavant, activeu-lo per a cursos individuals.

Ally Yardım Ayarlarını Yapılandırma

Ally kullanıcı yardımı ayarlarını yapılandırma

Alternatif biçimler ve Eğitmen geri bildirimi modlarında görüntülenen özel yardım iletilerini yapılandırın. Özel yardım iletileri öğrencileri ve eğitmenleri mevcut kurum belgelerine yönlendirmek, iletişim bilgilerini paylaşmak vb. için kullanılabilir. Herhangi bir özel ileti yapılandırılmamışsa Yardım bağlantıları Blackboard yardım bölümünde şu sayfalara yönlendirir:

  • Alternatif biçimler: Bu sayfada, farklı alternatif biçimlerin nasıl ve ne zaman kullanılabileceği açıklanmaktadır
  • Eğitmen yardımı: Eğitmenlerin, kurslarında Ally ile ilgili bilmesi gereken her şey

Özel yardım içeriği, Ally Yapılandırma arayüzünden yapılandırılabilir ve erişilebilir bir ileti sağlamaya yardımcı olmak için Markdown biçimini kullanır.

  1. Ally Yapılandırması bölümüne gidin ve Yardım ayarları ögesini seçin.
  2. Hem Eğitmen geri bildirimi yardımı hem de Alternatif biçimler yardımı için varsayılan veya özel yardım seçeneğini belirleyin.
  3. Özel seçeneğini belirlerseniz Özel iletiyi düzenleyin.

    Yapılandırılmış (ve erişilebilir) bir ileti sağlamaya yardımcı olması için Markdown biçimini kullanın.

  4. Değişiklikleri kaydet'i seçin.

Uzman yardımını yapılandır

Eğitmenleriniz ve öğrencilerinize, erişilebilirlik uzmanları ekibine kolay ulaşım olanağı sağlayın. Kullanıcılarınızın, doğrudan alternatif biçimler ve eğitmen geri bildirimi panellerinden daha fazla yardım talep etmesi için bir olanak eklemek üzere uzman yardımını etkinleştirin.

Bir talep oluşturulduğunda, yardım talebinin yanı sıra geçerli kurs, içerik ögesi ve kullanıcı hakkındaki ayrıntıları içeren bir e-posta, yapılandırma aşamasında belirttiğiniz e-posta adresine gönderilir.

  1. Ally Yapılandırması bölümüne gidin ve Yardım ayarları ögesini seçin.
  2. Hem "Eğitmen geri bildirimi yardımı" hem de "Alternatif biçimler yardımı" için Özel yardım sağlayın ögesini seçin.
  3. Uzman yardımını etkinleştir'i seçin.
  4. Erişilebilirlik uzmanları ekibinizin e-posta adreslerini yazın.
  5. Değişiklikleri kaydet'i seçin.

Yardım talebi e-postasına Ally'ın öğrenci adını ve e-posta adresini dâhil etmesine izin vermek amacıyla, Blackboard Learn entegrasyonu için Ally API kullanıcısına "Yönetici Paneli (Kullanıcılar) > Kullanıcılar" veya "system.user.view" izni verilmelidir. Ally'ın öğrenci adını ve e-posta adresini yardım talebi e-postasına dâhil etmesine olanak tanımak için, Moodle entegrasyonuna ait Ally API kullanıcısına "moodle/user:viewalldetails" izni verilmelidir.

Personalitzar les característiques d'Ally

Personalització dels marcadors de característiques d'Ally

Podeu activar o desactivar algunes característiques per personalitzar Ally segons les vostres preferències institucionals.

A Configuració d'Ally, decidiu quines característiques voleu habilitar.

  1. Aneu a Configuració d'Ally i seleccioneu Característiques.
  2. Trobeu la característica que voleu activar o desactivar i seleccioneu-la.
    • Generació de descripcions alternatives per a imatges amb IA: quan les imatges no tenen text alternatiu, els instructors poden aprofitar l'Assistent de text alternatiu amb tecnologia d'IA per generar suggeriments sense esforç. En activar aquesta funció, accepteu els nostres termes d'ús. Per obtenir informació detallada sobre els riscos i les limitacions d'aquesta característica, consulteu la nostra Nota de transparència.
    • Format alternatiu d'Immersive Reader: els estudiants poden millorar l'experiència de lectura amb aquesta característica en línia.
    • Format alternatiu de la versió traduïda: els estudiants poden baixar un format alternatiu traduït d’un fitxer original.
    • Format alternatiu de BeeLine Reader: els estudiants poden baixar un format alternatiu de BeeLine Reader.
    • Indicadors de puntuació en tots els cursos per a administradors: els administradors poden veure els indicadors de puntuació d'accessibilitat d'Ally a tots els cursos, inclosos els cursos en què Ally no està habilitat a la interfície d'usuari de configuració d'Ally. Això els permet solucionar problemes sense haver d'habilitar Ally al curs.

    • Aquesta marcador de característiques està disponible per a D2L Brightspace, Instructure Canvas, Moodle i Schoology.

    • Accediu als Comentaris de l’instructor des de l’Informe institucional: doneu als administradors, serveis de suport als discapacitats i dissenyadors educatius accés als Comentaris de l'instructor.
    • Comentaris de l'instructor per a contingut WYSIWYG (contingut de l'Editor de text enriquit): els instructors i administradors poden accedir als comentaris del contingut creat a l'editor WYSIWYG del vostre LMS. Activeu la casella de selecció "Activa també el comprovador integrat del sistema de gestió de l'aprenentatge" per habilitar els dos comprovadors d'accessibilitat. 

    • Més informació sobre l'accessibilitat WYSIWYG per a instructors

      Aquest marcador de característiques desactiva els comentaris de l'instructor o les correccions ràpides en fitxers HTML carregats o creats a D2L Brightspace.

    • Integració de dades d'Ally amb Impact by Instructure (abans EesySoft): les institucions amb llicència d’Impact by Instructure poden permetre una supervisió més detallada de les interaccions en el mode de formats alternatius, els comentaris de l’instructor i l’informe d'accessibilitat del curs. Les institucions poden utilitzar aquestes dades per a les campanyes i informes d’adopció a Impact by Instructure. La integració d'Impact by Instructure està desactivada per defecte.

      Aquesta integració requereix una llicència d'Impact by Instructure.

  3. Seleccioneu Habilita o Inhabilita per activar o desactivar la característica.