Skip to main content

Ally no Moodle

Instalar plug-ins de ferramentas, filtros e relatórios do Ally

O Ally é compatível com várias opções e temas de hospedagem do Moodle. As versões e temas compatíveis no Ally são:

. 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

. Moodle 4.4.x
  • Snap

  • Boost

. Moodle 4.5.x
  • Snap

  • Boost

. Moodle 5.0.x
  • Boost

    Nota

    Note que, ao contrário das versões anteriores, o tema Snap não é compatível para o Moodle 5.

plug-in do Ally para ambientes OpenLMS 4.1

A OpenLMS atualizará seus ambientes para a versão 4.1 nos Próximos eventos de manutenção. Veja o cronograma de lançamentos do OpenLMS EDU. O plug-in do Ally para a versão 4.1 estará disponível após a execução das janelas de manutenção e deve estar disponível na matriz de plug-ins do OpenLMS.

O Ally funciona com versões do Moodle anteriores à 3.10.x, mas não são compatíveis para correções. Sugerimos que você atualize sua versão do Moodle. Há orientações disponíveis no suporte à versão do Moodle.

Observação: Outras versões ou temas não mencionados não são compatíveis com o Ally.

Para configurar o Ally com o Moodle em ambientes auto-hospedados, configure estes plug-ins:

  • Ferramentas do administrador do Ally

  • Filtro do Ally

  • LTI de relatório do Ally

Os ambientes implementados pelo OpenLMS já estão integrados ao Ally.

Etapas de configuração

    1. Baixar como um arquivo ZIP

      1. Se necessário, altere a versão da ramificação.

      2. Analise o arquivo version.php para ver se o número de versão e atualização necessário ("requer") do Moodle corresponde a sua versão do Moodle. Por exemplo, para Moodle 4.5

        $plug-in->lançamento = '4.5.6';

        $plugin->requires = 2021051700;

        A versão "4.5.6" deve funcionar com as instalações do Moodle 4.5. Se estes parâmetros não corresponderem à sua instalação do Moodle, talvez você precise mudar a ramificação novamente.

      3. Baixe a pasta utilizando o “Clonar ou baixar > Baixar ZIP”

    2. Como clonar a pasta git

      1. Acessar a pasta de ferramentas.

        cd [Localização do Moodle]/admin/ferramenta

      2. Clonar a pasta

        • Como utilizar o SSH

          git clone git@github.com: Anthology-Ally/Moodle-tool_ally Ally

        • Como utilizar o HTTP

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

      3. Confira a ramificação correspondente, ou seja, para o Moodle 4.5 é MOODLE_450_STABLE

        git checkout MOODLE_450_STABLE

        A verificação da ramificação também pode ser utilizada para obter atualizações, portanto, se você atualizou sua instalação do Moodle, pode apenas verificar a ramificação correspondente. Se a ramificação não for localizada, sua pasta pode estar desatualizada, o que pode ser corrigido fazendo a busca:

        git fetch

    1. Baixar como um arquivo ZIP

      1. Se necessário, altere a versão da ramificação

      2. Analise o arquivo version.php para ver se o número de versão e atualização necessário ("requer") do Moodle corresponde a sua versão do Moodle. Por exemplo, para Moodle 4.5

        $plug-in->lançamento = '4.5.6';

        $plugin->requires = 2021051700;

        A versão "4.5.6" deve funcionar com as instalações do Moodle 4.5. Se estes parâmetros não corresponderem à sua instalação do Moodle, talvez você precise mudar a ramificação novamente.

      3. Baixe a pasta utilizando o “Clonar ou baixar > Baixar ZIP”

    2. Como clonar a pasta git

      1. Acessar a pasta de filtros.

        cd [moodle location]/filter

      2. Clonar a pasta

        • Como utilizar o SSH

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

        • Como utilizar o http

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

      3. Confira a ramificação correspondente, ou seja, para o Moodle 4.5 é MOODLE_450_STABLE

        git checkout MOODLE_450_STABLE

        A verificação da ramificação também pode ser utilizada para obter atualizações, portanto, se você atualizou sua instalação do Moodle, pode apenas verificar a ramificação correspondente. Se a ramificação não for localizada, sua pasta pode estar desatualizada, o que pode ser corrigido fazendo a busca:

        git fetch

    1. Baixar como um arquivo ZIP

      1. Se necessário, altere a versão da ramificação

      2. Analise o arquivo version.php para ver se o número de versão e atualização necessário ("requer") do Moodle corresponde a sua versão do Moodle. Por exemplo, para Moodle 4.5

        $plug-in->lançamento = '4.5.6';

        $plugin->requires = 2021051700;

        A versão "4.5.6" deve funcionar com as instalações do Moodle 4.5. Se estes parâmetros não corresponderem à sua instalação do Moodle, talvez você precise mudar a ramificação novamente.

      3. Baixe a pasta utilizando o “Clonar ou baixar > Baixar ZIP”

    2. Como clonar a pasta git

      1. Acessar a pasta de relatórios

        cd [moodle location]/report

      2. Clonar a pasta

        • Como utilizar o SSH

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

        • Como utilizar o HTTP

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

      3. Confira a ramificação correspondente, ou seja, para o Moodle 4.5 é MOODLE_450_STABLE

        git checkout MOODLE_450_STABLE

        A verificação da ramificação também pode ser utilizada para obter atualizações, portanto, se você atualizou sua instalação do Moodle, pode apenas verificar a ramificação correspondente. Se a ramificação não for localizada, sua pasta pode estar desatualizada, o que pode ser corrigido fazendo a busca:

        git fetch

  1. Verificar a estrutura da pasta.

    O diretório de ferramentas administrativas deveria se chamar ally. Deve haver um caminho conforme abaixo:

    [yourmoodledir]/admin/tool/ally

    O diretório de filtros deve se chamar ally. Deve haver um caminho conforme abaixo:

    [yourmoodledir]/filter/ally

    O diretório de relatórios deve se chamar allylti. Deve haver um caminho conforme abaixo:

    [yourmoodledir]/relatório/allylti

  2. Certifique-se de que cada pasta e seus conteúdos possam ser lidos pelo seu servidor da web.

  3. Faça logon no seu site do Moodle como usuário administrador e abra a página do administrador. Isso deve verificar se há novos plug-ins e apresentar a você uma opção para Atualizar o banco de dados do Moodle agora. Clique neste botão para instalar os plug-ins.

  4. Após instalar os plug-ins, navegue até Administração do sistema > Plug-ins > Ferramentas do administrador > Ally.

  5. Clique em Autoconfigurar o serviço da web do Ally.

    Na próxima tela haverá um código do serviço da web e uma URL para testar o serviço da web do Ally.

    Este URL precisa ser acessível diretamente pela internet para que o Ally possa usá-lo.

    Se for bem-sucedido, você precisará copiar o código do serviço web do Ally e o link do serviço web e fornecê-los ao seu consultor técnico do Ally ou ao engenheiro de suporte. Ele entrará em contato quando tiver terminado as configurações relevantes e fornecerá “chave”, “segredo”, “URL inicial”, “URL de atualizações de arquivo” e “código do cliente”.

    Se sua instância do Moodle usa campos obrigatórios personalizados para contas de usuários, “Fazer logon como” o usuário do serviço da web do Ally criado pelo plug-in de autoconfiguração garante que esses campos personalizados sejam preenchidos e gravados.

