Instalação de Plugin no Moodle

Este post apresenta o procedimento geral para a instalação de plugins no Moodle. Para integrar o Moodle ao sistema Badiu.Net, é necessário instalar três plugins: badiunet, badiuws e badiuauth. Esses plugins atuam como conectores entre as plataformas Moodle e Badiu.Net. Nesta demonstração de instalação, utilizaremos o plugin badiunet como exemplo, pois o mesmo procedimento se aplica aos demais.

 

1 - Baixe o Código do Plugin

O primeiro passo para instalar um plugin é obter o código. No repositório oficial do Moodle https://moodle.org/plugins, há diversos plugins disponíveis que você pode localizar e fazer o download. O plugin que utilizaremos como demonstração de instalação é o badiunet, um plugin do tipo local, que pode ser obtido diretamente no repositório da empresa Badiu por meio do seguinte link: https://bitbucket.org/equipei/badiunet/src/master/.

 

2 - Descompactar e Organizar Arquivos na Pasta com o Nome do Plugin

Após obter o arquivo do plugin, descompacte-o. Navegue até a pasta onde os arquivos foram descompactados e localize o arquivo version.php. Abra esse arquivo e identifique a variável $plugin->component. Verifique a definição dessa variável.

A variável $plugin->component define o tipo de plugin e o seu nome técnico. O valor dessa variável é uma string no formato {tipo}_{nome}, onde o caractere de sublinhado (_) separa o tipo do plugin do nome técnico do plugin.

  • O {tipo} refere-se ao tipo de plugin. No sistema de arquivos, corresponde à pasta onde o plugin deve ser instalado.

  • O {nome} é o nome técnico de identificação do plugin. Todos os arquivos do plugin devem estar dentro de uma pasta que tenha o mesmo nome técnico.

No caso do plugin badiunet, a configuração é:

$plugin->component = 'local_badiunet';

Isso indica que o plugin é do tipo local e deve ser instalado na pasta MOODLE_DIR_INSTALL/local.
O nome técnico do plugin é badiunet, e todos os seus arquivos e pastas devem estar organizados em uma pasta chamada badiunet, ou seja, com o mesmo nome técnico. Após a instalação, os arquivos do plugin deverão ficam em MOODLE_DIR_INSTALL/local/badiunet. Essa mesma lógica se aplica para os plugins badiuws e badiuauth.

 

3 - Transferir Arquivos para o Servidor

Coloque a pasta com o nome técnico do plugin em MOODLE_DIR_INSTALL/{tipo}. No caso do plugin badiunet, o caminho correto será MOODLE_DIR_INSTALL/local. Transfira a pasta badiunet, contendo todos os arquivos do plugin, para o diretório MOODLE_DIR_INSTALL/local no servidor Moodle.

Evite realizar a instalação pela interface gráfica. A opção de upload de arquivos pela interface gráfica não é recomendada em ambientes de produção, pois exige que a pasta raiz da web tenha permissão de escrita. Essa configuração é indicada apenas para ambientes de teste, não para ambientes de produção.

 

4 - Executar a Instalação

Acesse o Moodle com um perfil de administrador e navegue em Painel > Administração do site > Avisos, conforme ilustrado na figura a seguir.

Outra alternativa é acessar diretamente: MOODLE_URL/admin/index.php?cache=1

Após isso, será exibida a lista de novos plugins para atualização. A tela será semelhante à ilustrada na figura a seguir.

Clique no botão Atualizar base de dados do Moodle agora. Feito isso, a instalação será processada.

Se o plugin tiver variáveis que precisam ser configuradas, um formulário será exibido na sequência. Nesse caso, preencha as configurações necessárias e clique em Salvar mudanças.
De modo geral, o plugin badiunet não solicita variáveis de configuração durante a instalação.