// serviço · migração h5p
Migração H5P: do mod_hvp legacy ao mod_h5pactivity oficial
Migração estruturada de conteúdo H5P legado para o módulo oficial mantido pelo HQ do Moodle. Preservamos progresso, notas, attempts e analytics dos alunos. Compatível com Moodle 4.x e 5.x. Garantia contratual de 95% de preservação de dados.
// para quem é
Para quem é
Você acumulou conteúdo H5P em mod_hvp ao longo dos anos e agora descobriu que o plugin morreu:
Biblioteca H5P em produção
Dezenas ou centenas de atividades H5P em cursos ativos, com alunos atualmente registrando progresso. Não dá para "começar de zero".
L&D com investimento histórico
Departamento T&D investiu anos criando conteúdo interativo. Notas e progresso fazem parte do histórico oficial de colaboradores.
Upgrade Moodle travado por H5P
Tentaram fazer upgrade para Moodle 5.x e descobriram que mod_hvp não é compatível. Upgrade parou. Precisam destravar.
// escopo
O que entregamos
Migração não é "rodar script e pronto". É processo estruturado com validação por amostragem.
- Inventário completo do conteúdo H5P — todas as atividades mod_hvp em cursos ativos e inativos, tipos de conteúdo (interactive video, question set, course presentation, etc.), bibliotecas usadas, atividades órfãs.
- Mapeamento de bibliotecas obsoletas — bibliotecas H5P descontinuadas que precisam de tratamento especial (Documentation Tool legacy, antigas Question Sets). Decisão por caso: manter congelado, converter, recriar.
- Análise do volume de attempts e progresso — quantos alunos têm progresso em cada atividade, quanto será preservado, onde está o risco.
- Staging com migração completa em ambiente isolado — toda a biblioteca migrada em staging antes de tocar produção. Validação por amostragem com sua equipe.
- Migração de attempts e notas — script de migração mapeia
hvp_xapi_resultsparah5pactivity_attempts+h5pactivity_attempts_resultspreservando integridade. - Preservação de notas no gradebook — re-vinculação das atividades migradas com a coluna do gradebook existente, mantendo histórico de notas dos alunos.
- Validação por amostragem (10-20 atividades) — você testa em staging com sua equipe educativa. Sign-off antes de produção.
- Go-live em janela combinada — migração da produção em janela de manutenção. Backup completo + rollback plan.
- Remoção segura do mod_hvp — após validação pós-migração, desinstalação do plugin descontinuado e limpeza de tabelas órfãs.
- 30 dias de suporte — qualquer comportamento divergente identificado pelos alunos é tratado sem custo adicional.
// metodologia
Como trabalhamos
5 etapas com checkpoint em cada uma. Validação técnica + validação pedagógica antes do go-live.
Mapeamento completo
Catalogação de todas as atividades H5P em mod_hvp, tipos de conteúdo, bibliotecas usadas, volume de attempts, dependências em outros plugins.
Bibliotecas obsoletas
Identificação de bibliotecas H5P descontinuadas. Decisão caso a caso (manter, converter, recriar). Relatório dos 5% potencialmente afetados.
Migração em ambiente isolado
Clone idêntico da produção. Migração completa do mod_hvp para mod_h5pactivity em staging. Nada toca produção nesta fase.
Sign-off pedagógico
Sua equipe educativa valida 10-20 atividades em staging com dados reais migrados. Sign-off escrito antes de produção.
Migração da produção
Janela combinada, backup completo, migração replicando staging, validação imediata. Rollback plan documentado e disponível.
30 dias pós go-live
Comportamento divergente identificado por alunos ou professores é tratado sem custo. Após 30 dias, suporte continuado opcional.
// padrões que atendemos
Tipologias de bibliotecas H5P que migramos
Quatro arquétipos típicos. O esforço de migração varia 5x entre eles.
Biblioteca grande, attempts pesados
Empresa com centenas de atividades H5P em cursos corporativos, milhares de attempts acumulados, notas no histórico oficial de colaboradores. Migração com integridade contratualizada e validação por departamento.
Cursos com alunos em meio do semestre
Escola com H5P em cursos ativos, alunos com progresso parcial registrado. Janela de migração tem que ser fora do horário letivo. Validação pedagógica é crítica — professor confere que a atividade preserva comportamento.
Plataforma de cursos pagos / on-demand
Cursos vendidos individualmente, conteúdo descartável após conclusão, attempts não pesam tanto. Foco: zero downtime de venda. Migração pode acontecer curso a curso ao longo de semanas.
H5P em módulos oficiais
Universidade ou órgão público com H5P incorporado em módulos institucionais. Conteúdo precisa de auditoria documental, attempts entram no histórico acadêmico. Compliance + integração com SIE pode estar no escopo.
A migração H5P pode rodar isolada (só H5P) ou bundled junto com upgrade do core para Moodle 5.2. Bundled costuma ser mais eficiente porque compartilha staging e janelas de manutenção.
// investimento
O que define o orçamento
Migração H5P escala com volume e complexidade. Variáveis principais:
Inventário inicial gratuito (script read-only que conta atividades, tipos e attempts) define escopo e orçamento fechado em até 5 dias úteis.
// faq
Perguntas frequentes
Por que mod_hvp foi descontinuado?
O plugin mod_hvp era a integração antiga e não oficial do H5P com Moodle, mantida pela própria comunidade H5P. A partir do Moodle 3.9, a integração oficial passou a ser mod_h5pactivity, mantida pelo HQ do Moodle. mod_hvp ficou sem updates de segurança e gradualmente incompatível com novas versões do core. Manter mod_hvp em produção hoje é dívida técnica + risco de segurança.
Vou perder o progresso dos alunos na migração?
Não, se feito corretamente. Garantimos 95% de preservação de attempts, notas e progresso. Os 5% restantes cobrem tipos de conteúdo H5P descontinuados ou bibliotecas obsoletas que não têm equivalente no formato atual — esses casos são identificados e reportados antes da migração para decisão do cliente.
Posso manter mod_hvp e mod_h5pactivity rodando juntos?
Tecnicamente sim, em Moodle 4.x. Mas é solução temporária — mod_hvp não recebe mais updates de segurança e em algum ponto vai quebrar. Recomendamos migrar a biblioteca inteira de uma vez em vez de manter duplicidade que vai gerar dívida técnica permanente.
E os conteúdos H5P feitos no h5p.com (Lumi)?
Conteúdos criados no h5p.com ou ferramentas externas podem ser exportados em .h5p e reimportados em mod_h5pactivity sem perda. A migração cobre tanto conteúdo embedded no banco do Moodle quanto referências externas com integração via OAuth.
Vão atualizar as bibliotecas H5P descontinuadas?
Bibliotecas H5P descontinuadas (algumas Question Sets antigas, Documentation Tool legacy, etc.) são identificadas no inventário inicial. Para cada uma propomos três opções: manter formato congelado (sem updates futuros), converter para biblioteca equivalente atual, ou recriar conteúdo do zero. Cliente decide caso a caso.
É melhor migrar H5P sozinho ou junto com upgrade do core?
Bundled é geralmente mais eficiente — compartilha staging, janela de manutenção e validação. Se você já está em Moodle 4.x estável e só quer resolver H5P, migração isolada faz sentido. Se está em Moodle 3.x e vai upgradear para 5.2, é praticamente obrigatório migrar H5P como parte do upgrade (mod_hvp não roda em 5.x).
Quanta interatividade seu curso realmente entrega?
Faça o diagnóstico técnico de engajamento em 2-3 minutos (inclui H5P como uma das frentes). Score 0-100 + plano de evolução adaptado ao seu cenário.
Fazer diagnósticoSua biblioteca H5P está pronta para o próximo Moodle?
Reserve 30 minutos com Alejandro para inventário inicial + escopo de migração.
Reservar inventário de 30 minOu direto por email: ceo@programamoodle.com