Instalar los complementos de informes, filtros y herramientas de Ally

Ally es compatible con varias opciones de alojamiento y temas de Moodle. Las versiones y temas compatibles con Ally son los siguientes:

Moodle 3.11.x

  • Snap
  • Boost
  • Limpio (Clean)
  • Más

Moodle 4.0.x

  • Snap
  • Boost

Moodle 4.1.x

  • Snap
  • Boost

Moodle 4.2.x

  • Snap
  • Boost

Moodle 4.3.x

  • Snap
  • Boost


Complemento de Ally para entornos 4.1 de OpenLMS
OpenLMS actualizará sus entornos a la versión 4.1 en los próximos períodos de mantenimiento. Ver el Calendario de lanzamientos de OpenLMS EDU. El complemento de Ally para la versión 4.1 estará disponible después de que se lleven a cabo los períodos de mantenimiento y estará disponible en la Matriz de complementos de OpenLMS.


Ally funciona con versiones de Moodle anteriores a la versión 3.10.x, pero las correcciones no son compatibles. Recomendamos actualizar la versión de Moodle. Encontrará orientación al respecto en el soporte de versiones de Moodle.

Nota: Las demás versiones o temas que no se mencionan no son compatibles con Ally.

Para configurar Ally con Moodle en entornos alojados en el servidor del usuario, configure los siguientes complementos:

  • Herramientas de Ally para el administrador
  • Filtro de Ally
  • LTI del Informe de Ally

Los entornos implementados por OpenLMS ya están integrados con Ally.

Pasos de configuración

  1. Descargue o clone la versión necesaria de la herramienta de Ally para el administrador desde GitHub.

    1. Descarga como un archivo ZIP
      1. Cambie la versión de la rama, si es necesario.
      2. Revise el archivo version.php para saber si la versión (release) y el número de versión de Moodle ("requiere" [requires]) necesarios coinciden con su versión de Moodle. Es decir, para Moodle 3.11

        $plugin->release = '3.11.6';

        $plugin->requires = 2021051700;

        La versión 3.11.6 debería funcionar con las instalaciones de Moodle 3.11. Si estos parámetros no coinciden con su instalación de Moodle, es posible que tenga que cambiar la rama otra vez.

        Más información sobre los números de versión y los lanzamientos de Moodle correspondientes

      3. Descargue el repositorio con las opciones "Clonar o descargar > Descargar ZIP"
    2. Clonación del repositorio git
      1. Acceda a la carpeta de herramientas

        cd [moodle location]/admin/tool

      2. Clone el repositorio
        • Con SSH

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

        • Con HTTP

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

      3. Active la rama correspondiente. En el caso de Moodle 3.11, es MOODLE_311_STABLE.

        git checkout MOODLE_311_STABLE

        La activación de la rama se puede utilizar también para obtener actualizaciones. Por lo tanto, si actualizó su instalación de Moodle, puede solo activar la rama correspondiente. Si no se encuentra la rama, es posible que su repositorio esté desactualizado. Esto se pude solucionar con una búsqueda:

        git fetch

  2. Descargue o clone la versión necesaria del filtro de Ally desde github.

    1. Descarga como un archivo ZIP
      1. Cambie la versión de la rama, si es necesario.
      2. Revise el archivo version.php para saber si la versión (release) y el número de versión de Moodle ("requiere" [requires]) necesarios coinciden con su versión de Moodle. Es decir, para Moodle 3.11

        $plugin->release = '3.11.6';

        $plugin->requires = 2021051700;

        La versión 3.11.6 debería funcionar con las instalaciones de Moodle 3.11. Si estos parámetros no coinciden con su instalación de Moodle, es posible que tenga que cambiar la rama otra vez.

        Más información sobre los números de versión y las versiones de Moodle correspondientes.

      3. Descargue el repositorio con las opciones "Clonar o descargar > Descargar ZIP"
    2. Clonación del repositorio git
      1. Acceda a la carpeta de filtros

        cd [moodle location]/filter

      2. Clone el repositorio
        • Con SSH

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

        • Con HTTP

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

      3. Active la rama correspondiente. En el caso de Moodle 3.11, es MOODLE_311_STABLE.

        git checkout MOODLE_311_STABLE

        La activación de la rama se puede utilizar también para obtener actualizaciones. Por lo tanto, si actualizó su instalación de Moodle, puede solo activar la rama correspondiente. Si no se encuentra la rama, es posible que su repositorio esté desactualizado. Esto se pude solucionar con una búsqueda:

        git fetch

  3. Descargue la versión necesaria de la herramienta de LTI de informes de Ally desde github.

    1. Descarga como un archivo ZIP
      1. Cambie la versión de la rama, si es necesario.
      2. Revise el archivo version.php para saber si la versión (release) y el número de versión de Moodle ("requiere" [requires]) necesarios coinciden con su versión de Moodle. Es decir, para Moodle 3.11

        $plugin->release = '3.11.6';

        $plugin->requires = 2021051700;

        La versión 3.11.6 debería funcionar con las instalaciones de Moodle 3.11. Si estos parámetros no coinciden con su instalación de Moodle, es posible que tenga que cambiar la rama otra vez.

        Más información sobre los números de versión y las versiones de Moodle correspondientes.

      3. Descargue el repositorio con las opciones "Clonar o descargar > Descargar ZIP"
    2. Clonación del repositorio git
      1. Acceda a la carpeta de informes

        cd [moodle location]/report

      2. Clone el repositorio
        • Con SSH

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

        • Con HTTP

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

      3. Active la rama correspondiente. En el caso de Moodle 3.11, es MOODLE_311_STABLE.

        git checkout MOODLE_311_STABLE

        La activación de la rama se puede utilizar también para obtener actualizaciones. Por lo tanto, si actualizó su instalación de Moodle, puede solo activar la rama correspondiente. Si no se encuentra la rama, es posible que su repositorio esté desactualizado. Esto se pude solucionar con una búsqueda:

        git fetch

  4. Verifique la estructura de la carpeta.

    El directorio de herramientas del administrador debe tener el nombre ally. Su ruta debe ser la siguiente:

    [yourmoodledir]/admin/tool/ally

    El directorio de filtros debe tener el nombre ally. Su ruta debe ser la siguiente:

    [yourmoodledir]/filter/ally

    El directorio de informes debe tener el nombre allylti. Su ruta debe ser la siguiente:

    [yourmoodledir]/report/allylti

  5. Asegúrese de que su servidor web puede leer cada carpeta junto con su contenido.
  6. Inicie sesión como usuario administrador en su sitio de Moodle y abra la página del administrador. Esto debería verificar si existen complementos nuevos y presentarle una opción para Actualizar la base de datos de Moodle ahora. Seleccione este botón para instalar los complementos.
  7. Después de instalar los complementos, diríjase a Administración del sistema > Complementos > Herramientas del administrador > Ally.
  8. Seleccione Configuración automática del servicio web de Ally.

    En la siguiente pantalla, encontrará un token de servicio web y una URL para probar el servicio web de Ally.

    Es necesario poder acceder a esta URL directamente desde Internet para que Ally pueda usarla.

    Si tiene éxito, tendrá que copiar el token de servicio web de Ally y el enlace del servicio web para proporcionárselos a su asesor técnico de Ally o al ingeniero de soporte. Se comunicarán con usted una vez realizada su parte de la configuración y le darán la "clave", el "secreto", la "URL de inicio", la "URL de actualizaciones de archivos" y el "ID de cliente".

    Si su instancia de Moodle utiliza campos obligatorios personalizados para las cuentas de los usuarios, "inicie sesión como" el usuario del servicio web de Ally creado por el complemento de configuración automática, para asegurarse de que dichos campos personalizados se completen y se guarden.