Configurar o plug-in do Moodle

A consultoria técnica do Ally criará um cliente do Ally utilizando o código de serviço da web do Moodle gerado na seção anterior e lhe fornecerá detalhes para configurar o plug-in do Ally.

  1. Faça logon como administrador do Moodle.

  2. Em Administração do site selecione Plug-ins e Ferramentas do administrador. Clique em Configuração do Ally.

  3. digite os seguintes detalhes

    • Autores de Conteúdo: as funções de usuários autores de conteúdo. Deve ser: Gerente, Criador de curso, Professor (os padrão).

      Importante

      Normalmente, isto não deve ser alterado; não faça alterações sem perguntar ao consultor técnico do Ally.

    • Chave: A chave LTI fornecida pelo consultor técnico do Ally

    • Segredo: O código LTI fornecido pelo consultor técnico do Ally

    • URL de lançamento: A URL de lançamento LTI fornecida pelo consultor técnico do Ally

    • URL de Atualização de Arquivo: A URL de Atualização/Evento de Arquivo fornecida pelo consultor técnico do Ally. https://[AllyEnvironment].ally.ac/api/v1/events

    • Código do Cliente: O Código do Cliente fornecido pelo consultor técnico do Ally

    • Alcance logarítmico: Luz

  4. Salvar alterações.

Relatório Institucional do Ally

Assim que o plug-in do Ally for configurado, você terá acesso ao Relatório Institucional do Ally.

Nota

Nenhum dado será apresentado no relatório até que ocorra a sincronização do curso do Ally e o relatório inicial seja gerado.

Para acessar o Relatório Institucional do Ally, vá para Administração do site e selecione Relatórios. Clique em Acessibilidade.

Filtro do Ally

Quando estiver pronto para ver os indicadores de pontuação de acessibilidade do Ally e a opção para baixar a versão de acessibilidade alternativa ficar disponível no Moodle, você precisará habilitar o filtro.

