Kopere Email
message_kopereemail é um
output de mensagens baseado em message_email, criado para entregar e-mails
consistentes e com marca - sem deixar de permitir que você crie HTML totalmente
personalizado por tipo de notificação.
O que o plugin resolve (na prática)
O Moodle pode enviar muitas notificações diferentes, vindas de muitos plugins. Este plugin adiciona a camada que faltava: controle, consistência e customização sem alterações no core nem gambiarras no tema.
Como funciona
O plugin adiciona uma camada de customização sobre o fluxo de mensagens já existente do Moodle. Ele decide o que enviar com base no provider e no HTML disponível, depois padroniza a saída final com o wrapper.
- Se
fullmessagehtmlexiste → aplica o wrapper. - Se não existir → cria HTML simples a partir do texto e aplica o wrapper (se configurado).
- Copia a configuração existente de
message/emailparamessage_kopereemail. - Reescreve flags de ativação dos providers de
email→kopereemail. - Bloqueia providers (
*_locked = 1) para manter consistência. - Desativa o processador antigo de e-mail em
mdl_message_processors.
- Exporta o wrapper global.
- Exporta mensagens personalizadas por provider (componente + nome).
- Não sobrescreve preferências operacionais do Moodle, como flags enabled/locked.
Placeholders disponíveis
Templates usam placeholders no estilo Mustache. Use chaves triplas ao inserir HTML.
{{subject}}{{fullmessage}}{{{fullmessagehtml}}}{{dates.now}}
{{site.fullname}}{{site.shortname}}{{site.url}}{{site.logourl}}/{{site.compact_logourl}}
{{userto.id}}{{userto.profileurl}}{{userto.fullname}}{{userto.firstname}}/{{userto.lastname}}{{userto.email}}
{{userfrom.id}}{{userfrom.profileurl}}{{userfrom.fullname}}{{userfrom.firstname}}/{{userfrom.lastname}}{{userfrom.email}}
{{course.id}}{{course.fullname}}{{course.shortname}}{{course.url}}
- Detalhes de conclusão do curso: data de conclusão, nota, URL do certificado, tempo gasto.
- Metadados do curso: nome da categoria, data de início/fim, visibilidade, campos personalizados.
- Conveniência do destinatário: idioma preferido, fuso horário, campos de perfil (subconjunto seguro).
- Contexto do remetente: nome do papel no curso, departamento/campus (se disponível).
- Formatação utilitária: datas pré-formatadas, links seguros, “resumo curto” de mensagens longas.
- Links de CTA: URLs “Ir para o curso”, “Abrir atividade”, “Preferências de mensagens” como placeholders prontos para uso.
{{{variable}}} (chaves triplas). Usar apenas
{{variable}} pode escapar o HTML e imprimir tags como texto.
Capturas de tela
{{{fullmessagehtml}}}.
Suporte
Para dúvidas, bugs, melhorias ou sugestões, abra uma issue com: versão do Moodle, passos para reproduzir, provider afetado (componente + nome) e exemplo de template (sem dados sensíveis). Se for sobre resumo, inclua logs de cron/tarefa.
- Comece pelo wrapper: configure primeiro a identidade global.
- Customize apenas os providers que importam.
- Mantenha os templates objetivos e fáceis de ler rapidamente.
- Valide a estrutura HTML (feche as tags corretamente).
- Sempre teste depois de salvar.
- Sem modificações no core.
- Sem gambiarras no tema.
- Gestão administrativa centralizada.
- Marca consistente em todos os e-mails.
- Ajuste fino opcional por provider.
