forked from hakimel/reveal.js
-
Notifications
You must be signed in to change notification settings - Fork 3
/
mail-module-v5.html
269 lines (246 loc) · 16.4 KB
/
mail-module-v5.html
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>Novinky v Mail module v. 5.x</title>
<meta name="description" content="A framework for easily creating beautiful presentations using HTML">
<meta name="author" content="Hakim El Hattab">
<meta name="apple-mobile-web-app-capable" content="yes" />
<meta name="apple-mobile-web-app-status-bar-style" content="black-translucent" />
<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=no">
<link rel="stylesheet" href="css/reveal.min.css">
<link rel="stylesheet" href="css/theme/night.css" id="theme">
<!-- For syntax highlighting -->
<link rel="stylesheet" href="lib/css/zenburn.css">
<!-- If the query includes 'print-pdf', use the PDF print sheet -->
<script>
document.write( '<link rel="stylesheet" href="css/print/' + ( window.location.search.match( /print-pdf/gi ) ? 'pdf' : 'paper' ) + '.css" type="text/css" media="print">' );
</script>
<!--[if lt IE 9]>
<script src="lib/js/html5shiv.js"></script>
<![endif]-->
</head>
<body>
<div style="display: block; position: absolute; bottom: 40px; left: 50%; margin-left: -70px; z-index: 20;">
<a href="http://www.fg.cz"><img src="img/jopenspace2013/FG_Forrest_neg.png" width="140px"/></a>
</div>
<div class="reveal">
<div class="slides">
<section data-background="img/backgrounds/black.jpg">
<h1>Novinky v Mail module<br/> verze 5.x</h1>
<h3><a href="http://prototype.test.fg.cz/srv/www/qf/cs/ramjet/docs/mail/">Kompletní dokumentace</a></h3>
<p>
<small>Honza Novotný, Martin Halama, Jakub Liška</small>
</p>
</section>
<section data-background="img/backgrounds/brown.jpg">
<h1>Transakční vs. direct maily</h1>
<div style="width: 48%; display: inline-block; vertical-align: top;">
<img src="img/mail-module-v5/transaction.jpg" height="200px"/>
<div style="height: 70%">
<ul>
<li>potvrzení objednávky, registrace a další "aplikační zprávy"</li>
<li>musí se doručit spolehlivě a hned</li>
<li>konfigurují se pomocí "listenerů"</li>
</ul>
</div>
</div>
<div style="width: 48%; display: inline-block;">
<img src="img/mail-module-v5/direct-mail.jpg" height="200px"/>
<ul style="height: 70%;">
<li>je možné je doručovat se zpožděním</li>
<li>je jich velké množství</li>
<li>konfigurují se pomocí "supertemplate"</li>
</ul>
</div>
<h3 style="margin-top: 1em; color: green;">Nově je potřeba rozlišovat rozdílné kanály.</h3>
</section>
<section>
<section data-background="img/backgrounds/brown.jpg">
<h1>Transakční e-maily</h1>
<p>
Postavené na principu <cite>producent / konzument</cite> a odesílají se okamžitě.<br/>
</p>
<pre style="width: 70%; display: inline-block; margin-top: 3em; margin-bottom: 3em;"><code data-trim contenteditable>
<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>
</code></pre>
<div style="width: 25%; display: inline-block; vertical-align: top; margin-top: 2em; margin-bottom: 2em;">
<strong style="color: green">Tip:</strong>
<small style="margin-top: 1em">V konzoli Tomcatu je vidět informace o odeslání e-mailu.</small>
<small style="margin-top: 1em">Pro testování používejte GMail, zprávy jsou tam doručeny okamžitě.</small>
<small style="margin-top: 1em">Pro různé uživatele používejte adresy ve tvaru <a
href="mailto:[email protected]">[email protected]</a>.</small>
</div>
<p>
<a href="http://prototype.test.fg.cz/srv/www/qf/cs/ramjet/docs/mail/web_developers/messageTemplates.html" target="_new">Šablony zpráv</a>
umožňují konfigurovat všechny základní vlastnosti e-mailu.
</p>
<p>
<a href="http://prototype.test.fg.cz/srv/www/qf/cs/ramjet/docs/mail/reference/features.html" target="_new">Vlastnosti</a>
dodávají zprávám dynamiku.
</p>
</section>
<section data-background="img/backgrounds/brown.jpg">
<h1>Kanál pro transakční e-maily</h1>
<p>Používá se standardní <strong>smtp.fg.cz</strong> server.</p>
<p><a href="http://prototype.test.fg.cz/srv/www/qf/cs/ramjet/docs/mail/web_developers/channels.html" target="_new">Dokumentace zde</a></p>
<pre style="width: 50%; display: inline-block; margin-top: 5em; margin-bottom: 3em;"><code data-trim contenteditable>
<channel name="default" title="Výchozí e-mail kanál">
<smtpServer>smtp.fg.cz</smtpServer>
<smtpPort>25</smtpPort>
<bounceAddress>[email protected]</bounceAddress>
<encoding>utf-8</encoding>
</channel>
</code></pre>
<div style="width: 35%; display: inline-block; vertical-align: top; margin-top: 2em; margin-left: 3em;">
<strong style="color: green">Tip:</strong><br/>
<small style="margin-top: 1em">Není nutné konfigurovat, pokud je jen jeden kanál.</small>
<small style="margin-top: 1em">Nově je podporována in autentizace SMTP serveru.</small>
<small style="margin-top: 1em">Je možné také nakonfigurovat záložní SMTP servery, pokud je hlavní mimo provoz.</small>
</div>
</section>
</section>
<section>
<section data-background="img/backgrounds/brown.jpg">
<h1>Direct e-maily</h1>
<img src="img/mail-module-v5/direct-mail-flow.png"/>
<p>Vytvářejí se v administraci Edee pomocí <a href="http://prototype.test.fg.cz/srv/www/qf/cs/ramjet/docs/mail/web_developers/clientTemplateEditor.html" target="_new">customizovaného editoru</a> na základě
<a href="http://prototype.test.fg.cz/srv/www/qf/cs/ramjet/docs/mail/web_developers/superTemplates.html" target="_new">superšablon</a>.</p>
<p>Při odeslání jsou načteni příjemci z <a href="http://prototype.test.fg.cz/srv/www/qf/cs/ramjet/docs/mail/web_developers/addressLists.html" target="_new">adresních listů</a> uloženy do lokální databáze a teprve, pokud se uložení povede, se začnou rozesílat.</p>
<p>Odesílají se na pozadí po 50 zprávách, dokud nejsou plně rozeslány.</p>
<h3><a href="http://novinky3.t-mobile.test.fg.cz/srv/www/adm/qf/cs/edeeui/entry?lang=cs" target="_new">DEMO</a></h3>
</section>
<section data-background="img/backgrounds/brown.jpg">
<h1>Kanál pro direct e-maily</h1>
<p>Používá se dedikovaný <strong>smtp.massmail.fg.cz</strong> server.</p>
<pre style="width: 50%; display: inline-block; margin-top: 4em; margin-bottom: 3em;"><code data-trim contenteditable>
<channel name="directmail" title="Kanál určený pro newslettery">
<smtpServer>smtp.massmail.fg.cz</smtpServer>
<smtpPort>25</smtpPort>
<bounceAddress>[email protected]</bounceAddress>
<encoding>utf-8</encoding>
<agentPort>1523</agentPort>
<agentAuth>cpsadmin:a1femtVrFElg</agentAuth>
<agentJobLength>10</agentJobLength>
<clientId>t-mobile-NL</clientId>
</channel>
</code></pre>
<div style="width: 35%; display: inline-block; vertical-align: top; margin-top: 1em; margin-left: 3em;">
<h3 style="color: green; margin-bottom: 1em">Důvody:</h3>
<ul>
<li>doména může být "greylistována"</li>
<li>na SMTP serveru běží agent indexující log</li>
<li>nechceme agenta přetěžovat</li>
</ul>
</div>
<p><strong style="color: green">Tip: </strong> u <a href="http://prototype.test.fg.cz/srv/www/qf/cs/ramjet/docs/mail/web_developers/superTemplates.html" target="_new">superšablon</a> je možné nakonfigurovat <em>targetChannel</em>.</p>
</section>
<section data-background="img/backgrounds/brown.jpg">
<h1>Trocha teorie nikoho nezabije</h1>
<p>Vycházíme z <a href="http://mailchimp.com/resources/guides/email-delivery-for-it-professionals/html/" target="_new">blueprintů MailChimpu</a>.</p>
<ul style="width: 50%">
<li>deliverability (refusal, spam)</li>
<ul>
<li>SPF - Sender Policy Framework (děláme), <strong>nutnost!</strong></li>
<li>DKIM - DomainKeys Identified Mail (neděláme)</li>
<li>DMARC - Domain-based Message Authentication, Reporting and Conformance (neděláme)</li>
<li>whitelisting, blacklisting, greylisting (děláme částečně)</li>
<li>FBL - feedback loop (neděláme)</li>
<li>SPAM analyzery (SPAM Assasin)</li>
</ul>
<li>bounces (VERP / vs. log analysis)</li>
<ul>
<li><a href="http://update.massmail.fg.cz/agent/bounce-regex-list.xml" target="_new">kategorizace</a></li>
<li>deferred</li>
<li>hard bounce</li>
<li>soft bounce</li>
</ul>
</ul>
<img src="img/mail-module-v5/mailchimp.jpg" style="float: right; width: 400px"/>
</section>
</section>
<section data-background="img/backgrounds/brown.jpg">
<h1>Nasazení directmailu</h1>
<p>Postupujte podle <a href="http://prototype.test.fg.cz/srv/www/qf/cs/ramjet/docs/mail/web_developers/directMail.html" target="_new">návodu</a>.</p>
<ol style="font-size: 110%; line-height: 120%; margin-top: 3em">
<li>vytvoření <a href="http://prototype.test.fg.cz/srv/www/qf/cs/ramjet/docs/mail/web_developers/messageTemplates.html" target="_new">superšablony</a></li>
<li>definice <a href="http://prototype.test.fg.cz/srv/www/qf/cs/ramjet/docs/mail/web_developers/addressLists.html" target="_new">adresních listů</a></li>
<li>úprava <a href="http://prototype.test.fg.cz/srv/www/qf/cs/ramjet/docs/mail/web_developers/clientTemplateEditor.html" target="_new">editoru klientské šablony</a></li>
<li>konfigurace massmail kanálu</li>
<li>nastylování <a href="http://prototype.test.fg.cz/srv/www/qf/cs/ramjet/docs/mail/web_developers/subscription.html" target="_new">frontendu</a></li>
<li>nastavení <a href="http://prototype.test.fg.cz/srv/www/qf/cs/ramjet/docs/mail/web_developers/authorization.html" target="_new">oprávnění</a></li>
</ol>
<img src="img/mail-module-v5/recipe.png" style="float: right"/>
</section>
<section data-background="img/backgrounds/brown.jpg">
<h1>Skriptování</h1>
<ol style="font-size: 110%; line-height: 110%; margin-top: 1em; margin-bottom: 1em; width: 60%">
<li>
fáze: sloučení super šablony s klientskou šablonou
<small>interpretují se všechny FreeMarker direktivy v superšabloně, které nejsou <#-- zakomentované FreeMarker komentářem -->
a jsou vyhodnoceny všechny <a href="http://prototype.test.fg.cz/srv/www/qf/cs/ramjet/docs/mail/web_developers/templating.html">dostupné proměnné</a></small>
</li>
<li>
fáze: personalizace šablony z 1. fáze
<small>interpretují se všechny direktivy v superšabloně zakomentované FreeMarker komentářem a ty, které byly uvedeny v polích klientské šablony</small>
</li>
</ol>
<img src="img/mail-module-v5/scripting.png" style="float: right"/>
<h2>Personalizace</h2>
<div style="font-size: 90%; margin-top: 1em; margin-bottom: 1em; width: 60%">
<ul>
<li>Kopie vlastností uživatele se nachází v <strong>T_MAIL_RCPT_PROPS</strong></li>
<li>model je možné dle potřeby <a href="http://prototype.test.fg.cz/srv/www/qf/cs/ramjet/docs/mail/web_developers/metamodelExtension.html" target="_new">rozšířit</a></li>
<li>Javisti mají k dispozici @ScriptingVariable</li>
</ul>
</div>
</section>
<section data-background="img/backgrounds/black.jpg">
<h1>Zase jsme o kousek dál</h1>
<h3>Děkuji za pozornost</h3>
<p>
<small>mail tým, FG Forrest</small>
</p>
</section>
</div>
</div>
<script src="lib/js/head.min.js"></script>
<script src="js/reveal.min.js"></script>
<script src="js/jquery.min.js"></script>
<script>
// Full list of configuration options available here:
// https://github.com/hakimel/reveal.js#configuration
Reveal.initialize({
controls: true,
progress: true,
history: true,
center: true,
width: 1200,
height: 900,
theme: Reveal.getQueryHash().theme, // available themes are in /css/theme
transition: Reveal.getQueryHash().transition || 'default', // default/cube/page/concave/zoom/linear/fade/none
// Optional libraries used to extend on reveal.js
dependencies: [
{ src: 'lib/js/classList.js', condition: function() { return !document.body.classList; } },
{ src: 'plugin/markdown/marked.js', condition: function() { return !!document.querySelector( '[data-markdown]' ); } },
{ src: 'plugin/markdown/markdown.js', condition: function() { return !!document.querySelector( '[data-markdown]' ); } },
{ src: 'plugin/highlight/highlight.js', async: true, callback: function() { hljs.initHighlightingOnLoad(); } },
{ src: 'plugin/zoom-js/zoom.js', async: true, condition: function() { return !!document.body.classList; } },
{ src: 'plugin/notes/notes.js', async: true, condition: function() { return !!document.body.classList; } }
]
});
</script>
</body>
</html>