Configuración del complemento de Moodle

El asesor técnico de Ally creará el cliente de Ally utilizando el token de servicio web de Moodle que se generó en la sección anterior y le brindará los detalles para la configuración del complemento de Ally.

  1. Inicie sesión como administrador de Moodle.
  2. En Administración del sitio, seleccione Complementos y Herramientas del administrador. Haga clic en Configuración de Ally.
  3. Escriba los siguientes detalles
    • Autores del contenido: los roles de usuario que son autores del contenido. Debe ser alguno de los siguientes: Gerente, Creador del curso, Profesor (los predeterminados).

      Normalmente, esto no debería tener que cambiarse. No lo haga sin consultar antes con el asesor técnico de Ally.

    • Clave: la clave de LTI que proporcionó el asesor técnico de Ally.
    • Secreto: el secreto de LTI que proporcionó el asesor técnico de Ally.
    • URL de inicio: la URL de inicio de LTI que proporcionó el asesor técnico de Ally.
    • URL de actualización de archivos: la URL de actualización de archivos que proporcionó el asesor técnico de Ally. https://[AllyEnvironment].ally.ac/api/v1/events
    • ID de cliente: el ID de cliente que proporcionó el asesor técnico de Ally.
    • Intervalo de registros: leve
  4. Guarde los cambios.

Informe institucional de Ally

Una vez configurado el complemento de Ally, podrá acceder al Informe de la institución de Ally.

No se presentarán datos en el informe hasta que se haya producido la sincronización del curso de Ally y se haya generado el informe inicial.

Para acceder al Informe de la institución de Ally, vaya a Administración del sitio y seleccione Informes. Seleccione Accesibilidad.