Habilitar o filtro do Ally

  1. Em Administração do site, selecione Plug-ins e Visão geral dos plug-ins.

  2. Desça até seção dos Filtros de texto e habilite o filtro do Ally.

  3. Mova o filtro do Ally para o topo da lista Filtro.

Acessar a interface de usuário da configuração do Ally

Fornecemos as instruções sobre como acessar a Configuração do Ally durante a configuração. Se você não tiver acesso, abra um chamado de suporte no Anthology Global Support Center.

Configurar os percursos

Acesse a página Configuração do Ally e ative o Ally para todos os cursos ou decida curso por curso. Você decide.

  1. Veja quantos dos seus cursos utilizam o Ally.

  2. Ative ou desative o Ally em todos os cursos existentes. Decida com antecedência se você o prefere habilitado em todos os seus cursos futuros.

  3. Procure por cursos individuais ou filtre todos os cursos por status (habilitado/deshabilitado) e por período.

  4. Ative ou desative o Ally em cada curso, individualmente.

alt

Ative ou desative o Ally em um único percurso

Quando o Ally está ativo, instrutores e alunos se beneficiam das pontuações de acessibilidade, comentários do instrutor e formatos alternativos gerados por ele.

Nota

O Relatório Institucional está disponível para todos os cursos. Não importa se o Ally está ativado ou desativado em um curso. O curso é exibido no Relatório Institucional.

Na Configuração do Ally, localize o curso que você quer atualizar. Use o campo dde Pesquisa e os filtros para pesquisar por título e código do curso.

Clique em Habilitar ou Desabilitar na coluna Habilitado para habilitar ou desabilitar o Ally.

  • O Ally está inativo: Clique em Habilitar a integração da interface do curso para ativar

    alt
  • O Ally está ativo: Clique em Desabilitar a integração da interface do curso para desabilitar

    alt

Ativar ou desativar o Ally em todos os cursos

Dica

Não sabe se todos os cursos estão utilizando o Ally ou não? No topo da página de Configuração do Ally, veja quantos dos seus cursos estão utilizando-o atualmente.

Quando o Ally está ativo, instrutores e alunos se beneficiam das pontuações de acessibilidade, comentários do instrutor e formatos alternativos gerados por ele.

Nota

O Relatório Institucional está disponível para todos os cursos. Não importa se o Ally está ativado ou desativado em um curso. O curso é exibido no Relatório Institucional.

É possível ativar ou desativar o Ally em todos os cursos existentes na página de Configuração do Ally. Clique em Habilitar/desabilitar todos os cursos e em seguida Desabilitar ou Habilitar.

alt

Clique em Habilitar nos próximos cursos se quiser o Ally automaticamente ativo em todos os seus novos cursos.

Dica

Se não selecionar essa opção, os novos cursos não terão o Ally habilitado. Se você quiser o Ally posteriormente, ative o Ally em cursos individuais.

Depois de escolher habilitar ou desabilitar em todos os cursos, é preciso confirmar a ação. Clique em Habilitar ou Desabilitar, conforme a sua escolha. Clique em Cancelar se mudar de ideia e não quiser alterar nada.

alt

Ative o Ally apenas em todos os cursos novos

Quando o Ally está ativo, instrutores e alunos se beneficiam das pontuações de acessibilidade, comentários do instrutor e formatos alternativos gerados por ele.

Nota

O Relatório Institucional está disponível para todos os cursos. Não importa se o Ally está ativado ou desativado em um curso. O curso é exibido no Relatório Institucional.

Clique em Habilitar nos próximos cursos se quiser o Ally automaticamente ativo em todos os seus novos cursos.

Dica

Se não selecionar essa opção, os novos cursos não terão o Ally habilitado. Se você quiser o Ally posteriormente, ative o Ally em cursos individuais.

Configurar os ajustes da ajuda do usuário do Ally

Configure mensagens padronizadas exibidas nos modais, Formatos alternativos e Comentários do instrutor. As mensagens de ajuda personalizadas podem ser utilizadas para indicar documentação institucional aos alunos e instrutores, compartilhar informações de contato e assim por diante. Quando nenhuma mensagem personalizada for configurada, os links da Ajuda direcionam para estas páginas na ajuda da Blackboard:

  • Formatos alternativos: Esta página explica como e quando os diferentes formatos alternativos podem ser utilizados

  • Ajuda com instrutores: Tudo o que os instrutores precisam saber sobre o Ally nos seus cursosAlly for LMS Help for Instructors

O conteúdo de ajuda personalizado pode ser configurado na interface Configuração do Ally e utiliza o formato Markdown para ajudar a fornecer uma mensagem estruturada e acessível.

  1. Acesse Configuração de Ally e clique em Configurações de ajuda.

  2. Escolha a opção de ajuda padrão ou personalizada, tanto para a Ajuda dos comentários do instrutor quanto para a Ajuda dos formatos alternativos.

  3. Caso escolha a opção personalizada, edite a Mensagem personalizada.

    Dica

    Use o formato Markdown para ajudar a fornecer uma mensagem estruturada e acessível.

  4. Clique em Salvar alterações.

