Integração com o Moodle.
O VCOSTAEDU mantém o Moodle da instituição atualizado com o que a secretaria registra. A ligação é feita por um plugin instalado no Moodle, que prepara o site e entrega o endereço e a chave que o VCOSTAEDU usa.

O que a integração faz
- O aluno. O cadastro do aluno no VCOSTAEDU cria a conta dele no Moodle, e a edição do cadastro atualiza a conta.
- A disciplina. A disciplina ofertada no ano vira uma disciplina no Moodle, na categoria que a instituição escolhe. Quando a oferta muda de nome, o nome no Moodle acompanha.
- O professor. O professor indicado na disciplina é inscrito nela no Moodle, com edição ou sem edição, conforme a escolha da instituição.
- A inscrição. A enturmação no VCOSTAEDU inscreve o aluno na disciplina do Moodle, e a saída da turma retira a inscrição.
- A situação da matrícula. O trancamento, o cancelamento e a reativação da matrícula chegam ao Moodle conforme a escolha da instituição: suspender a inscrição, removê-la ou não fazer nada.
- A conta que já existe. Antes de criar uma conta, o sistema procura o aluno no Moodle pelo número de identificação, pelo nome de usuário e pelo e-mail. Uma conta encontrada é vinculada, sem duplicidade; quando o mesmo e-mail aparece em mais de uma conta, a secretaria escolhe a conta certa na tela Envios ao Moodle.
- A entrada do aluno. No portal do aluno, o botão do Moodle abre a disciplina já identificada, por um link de uso único que o servidor pede ao Moodle e que nunca aparece na tela. O link não é pedido para aluno inativo, com matrícula trancada ou cancelada.
O plugin no Moodle
O plugin local_vcostaedu é instalado como qualquer plugin do Moodle, pelo envio do pacote em Administração do site > Plugins > Instalar plugins. Depois, a página Conectar ao VCOSTAEDU confere item por item o que a integração precisa e corrige o que falta.
Tela redesenhada para leitura no celular.
Tela redesenhada para leitura no celular.
Tela redesenhada para leitura no celular.
O que o plugin cria no Moodle
- Um serviço web chamado "VCOSTAEDU", com as 17 funções que a integração usa, liberado só para usuários autorizados.
- Um papel,
vcostaedu_ws, com as 29 permissões que essas funções exigem e mais nenhuma. - Um usuário de serviço, também
vcostaedu_ws, com esse papel, uma senha que ninguém conhece e um e-mail que não recebe mensagens. - Uma chave de acesso, gerada pelo administrador na página do plugin e colada no VCOSTAEDU, onde fica guardada cifrada.
O que o plugin não faz
- Não liga os web services sozinho: o administrador do Moodle decide, pelo botão da página.
- Não envia dados a servidor nenhum: é o VCOSTAEDU que chama o Moodle, nunca o contrário.
- Não muda as configurações de e-mail nem de inscrição do Moodle.
- Não guarda dado pessoal em tabelas próprias.
- Não abre sessão por link para administradores do site, visitantes nem para a conta de serviço, e nunca gera link para conta suspensa, excluída, não confirmada ou bloqueada.
Ao ser desinstalado, o plugin remove o serviço com as suas chaves, os links de entrada pendentes e o papel e o usuário que ele criou.
Compatibilidade e licença
A integração é compatível com o Moodle 4.5 a 5.3. O plugin foi testado nas versões 4.5.16, 5.0.12, 5.1.9, 5.2.5 e 5.3.1, com MySQL, MariaDB ou PostgreSQL, e não depende de outro plugin nem de ferramenta de linha de comando.
O plugin é distribuído sob a licença GNU GPL, versão 3 ou posterior, a mesma família de licenças do Moodle, em dois pacotes: um só em inglês e outro com os textos em português.
Quando o Moodle está indisponível
Se o Moodle estiver indisponível, o cadastro é preservado e o envio aguarda em fila, com o motivo de cada falha descrito em linguagem clara.
A gravação acadêmica nunca depende do Moodle: a matrícula, a nota e a enturmação ficam gravadas no VCOSTAEDU, e o envio é anotado depois. A tela Envios ao Moodle mostra cada envio com a situação, o motivo e o que fazer, e oferece "Tentar de novo" em cada linha e "Enviar tudo o que falta", que segue em passos curtos com a janela de andamento.
Tela redesenhada para leitura no celular.
Tela redesenhada para leitura no celular.