Más información sobre el Informe institucional de Ally


Filtro de Ally

Cuando esté listo para que se active la disponibilidad de la opción de descarga de la versión alternativa accesible y los indicadores de calificación de accesibilidad de Ally dentro de Moodle, tendrá que activar el filtro de Ally.

Habilitar el filtro de Ally

  1. En Administración del sitio, seleccione Complementos y Descripción general de los complementos.
  2. Baje hasta la sección Filtros de texto y habilite el filtro de Ally.
  3. Traslade el filtro de Ally a la parte superior de la lista Filtros.

Acceder a la UI de la Configuración de Ally

Durante la configuración, le proporcionamos instrucciones sobre cómo acceder a la Configuración de Ally. Si no tiene acceso, envíe una solicitud en Behind the Blackboard.

Ally: Configurar cursos


Configurar cursos

Diríjase a la página Configuración de Ally y active Ally para todos los cursos o elija uno por uno. Depende de usted.

  1. Vea cuántos de sus cursos usan Ally.
  2. Active o desactive Ally en todos los cursos actuales. Decida con anticipación si desea tenerlo habilitado para todos los cursos futuros.
  3. Busque cursos individuales o filtre todos los cursos por habilitado, deshabilitado y período.
  4. Active o desactive Ally en cursos individuales.

Active o desactive Ally en un único curso

Cuando Ally está activado, los profesores y estudiantes se benefician con las calificaciones de accesibilidad, los comentarios para el profesor y los formatos alternativos que ofrece.

El informe institucional está disponible para todos los cursos. No importa si Ally está activado en un curso o no. El curso aparece en el informe institucional.

En Configuración de Ally, busque el curso que desea actualizar. Use el campo Buscar y los filtros para buscar por título, identificador o código del curso.

Seleccione Habilitar o Deshabilitar en la columna Habilitado para activar o desactivar Ally.

  • Ally está desactivado: seleccione Habilitar la integración de la UI del curso para activar la herramienta.
  • Ally está activado: seleccione Deshabilitar la integración de la UI del curso para desactivarla.

Active o desactive Ally en todos los cursos

¿No sabe con certeza si todos los cursos usan Ally o no? Al principio de la página de configuración de Ally, puede ver cuántos cursos usan Ally en ese momento.

Cuando Ally está activado, los profesores y estudiantes se benefician con las calificaciones de accesibilidad, los comentarios para el profesor y los formatos alternativos que ofrece.

El informe institucional está disponible para todos los cursos. No importa si Ally está activado en un curso o no. El curso aparece en el informe institucional.

Puede activar o desactivar Ally en cada uno de los cursos actuales desde la página de configuración de Ally. Seleccione Deshabilitar/habilitar todos los cursos y seleccione Deshabilitar o Habilitar.

Seleccione Habilitar en cursos futuros si desea que Ally se active automáticamente en todos los cursos nuevos.

Si no selecciona esta opción, no se habilitará Ally en los cursos nuevos. Si desea que Ally se active más adelante, active Ally en cursos individuales.

Después de elegir deshabilitar o habilitar Ally en todos los cursos, debe confirmar la acción. Seleccione Habilitar o Deshabilitar, según lo que desee. Seleccione Cancelar si cambió de idea y no quiere modificar nada.


Active Ally únicamente en todos los cursos nuevos

Cuando Ally está activado, los profesores y estudiantes se benefician con las calificaciones de accesibilidad, los comentarios para el profesor y los formatos alternativos que ofrece.

El informe institucional está disponible para todos los cursos. No importa si Ally está activado en un curso o no. El curso aparece en el informe institucional.

Seleccione Habilitar en cursos futuros si desea que Ally se active automáticamente en todos los cursos nuevos.

Si no selecciona esta opción, no se habilitará Ally en los cursos nuevos. Si desea que Ally se active más adelante, active Ally en cursos individuales.

Configuración de Ally: ajustes de la ayuda


Establezca los ajustes de la ayuda para los usuarios de Ally

Configure los mensajes de ayuda personalizados que se muestran en las modalidades Formatos alternativos y Comentarios para el profesor. Los mensajes de ayuda personalizados se pueden usar para dirigir a los estudiantes y los profesores a la documentación institucional existente, compartir información de contacto, entre otras cosas. En los casos en los que no se ha configurado un mensaje personalizado, los enlaces de Ayuda dirigen a estas páginas en la ayuda de Blackboard:

Se puede configurar el contenido de ayuda personalizado en la interfaz de usuario Configuración de Ally y utilizar el formato Markdown para transmitir un mensaje estructurado y accesible.

  1. Diríjase a Configuración de Ally y seleccione Ajustes de ayuda.
  2. Elija la opción de ayuda personalizada o predeterminada tanto para la ayuda sobre Formatos alternativos como para la ayuda sobre Comentarios para el profesor.
  3. Si selecciona la opción personalizada, edite el Mensaje personalizado.

    Use el formato Markdown para ayudar a transmitir un mensaje estructurado (y accesible).

  4. Seleccione Guardar cambios.

