Novinky v Mail module
verze 5.x

Kompletní dokumentace

Honza Novotný, Martin Halama, Jakub Liška

Transakční vs. direct maily

  • potvrzení objednávky, registrace a další "aplikační zprávy"
  • musí se doručit spolehlivě a hned
  • konfigurují se pomocí "listenerů"
  • je možné je doručovat se zpožděním
  • je jich velké množství
  • konfigurují se pomocí "supertemplate"

Nově je potřeba rozlišovat rozdílné kanály.

Transakční e-maily

Postavené na principu producent / konzument a odesílají se okamžitě.


<listeners>
    <listener throwException="true">
        <filters>
            <eventName>userCreated</eventName>
        </filters>
        <messageTemplate extends="default">
            <emailTemplate>
                <subject>Jáchym: Registrační email</subject>
            </emailTemplate>
            <messageTextResource>storage:f.sys:registrationEmail.ftl</messageTextResource>
        </messageTemplate>
    </listener>
</listeners>
Tip: V konzoli Tomcatu je vidět informace o odeslání e-mailu. Pro testování používejte GMail, zprávy jsou tam doručeny okamžitě. Pro různé uživatele používejte adresy ve tvaru email+role@gmail.com.

Šablony zpráv umožňují konfigurovat všechny základní vlastnosti e-mailu.

Vlastnosti dodávají zprávám dynamiku.

Kanál pro transakční e-maily

Používá se standardní smtp.fg.cz server.

Dokumentace zde


<channel name="default" title="Výchozí e-mail kanál">
    <smtpServer>smtp.fg.cz</smtpServer>
    <smtpPort>25</smtpPort>
    <bounceAddress>bounce@fg.cz</bounceAddress>
    <encoding>utf-8</encoding>
</channel>
Tip:
Není nutné konfigurovat, pokud je jen jeden kanál. Nově je podporována in autentizace SMTP serveru. Je možné také nakonfigurovat záložní SMTP servery, pokud je hlavní mimo provoz.

Direct e-maily

Vytvářejí se v administraci Edee pomocí customizovaného editoru na základě superšablon.

Při odeslání jsou načteni příjemci z adresních listů uloženy do lokální databáze a teprve, pokud se uložení povede, se začnou rozesílat.

Odesílají se na pozadí po 50 zprávách, dokud nejsou plně rozeslány.

DEMO

Kanál pro direct e-maily

Používá se dedikovaný smtp.massmail.fg.cz server.


<channel name="directmail" title="Kanál určený pro newslettery">
    <smtpServer>smtp.massmail.fg.cz</smtpServer>
    <smtpPort>25</smtpPort>
    <bounceAddress>bounce@fg.cz</bounceAddress>
    <encoding>utf-8</encoding>
    <agentPort>1523</agentPort>
    <agentAuth>cpsadmin:a1femtVrFElg</agentAuth>
    <agentJobLength>10</agentJobLength>
    <clientId>t-mobile-NL</clientId>
</channel>

Důvody:

  • doména může být "greylistována"
  • na SMTP serveru běží agent indexující log
  • nechceme agenta přetěžovat

Tip: u superšablon je možné nakonfigurovat targetChannel.

Trocha teorie nikoho nezabije

Vycházíme z blueprintů MailChimpu.

  • deliverability (refusal, spam)
    • SPF - Sender Policy Framework (děláme), nutnost!
    • DKIM - DomainKeys Identified Mail (neděláme)
    • DMARC - Domain-based Message Authentication, Reporting and Conformance (neděláme)
    • whitelisting, blacklisting, greylisting (děláme částečně)
    • FBL - feedback loop (neděláme)
    • SPAM analyzery (SPAM Assasin)
  • bounces (VERP / vs. log analysis)

Nasazení directmailu

Postupujte podle návodu.

  1. vytvoření superšablony
  2. definice adresních listů
  3. úprava editoru klientské šablony
  4. konfigurace massmail kanálu
  5. nastylování frontendu
  6. nastavení oprávnění

Skriptování

  1. fáze: sloučení super šablony s klientskou šablonou interpretují se všechny FreeMarker direktivy v superšabloně, které nejsou <#-- zakomentované FreeMarker komentářem --> a jsou vyhodnoceny všechny dostupné proměnné
  2. fáze: personalizace šablony z 1. fáze interpretují se všechny direktivy v superšabloně zakomentované FreeMarker komentářem a ty, které byly uvedeny v polích klientské šablony

Personalizace

  • Kopie vlastností uživatele se nachází v T_MAIL_RCPT_PROPS
  • model je možné dle potřeby rozšířit
  • Javisti mají k dispozici @ScriptingVariable

Zase jsme o kousek dál

Děkuji za pozornost

mail tým, FG Forrest