メール

cbmailservices を通じて送信される、トークンベースのメールテンプレート。

メール

メールテンプレートは cbmailservices を使用しており、送信時に置き換えられる単純な @token@ プレースホルダーを持ちます。

<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>

サービス呼び出しから送信します。

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

同梱されているテンプレート

環境別のプロトコル

メールログビューア(開発環境)

ファイルプロトコルによってディスクに書き込まれたすべてのメールは、アプリが開発環境で動作している間、/cbmailservices/log で閲覧できます。これは cbmailservices 自体のページであり(cbGenesis のハンドラーではありません)、送信されたすべてのメッセージを、レンダリングされたプレビューと、実際に生成された HTML の生ソース表示付きで一覧表示します。

このビューアは開発環境でのみ表示されます。Log.cfc はすべてのアクションで controller.getSetting( "environment" ) == "development" を確認し、そうでない場合は 404 を返すため、デプロイ前に無効化する必要は何もありません。

メールをどのように見つけるか

ログサービスは固定フォルダーを読むわけではありません - app/config/modules/cbmailservices.bx の mailers 設定に登録されているすべてのメーラーを調べ、File プロトコルを使用しているメーラーからのメッセージを一覧表示します。

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

cbGenesis はこの files メーラーを標準で同梱しており、同じファイル内の development() は defaultProtocol を "files" に切り替えます - そのため、environment が development である間にアプリが送信するすべてのメールは、追加の設定なしに自動的にそこに届きます。

別のフォルダーを指定したり、別の設定を分離してテストするために 2 つ目のファイルベースのメーラーを追加したりするには、class: "File" と filePath を持つエントリを mailers の下に追加または編集してください。ビューアは files だけでなく、一致するすべてのメーラーを取り込みます。

メッセージの管理

UI とその基盤となる JSON ルートの両方がクリーンアップに対応しており、テスト実行によってメッセージの山が残った場合に便利です。