Realice una configuración para obtener ayuda de expertos

Ofrezca a sus profesores y estudiantes acceso fácil a su equipo de expertos en accesibilidad. Habilite la ayuda de expertos para que los usuarios soliciten más ayuda directamente desde los paneles de formatos alternativos y comentarios para el profesor.

Cuando se realiza una solicitud, se envía un correo electrónico con la solicitud de ayuda, información sobre el curso actual, el elemento de contenido y el usuario a la dirección de correo electrónico que estableció.

  1. Diríjase a Configuración de Ally y seleccione Ajustes de ayuda.
  2. Elija la opción Proporcionar ayuda personalizada tanto para la ayuda sobre formatos alternativos como para la ayuda sobre comentarios para el profesor.
  3. Seleccione Habilitar la ayuda de expertos.
  4. Escriba la dirección de correo electrónico de su equipo de expertos en accesibilidad.
  5. Seleccione Guardar cambios.

El usuario de la API de Ally para la integración con Blackboard Learn debe obtener el permiso de "Panel del administrador (Usuarios) > Usuarios" o "system.user.view", para que Ally incluya el nombre y la dirección de correo electrónico del estudiante en el correo electrónico de solicitud de ayuda. El usuario de la API de Ally para la integración con Moodle debe obtener el permiso "moodle/user:viewalldetails", para que Ally incluya el nombre y la dirección de correo electrónico del estudiante en el correo electrónico de solicitud de ayuda.

Personalizar las funciones de Ally


Personalice la activación y desactivación de las funciones de Ally

Puede activar o desactivar algunas funciones y, de este modo, personalizar Ally para que se adecue a sus preferencias institucionales.

En Configuración de Ally, elija qué funciones desea habilitar.

  1. Diríjase a Configuración de Ally y seleccione Funciones.
  2. Busque la función que desee activar o desactivar y selecciónela.
    • Generación de descripciones alternativas para imágenes de IA: cuando las imágenes carecen de texto alternativo, los profesores pueden aprovechar el Asistente de texto alternativo de IA para generar sugerencias sin esfuerzo. Al habilitar esta función, acepta nuestros Términos de uso. Para obtener información detallada sobre los riesgos y limitaciones de esta función, consulte nuestra Nota de transparencia.
    • Selección del formato alternativo de lector inmersivo: los estudiantes pueden mejorar la experiencia de lectura con esta función en línea.
    • Formato alternativo de versión traducida: los estudiantes pueden descargar un formato alternativo traducido de un archivo original.
    • Formato alternativo de BeeLine Reader: los estudiantes pueden descargar un formato alternativo de BeeLine Reader.
    • Indicadores de puntuación en todos los cursos para los administradores: los administradores pueden ver los indicadores de la puntuación de accesibilidad de Ally en todos los cursos, incluidos aquellos en los que Ally no está habilitado en la interfaz de usuario de configuración. Esto les permite solucionar problemas sin tener que habilitar Ally en el curso.
    • Este indicador de funciones está disponible para Brightspace, Instructure Canvas, Moodle y Schoology de D2L.

    • Acceso a los comentarios para el profesor desde el informe institucional: permita que los administradores, los encargados de servicios para personas con discapacidad y los diseñadores de material didáctico accedan a los comentarios para el profesor.
    • Comentarios del profesor sobre el contenido WYSIWYG (contenido del editor de texto enriquecido): los profesores y administradores pueden acceder a los comentarios del contenido creado en su editor WYSIWYG de LMS. Marque la casilla de verificación "Habilitar también el verificador integrado en el LMS" para habilitar ambos verificadores de accesibilidad.
    • Más información sobre la accesibilidad al contenido WYSIWYG para los profesores

      Este indicador de funciones desactiva los comentarios del profesor o las correcciones rápidas en los archivos HTML cargados o creados en Brightspace de D2L.

    • Integración de datos de Ally en Impact de Instructure (anteriormente, EesySoft): las instituciones con una licencia de Impact de Instructure pueden permitir que se supervisen con más detalle las interacciones en la modalidad de formatos alternativos, los comentarios para el profesor y el informe de accesibilidad del curso. Las instituciones pueden utilizar esos datos para los informes y las campañas de adopción en Impact de Instructure. La integración de Impact de Instructure está deshabilitada de manera predeterminada.

      La integración requiere una licencia de Impact de Instructure.

  3. Seleccione Habilitar o Deshabilitar para activarla o desactivarla.