email-builder-core-min v0.0.2
email-builder-core-min
Email builder core for export into other projects.
This is a forked version of email-builder-core (https://github.com/Email-builder/email-builder-core) with some updates to it and one less perk.
This version does not include the litmus api, and has been updated to use Gulp 4.
Constructor
new EmailBuilder(options)
Example:
const EmailBuilder = require('email-builder-core-min');
const emailBuilder = new EmailBuilder({ encodeSpecialChars: true });
Options
The following options may support all available methods of EmailBuilder. However there some that are only needed for a particular method.
options.encodeSpecialChars
Type: Boolean
Default: false
Supported Method(s): All
Encodes special characters to their HTML numerical form e.g. © --> ©
options.relativePath
Type: String
Default: ''
Supported Method(s): emailBuilder.inlineCss
This option must be set when passing a Buffer or a String to the inlineCss
method. That way it has a relative path to any css files. The path should be whatever directory your src file is in.
options.emailTest
Type: Object
Default: {}
Properties: to
, from
, subject
, nodemailer
Supported Method(s): emailBuilder.sendEmailTest
The optional nodemailer
property is an object that has transporter
and defaults
properties. These get passed to the nodemailer.createTransport() method. You can use transport plugins or play with the default SMTP options for the nodemailer.transporter
property
Example:
emailTest : {
// Email to send to
to : 'toEmail@email.com',
// Email sent from
from: 'fromEmail@email.com',
// Your email Subject
subject : 'Email Subject',
// Optional
nodemailer: {
transporter: {
service: 'gmail',
auth: {
user: 'gmailuser',
pass: 'gmailpass'
}
},
defaults: {}
}
}
options.juice
Type: Object
Default: {}
Supported Properties: extraCss
, applyWidthAttributes
, applyAttributesTableElements
Supported Method(s): emailBuilder.inlineCss
View Juice options
options.cheerio
Type: Object
Default: {}
View Cheerio options.
Methods
All methods return a promise, the underlying promise library we use is Bluebird.
Methods can be used seperately, or chained together using the .then
method.
If you're not familiar with promises, instead of using a callback, you chain a .then
method to get the results.
emailBuilder.inlineCss(file/html/buffer)
Inlines css from embedded or external styles. It'll automatically remove any link or style tags unless one of the data attributes below are used.
Arguments
file
- String containing path to file
string
- String of HTML
buffer
- Buffer of HTML
HTML data attributes There are two supported data attributes that you can apply to \<style> or \<link> tags that have special meaning:
data-embed
- use on \<style> or \<link> tags if you want styles to be embedded in the \<head> of the final output. Does not inline css
data-embed-ignore
- use on \<link> tags to preserve them in the \<head>. Does not inline or embed css
Example:
emailBuilder.inlineCss('path/to/file.html')
.then(html => {
console.log(html);
});
emailBuilder.sendEmailTest(html)
Send email tests to yourself
Arguments
html
- String/Buffer of HTML
Example:
const fs = require('fs');
const file = fs.readFileSync('path/to/file.html');
emailBuilder.sendEmailTest(file)
.then(html => {
console.log(html);
});
Complete Example
input.html
<!DOCTYPE html>
<html>
<head>
<!-- styles will be inlined -->
<link rel="stylesheet" type="text/css" href="../css/styles.css">
<!-- styles will be embedded -->
<link rel="stylesheet" type="text/css" href="../css/otherStyles.css" data-embed>
<!-- link tag will be preserved and styles will not be inlined or embedded -->
<link href='http://fonts.googleapis.com/css?family=Open+Sans' rel='stylesheet' type='text/css' data-embed-ignore>
<!-- styles will be inlined -->
<style>
p { color: red; }
</style>
<!-- styles will be embedded -->
<style data-embed>
h1 { color: black; }
</style>
</head>
<body>
<h1>Heading</h1>
<p>Body</p>
</body>
</html>
main.js
const fs = require('fs');
const EmailBuilder = require('email-builder-core-min');
const options = {
encodeSpecialChars: true,
emailTest: {...}
};
const emailBuilder = new EmailBuilder(options);
const src = process.cwd() + '/input.html';
emailBuilder.inlineCss(src)
.then(emailBuilder.sendEmailTest)
.then(html => {
// can write files here
fs.writeFileSync(process.cwd() + '/out.html', html);
})
catch(err => {
console.log(err);
});
out.html
<!DOCTYPE html>
<html>
<head>
<link href='http://fonts.googleapis.com/css?family=Open+Sans' rel='stylesheet' type='text/css'>
<style>
h1 { color: black; }
</style>
</head>
<body>
<h1>Heading</h1>
<p style="color: red">Body</p>
</body>
</html>
Testing
gulp test
- Runs jshint and mocha tests
gulp inline
- Inlines css from test/fixtures/input directory and creates the test/fixtures/output directory. Run if you add/update any fixtures in the test/fixtures/input directory.
Thanks to
The original Email Builder Core Team:
Jeremy Peter (https://github.com/jeremypeter)
Steve Miller (http://www.stevenjohnmiller.com.au)
Juice for compiling.