alt

Configure a ajuda especializada

alt

Ofereça a seus instrutores e alunos fácil acesso a sua equipe de especialistas em acessibilidade. Habilite a ajuda especializada para que seus usuários possam solicitar auxílio diretamente dos formatos alternativos e painéis de comentários do instrutor.

Quando uma solicitação é feita, um e-mail contendo o pedido de ajuda, os detalhes do curso em andamento, o item de conteúdo e usuário é enviado ao endereço de e-mail que você configurou.

  1. Acesse Configuração de Ally e clique em Configurações de ajuda.

  2. Escolha Oferecer ajuda personalizada tanto para a ajuda dos comentários do instrutor quanto para a ajuda dos formatos alternativos.

  3. Clique em Habilitar ajuda especializada.

  4. Digite o endereço de e-mail para sua equipe de especialistas em acessibilidade.

  5. Clique em Salvar alterações.

Importante

O usuário API do Ally para a integração do Blackboard Learn precisa receber a permissão “Painel do administrador (Usuários) e Usuários” ou “exibição.do.sistema.do.usuário” para permitir que o Ally inclua o nome do aluno e o endereço de e-mail no e-mail de solicitação de ajuda. O usuário API do Ally para a integração do Moodle deve receber a permissão “moodle/user:viewalldetails” para permitir que o Ally inclua o nome do aluno e o endereço de e-mail no e-mail de solicitação de ajuda.

alt

Solicite ajuda com formatos alternativos

alt

Solicite ajuda com comentários do instrutor

Personalizar recursos de referência do Ally

Você pode ativar ou desativar alguns recursos para personalizar o Ally às suas preferências institucionais.

Em Configuração do Ally, escolha que recursos pretende habilitar.

  1. Acesse a Configuração de Ally e clique em Recursos.

  2. Encontre o recurso que pretende ativar ou desativar e selecione-o.

    • Geração por IA de Descrições Alternativas para Imagens: Quando as imagens não têm texto alternativo, os instrutores podem utilizar o Assistente de Texto Alternativo de IA para gerar sugestões sem transtornos. Ao ativar este recurso, você concorda com nossos Termos de Uso. Para obter informações detalhadas sobre os riscos e limitações desse recurso, consulte nosso Comunicado de transparência.AI Alt Text Assistant Terms of Use

    • Formato alternativo do Leitor Imersivo: Os alunos podem aprimorar a experiência de leitura com este recurso on-line.

    • Versão traduzida em formato alternativo: alunos podem baixar um formato alternativo traduzido de um arquivo original.

    • Formato alternativo do BeeLine Reader: alunos podem baixar um formato alternativo do BeeLine Reader.

    • Indicadores de pontuação em todos os cursos para administradores: Os administradores podem ver os indicadores de pontuação de acessibilidade do Ally em todos os cursos, incluindo aqueles onde o Ally não estiver habilitado na interface de configuração. Isso permite que eles corrijam problemas sem ter de habilitar o Ally no curso.

    • Importante

      Este sinalizador de recurso está disponível para o D2L Brightspace, o Instructure Canvas, o Moodle e o Schoology.

    • Acesse os Comentários do Instrutor do Relatório Institucional: Conceda acesso aos Comentários do Instrutor aos administradores, serviços para pessoas com deficiência e desenvolvedores instrucionais.

    • Comentários dos instrutores para conteúdo WYSIWYG (conteúdo do Editor de Rich Text): Instrutores e administradores podem acessar comentários para conteúdos criados no seu editor WYSIWYG do LMS. Marque a caixa "Habilitar também o verificador integrado do LMS" para habilitar ambos os verificadores de acessibilidade.

    • Nota

      Esse flag de recurso desabilita os Comentários do Instrutor ou correções rápidas em arquivos HTML enviados ou criados no D2L Brightspace.

    • Integração de dados do Ally ao Impact by Instructure (antigo EesySoft): as instituições uma licença do Impact by Instructure podem permitir um monitoramento mais detalhado das interações no modal de formatos alternativos, nos comentários do instrutor e no Relatório de Acessibilidade aos Cursos. As instituições podem utilizar esses dados para relatórios de adoção e campanhas no Impact by Instructure. A integração do Impact by Instructure fica desabilitada por padrão.

      Nota

      Essa integração requer uma licença Impact by Instructure.

  3. Clique em Habilitar ou Desabilitar para habilitar ou desabilitar o recurso.

alt