❤
npm
Sign UpSign In

gulp-email-builder

3.0.0 • Public • Published

gulp-email-builder

Join the chat at https://gitter.im/Email-builder/gulp-email-builder Build Status

Uses Email Builder to inline css into HTML tags, send tests to Litmus, and send test emails to yourself.

Example:

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

You can see an example setups below

Getting Started

Install this gulp plugin next to your project's gulpfile with: npm install gulp-email-builder

Then add this line to your project's gulp.js gulp:

var emailBuilder = require('gulp-email-builder');

Documentation

Place this in your gulp file.

  gulp.task('emailBuilder', function() {
    return gulp.src(['./example/html/*.html'])
      .pipe(emailBuilder(options).build())
      .pipe(gulp.dest('./example/dist/'));
  });

Other available methods

Besides the main emailBuilder(options).build() function, the email-builder-core methods are exposed so users can use them on an individual basis.

  • emailBuilder(options).inlineCss()
  • emailBuilder(options).sendEmailTest()
  • emailBuilder(options).sendLitmusTest()

Example

...
.pipe(emailBuilder(options).sendEmailTest())
...

Options

View Email Builder options for all available options.

Complete Example

var EmailBuilder = require('gulp-email-builder');
 
var options = { encodeSpecialChars: true }
var builder = EmailBuilder(options);
 
gulp.task('emailBuilder', function() {
  return gulp.src(['./example/html/*.html'])
    .pipe(builder.build())
    .pipe(gulp.dest('./example/dist/'));
});
 

Troubleshooting

If you're having issues with Litmus taking forever to load a test or the title of the test is showing up as "No Subject", it is most likely an issue with the Litmus API. You can check the Litmus status page to find out if they're having any issues. If that's not the case, submit an issue and we'll look into further.

Contributors

Thanks to all contributors for helping out.

Further Reading

Release History

License

MIT

Versions

Current Tags

  • Version
    Downloads (Last 7 Days)
    • Tag
  • 3.0.0
    86
    • latest

Version History

Package Sidebar

Install

npm i gulp-email-builder

Repository

github.com/Email-builder/gulp-email-builder

Homepage

github.com/Email-builder/gulp-email-builder

Weekly Downloads

94

Version

3.0.0

License

MIT

Last publish

Collaborators

  • jeremypeter
  • yargalot
Try on RunKit
Report malware