Skip to content

Commit

Permalink
Merge branch 'master' of github.com:creationix/howtonode.org
Browse files Browse the repository at this point in the history
  • Loading branch information
Tim Caswell committed Jun 18, 2012
2 parents 9d080f1 + cc93068 commit 6dd1a6c
Show file tree
Hide file tree
Showing 2 changed files with 147 additions and 152 deletions.
294 changes: 142 additions & 152 deletions articles/sending-e-mails-with-node-and-nodemailer.markdown
View file
Expand Up @@ -7,61 +7,59 @@ Sending e-mails with [NodeJS][] is almost a breeze. Almost. First, you have to p

The first thing you tend to do is to create a wrapper class to manage all this tasks. So, I wrapped it in an Eamiler class to centralize the mail sending in my app.

```coffeescript
# /lib/emailer.coffee

emailer = require("nodemailer")
fs = require("fs")
_ = require("underscore")

class Emailer

options: {}

data: {}

# Define attachments here
attachments: [
fileName: "logo.png"
filePath: "./public/images/email/logo.png"
cid: "logo@myapp"
]

constructor: (@options, @data)->

send: (callback)->
html = @getHtml(@options.template, @data)
attachments = @getAttachments(html)
messageData =
to: "'#{@options.to.name} #{@options.to.surname}' <#{@options.to.email}>"
from: "'Myapp.com'"
subject: @options.subject
html: html
generateTextFromHTML: true
attachments: attachments
transport = @getTransport()
transport.sendMail messageData, callback

getTransport: ()->
emailer.createTransport "SMTP",
service: "Gmail"
auth:
user: "myappemail@gmail.com"
pass: "secretpass"

getHtml: (templateName, data)->
templatePath = "./views/emails/#{templateName}.html"
templateContent = fs.readFileSync(templatePath, encoding="utf8")
_.template templateContent, data, {interpolate: /\{\{(.+?)\}\}/g}

getAttachments: (html)->
attachments = []
for attachment in @attachments
attachments.push(attachment) if html.search("cid:#{attachment.cid}") > -1
attachments

exports = module.exports = Emailer
```
# /lib/emailer.coffee

emailer = require("nodemailer")
fs = require("fs")
_ = require("underscore")

class Emailer

options: {}

data: {}

# Define attachments here
attachments: [
fileName: "logo.png"
filePath: "./public/images/email/logo.png"
cid: "logo@myapp"
]

constructor: (@options, @data)->

send: (callback)->
html = @getHtml(@options.template, @data)
attachments = @getAttachments(html)
messageData =
to: "'#{@options.to.name} #{@options.to.surname}' <#{@options.to.email}>"
from: "'Myapp.com'"
subject: @options.subject
html: html
generateTextFromHTML: true
attachments: attachments
transport = @getTransport()
transport.sendMail messageData, callback

getTransport: ()->
emailer.createTransport "SMTP",
service: "Gmail"
auth:
user: "myappemail@gmail.com"
pass: "secretpass"

getHtml: (templateName, data)->
templatePath = "./views/emails/#{templateName}.html"
templateContent = fs.readFileSync(templatePath, encoding="utf8")
_.template templateContent, data, {interpolate: /\{\{(.+?)\}\}/g}

getAttachments: (html)->
attachments = []
for attachment in @attachments
attachments.push(attachment) if html.search("cid:#{attachment.cid}") > -1
attachments

exports = module.exports = Emailer


In a standard [ExpressJS][] project structure you'll store this file in `/lib/emailer.coffee`.
Expand All @@ -70,125 +68,117 @@ You'll need to have the email templates stored in `/views/emails/` as HTML files
A potential email view will look like this:


```html
<!-- invite.html -->
<html>
<head>
<title>Invite from Myapp</title>
</head>
<body>
<p>
Hi {{name}} {{surname}},
</p>
<p>
Myapp would like you to join it's network on <a href="http://myapp.com">Myapp.com</a>.
<br />
Please follow the link bellow to register:
</p>
<p>
<a href="http://myapp.com/register?invite={{id}}">http://myapp.com/register?invite={{id}}</a>
</p>
<p>
Thank you,
<br />
Myapp Team
</p>
<p>
<a href="http://myapp.com"><img src="cid:logo@myapp" /></a>
</p>
</body>
</html>
```
<!-- invite.html -->
<html>
<head>
<title>Invite from Myapp</title>
</head>
<body>
<p>
Hi {{name}} {{surname}},
</p>
<p>
Myapp would like you to join it's network on <a href="http://myapp.com">Myapp.com</a>.
<br />
Please follow the link bellow to register:
</p>
<p>
<a href="http://myapp.com/register?invite={{id}}">http://myapp.com/register?invite={{id}}</a>
</p>
<p>
Thank you,
<br />
Myapp Team
</p>
<p>
<a href="http://myapp.com"><img src="cid:logo@myapp" /></a>
</p>
</body>
</html>


[UnderscoreJS][] template will take care about your variables in the template and the `getAttachments()` function will automatically attache the files you need by the `cid` from the template.

To use the class in your code you have to instantiate a new Emailer object with the desired options, the template data and send the email:


```coffeescript
options =
to:
email: "username@domain.com"
name: "Rick"
surname: "Roll"
subject: "Invite from Myapp"
template: "invite"
options =
to:
email: "username@domain.com"
name: "Rick"
surname: "Roll"
subject: "Invite from Myapp"
template: "invite"

data =
name: "Rick"
surname "Roll"
id: "3434_invite_id"
data =
name: "Rick"
surname "Roll"
id: "3434_invite_id"

Emailer = require "../lib/emailer"
emailer = new Emailer options, data
emailer.send (err, result)->
if err
console.log err
```
Emailer = require "../lib/emailer"
emailer = new Emailer options, data
emailer.send (err, result)->
if err
console.log err


Using a [MongooseJS]: http://mongoosejs.com/ model for the invites you would have something like this:


```coffeescript
InviteSchema = new Schema
email:
type: String
name:
type: String
surname:
type: String
status:
type: String
enum: ["pending", "accepted"]
default: "pending"
clicks:
type: Number
default: 0
created_at:
type: Date
default: Date.now

InviteSchema.methods.send = ()->
options =
to:
email: @email
name: @name
surname: @surname
subject: "Invite from Myapp"
template: "invite"
Emailer = require "../lib/emailer"
emailer = new Emailer options, @
emailer.send (err, result)->
if err
console.log err

Invite = mongoose.model("Invite", InviteSchema)
exports = module.exports = Invite
```
InviteSchema = new Schema
email:
type: String
name:
type: String
surname:
type: String
status:
type: String
enum: ["pending", "accepted"]
default: "pending"
clicks:
type: Number
default: 0
created_at:
type: Date
default: Date.now

InviteSchema.methods.send = ()->
options =
to:
email: @email
name: @name
surname: @surname
subject: "Invite from Myapp"
template: "invite"
Emailer = require "../lib/emailer"
emailer = new Emailer options, @
emailer.send (err, result)->
if err
console.log err

Invite = mongoose.model("Invite", InviteSchema)
exports = module.exports = Invite


And you'll call it from an ExpressJS router:


```coffeescript
Invite = require('../models/invite')
Invite = require('../models/invite')

module.exports = (app)->
module.exports = (app)->

app.post '/invites', (req, res)->
data = req.body
invite = new Invite data
invite.save ()->
invite.send()
res.writeHead(303, {'Location': "/invites"})
res.end()
app.post '/invites', (req, res)->
data = req.body
invite = new Invite data
invite.save ()->
invite.send()
res.writeHead(303, {'Location': "/invites"})
res.end()

app.get '/invites', (req, res)->
Invite.find().desc("created_at").run (err, invites)->
res.render 'invites/invites', {title: "Invites", invites: invites}
```
app.get '/invites', (req, res)->
Invite.find().desc("created_at").run (err, invites)->
res.render 'invites/invites', {title: "Invites", invites: invites}


That's all about it.
Expand Down
5 changes: 5 additions & 0 deletions authors/Dumitru Glavan.markdown
View file
@@ -0,0 +1,5 @@
Github: doomhz
Email: me@dumitruglavan.com
Homepage: http://dumitruglavan.com
Twitter: doomhz
Location: Antwerpen, Belgium

0 comments on commit 6dd1a6c

Please sign in to comment.