Skip to content

Latest commit

 

History

History
236 lines (167 loc) · 5.13 KB

README.md

File metadata and controls

236 lines (167 loc) · 5.13 KB
Raw

NodeJS SendMail

A NodeJS SendMail component used for sending mails using Amazon SES and normal mail service.

Table of contents

Getting started

Install the npm package:

npm install nodejs-weblineindia-sendmail
#OR
yarn add nodejs-weblineindia-sendmail

Features

  • This component is used to send mails.
  • Provides email templates for attachment and activating account.
  • Also supports AWS send mail service and normal mail service.

Usage

Use EmailService function to send email: It is an asynchronous function.

const sendmail = require('nodejs-weblineindia-sendmail')
OR
import sendmail from 'nodejs-weblineindia-sendmail'

use of EmailService function

async function mailsend() {
    let result = await sendmail.EmailService({
        emailInfo: {
            service: 'normal',
            fromEmail: 'frommail@abc.com',
            toEmail: 'tomail@abc.com',
            username: 'username',
            hostname: 'hostsite'
        },
        auth: {
            host: 'smtp.abc.com',
            port: 587,
            user: 'user',
            pass: 'password'
        },
        template: 'activateAccount'
        attachment: [{ // utf-8 string as an attachment
            filename: 'photo.png',
            path: path.resolve(__dirname, 'photo.png')
        }]
    })
}

// call mailsend() function
mailsend()

Mail Options

emailInfo :

  • service

    This has following option :

    • 'aws' : Using AWS service
    • 'normal' : Using basic mail service

  • fromEmail

    Email address of that user who is sending mail.

  • toEmail

    Email address of that user who is receiver for that mail.

  • username

    optional field.Name of user to show in mail.

  • hostname

    optional field.Host for link generation.

auth :

  • host

    Hostname of service provider.

  • port

    Port number.

  • secure

    true or false value.

  • user

    username.

  • pass

    password.

template :

This field provides option to choose mail template. It has two following templates:

    - activateAccount
    - attachment

attachment :

This is optional field. It contains an array of attachment objects.

Examples

Activate Account with link generation

async function mailsend() {
    let result = await sendmail.EmailService({
        emailInfo: {
            service: 'normal',
            fromEmail: 'abc@xyx.com',
            toEmail: 'tomail@getairmail.com',
            username: 'user',
            hostname: 'http://host/'
        },
        auth: {
            host: 'smtp.gmail.com',
            port: 587,
            user: 'abcd@user.com',
            pass: 'password'
        },
        template: 'activateAccount'
    })
}
// call mailsend() function
mailsend()

Attachment

async function mailsend() {
    let result = await sendmail.EmailService({
        emailInfo: {
            service: 'normal',
            fromEmail: 'abc@xyx.com',
            toEmail: 'tomail@getairmail.com'
        },
        auth: {
            host: 'smtp.gmail.com',
            port: 587,
            user: 'abcd@user.com',
            pass: 'password'
        },
        template: 'attachment',
        attachment: [{
            // utf-8 string as an attachment
            filename: 'image.png',
            path: path.resolve(__dirname, 'image.png')
        }]
    })
}
// call mailsend() function
mailsend()

Want to Contribute?

  • Created something awesome, made this code better, added some functionality, or whatever (this is the hardest part).
  • Fork it.
  • Create new branch to contribute your changes.
  • Commit all your changes to your branch.
  • Submit a pull request.

Need Help?

We also provide a free, basic support for all users who want to use this NodeJS SendMail component in their software project. In case you want to customize this SendMail component to suit your development needs, then feel free to contact our NodeJS developers.

Collection of Components

We have built many other components and free resources for software development in various programming languages. Kindly click here to view our Free Resources for Software Development.

Changelog

Detailed changes for each release are documented in CHANGELOG.md.

Credits

nodejs-weblineindia-sendmail is inspired by nodemailer.

License

MIT

Keywords

nodejs-weblineindia-sendmail, nodejs-sendmail, nodejs, node-component, nodecomponent, node