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 suportados 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

Plug-in do Ally para ambientes OpenLMS 4.1
O OpenLMS atualizará seus ambientes para a versão 4.1 nas próximas janelas de manutenção. Consulte a Programação da versão do OpenLMS EDU. O plug-in do Ally da versão 4.1 estará disponível depois que as janelas de manutenção forem executadas e deverá estar disponível na  Matriz de plug-in 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 implantados pelo OpenLMS já estão integrados ao Ally. 

Etapas de configuração

1. Baixe ou clone pelo github a versão necessária da ferramenta do administrador do Ally.

   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 à sua versão do Moodle. Por exemplo, para Moodle 3.11

         $plugin->release = '3.11.6';

         $plugin->requires = 2021051700;

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

         Mais sobre os números de versão e atualizações do Moodle correspondentes

      3. Baixe a pasta usando o “Clonar ou baixar > Baixar ZIP”
   2. Como clonar a pasta git

      1. Acessar a pasta de ferramentas.

         cd [moodle location]/admin/tool

      2. Clonar a pasta

         • Como usar o SSH

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

         • Como usar o HTTP

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

      3. Confira a ramificação correspondente, ou seja, para Moodle 3.11, é MOODLE_311_STABLE

         git checkout MOODLE_311_STABLE

         A verificação da ramificação também pode ser usada 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

2. Baixe ou clone a versão necessária do filtro do Ally do github.

   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 3.11

         $plugin->release = '3.11.6';

         $plugin->requires = 2021051700;

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

         Mais sobre os números de versão e atualizações do Moodle correspondentes.

      3. Baixe a pasta usando 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 usar o SSH

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

         • Como usar o HTTP

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

      3. Confira a ramificação correspondente, ou seja, para Moodle 3.11, é MOODLE_311_STABLE

         git checkout MOODLE_311_STABLE

         A verificação da ramificação também pode ser usada 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

3. Baixe ou clone a versão necessária da ferramenta de LTI do relatório do Ally pelo github.

   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 3.11

         $plugin->release = '3.11.6';

         $plugin->requires = 2021051700;

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

         Mais sobre os números de versão e atualizações do Moodle correspondentes.

      3. Baixe a pasta usando 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 usar o SSH

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

         • Como usar o HTTP

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

      3. Confira a ramificação correspondente, ou seja, para Moodle 3.11, é MOODLE_311_STABLE

         git checkout MOODLE_311_STABLE

         A verificação da ramificação também pode ser usada 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

4. Verificar a estrutura da pasta.

   O diretório de ferramenta do administrador deve ser nomeado ally. Deve haver um caminho conforme abaixo:

   [yourmoodledir]/admin/tool/ally

   O diretório de filtro deve ser nomeado ally. Deve haver um caminho conforme abaixo:

   [yourmoodledir]/filter/ally

   O diretório de relatório deve ser nomeado allylti. Deve haver um caminho conforme abaixo:

   [yourmoodledir]/report/allylti

5. Certifique-se de que cada pasta e seus conteúdos possam ser lidos pelo seu servidor da web.
6. 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. Selecione este botão para instalar os plug-ins.
7. Após instalar os plug-ins, navegue até Administração do sistema > Plug-ins > Ferramentas do administrador > Ally.

8. Selecione Autoconfigurar o serviço da web do Ally.

   Na próxima tela haverá um código do serviço da web e um 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 feito com êxito, você terá que copiar o código de serviço da web do Ally e o link de serviço da 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 salvos.

Configurar o plug-in do Moodle

A consultoria técnica do Ally criará um cliente do Ally usando 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. Selecione Configuração do Ally.
3. Insira os seguintes detalhes

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

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

   • Chave: a chave de LTI fornecida pelo consultor técnico do Ally
   • Segredo: o segredo de LTI fornecido pelo consultor técnico do Ally
   • URL inicial: o URL inicial de LTI fornecido pelo consultor técnico do Ally
   • URL de atualização de arquivo: o URL de evento/atualização de arquivo fornecido pelo consultor técnico do Ally. https://[AllyEnvironment].ally.ac/api/v1/events
   • Código do cliente: Código do cliente fornecido pelo consultor técnico do Ally
   • Intervalo de log: Leve
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.

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. Selecione Acessibilidade.

Mais sobre o Relatório institucional do Ally

Filtro do Ally

Quando você estiver pronto para obter os indicadores de pontuação de acessibilidade do Ally, e a opção para baixar a versão de acessibilidade alternativa ficar disponível dentro do 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 a você instruções sobre como acessar a Configuração do Ally  durante a instalação. Se você não tiver acesso, envie uma solicitação no Behind the Blackboard.