E-mail

Templates de e-mail baseados em tokens, enviados através do cbmailservices.

E-mail

Os templates de e-mail utilizam o cbmailservices com simples placeholders @token@, substituídos no momento do envio:

<h1>Reset Your Password</h1>
<p>Click the link below to reset your password:</p>
<a href="@linkToken@">Reset Password</a>
<p>This link expires @expiration@.</p>

Enviado a partir de uma chamada ao serviço:

mailService.newMail()
    .config( from = "noreply@app.com", to = user.getEmail(), subject = "Reset Password" )
    .setBodyTokens( { linkToken: resetLink, expiration: "in 60 minutes" } )
    .setBodyTemplate( "password_verification" )
    .send();

Templates incluídos

Protocolo por ambiente

Visualizador de registo de correio (desenvolvimento)

Todo o correio escrito em disco pelo protocolo de ficheiros pode ser consultado em /cbmailservices/log enquanto a aplicação está em execução em desenvolvimento. É uma página do próprio cbmailservices (não um handler do cbGenesis), que lista cada mensagem enviada com uma pré-visualização renderizada e uma vista do código-fonte em bruto do HTML realmente gerado:

O visualizador só aparece em desenvolvimento: Log.cfc verifica controller.getSetting( "environment" ) == "development" em cada ação e devolve um 404 caso contrário, pelo que não há nada a desativar antes de implantar.

Como encontra o seu correio

O serviço de registo não lê uma pasta fixa - inspeciona cada mailer registado na configuração mailers de app/config/modules/cbmailservices.bx, e lista mensagens de qualquer mailer que utilize o protocolo File:

mailers : {
    "default" : { class : "BXMail" },
    "files" : { class : "File", properties : { filePath : "/app/logs" } }
},

O cbGenesis inclui esse mailer files por predefinição, e development() no mesmo ficheiro muda defaultProtocol para "files" - pelo que todo o correio que a aplicação envia enquanto environment é development chega ali automaticamente, sem nada mais a configurar.

Para o apontar para outra pasta, ou adicionar um segundo mailer baseado em ficheiros para testar outra configuração de forma isolada, adicione ou edite uma entrada em mailers com class: "File" e um filePath; o visualizador deteta qualquer mailer correspondente, não só files.

Gerir mensagens

Tanto a interface como as suas rotas JSON subjacentes suportam a limpeza, útil quando uma execução de testes deixa uma pilha de mensagens: