Como instalar plugin no Moodle (e o que conferir antes)

Instalar um plugin no Moodle leva poucos minutos. O que dá trabalho é o que vem depois, quando o plugin não acompanha uma atualização. Por isso este guia começa pelo que conferir antes de instalar.

Antes de instalar: 4 conferências

1. Compatibilidade: no diretório oficial de plugins, veja se ele suporta a sua versão do Moodle e a próxima que você pretende instalar.
2. Manutenção: data da última versão e quem mantém. Plugin parado há anos é risco.
3. Necessidade real: o Moodle já resolve sozinho? Relatórios personalizados, H5P e emblemas são nativos. Veja os plugins que valem a pena.
4. Backup: banco de dados e pasta moodledata, antes de qualquer instalação em produção. Saiba mais em como fazer backup do Moodle.

Jeito 1: pelo painel do Moodle

1. Baixe o arquivo ZIP do plugin no diretório oficial, na versão certa para o seu Moodle.
2. Vá em Administração do site > Plugins > Instalar plugins.
3. Envie o ZIP e clique para instalar. O Moodle valida o pacote e mostra o que vai ser instalado.
4. Confirme o upgrade do banco de dados e preencha as configurações iniciais do plugin.

Se a opção de instalar não aparece, é porque a instalação pelo painel está desativada ou o servidor não tem permissão de escrita. Aí vale o jeito 2.

Jeito 2: pelo servidor

1. Extraia o plugin na pasta do tipo dele: atividades em mod, blocos em blocks, temas em theme, plugins locais em local, e assim por diante. O README do plugin indica o lugar exato. A partir do Moodle 5.1, confira a estrutura com a pasta public.
2. Confira se o nome da pasta é exatamente o esperado, sem sufixos como "-master".
3. Abra Administração do site > Notificações e conclua a instalação.

Depois de instalar

• Teste com um usuário comum, não só com o administrador.
• Anote o que foi instalado e por quê. Na hora do upgrade, essa lista evita surpresas.
• Acompanhe as atualizações do plugin junto com as do Moodle.

Como desinstalar sem deixar sujeira

Apagar a pasta do plugin não basta: as tabelas e configurações ficam no banco. O caminho certo é Administração do site > Plugins > Visão geral dos plugins, opção de desinstalar, e só depois remover a pasta. Faça backup antes, porque a desinstalação apaga os dados do plugin.

Se depois de instalar algo o Moodle passou a mostrar erro 500 ou "Error reading from database", o plugin é o primeiro suspeito.

Perguntas frequentes