Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

SMTP Configuration

...

You can browse to SMTP transport module for Nodemailer documentation to make sure you use the right configuration.

Code Block
languagejs
titleSMTP transport Example
{
"from": "soajs@your.cloud.io",
  "transport": {
    "type": "smtp",
    "options": {
      "host": "smtp.mailgun.org",
      "port": 465,
      "auth": {
         "user": "soajs@your.cloud.io",
         "pass": "xxxxxx"
      }

   }

 }

Email Content Configuration

...

Variables used:

...

You have full control over the content of the email that SOAJS URAC send. below is an example on how to configure the links and the email contents.

Code Block
languagejs
titleURAC mail configuration
{
  "link": {
    "join": "https://dev-site.rockspoon.io/#/join/validate",
    "forgotPassword": "https://dev-site.rockspoon.io/#/resetPassword",
	....
  },
  "mail": {
    "join": {
      "subject": "Welcome to SOAJS",
      "path": "/opt/soajs/node_modules/soajs.urac/mail/urac/join.tmpl"
    },
    "forgotPassword": {
      "subject": "Reset Your Password at SOAJS",
      "content": "<p>Dear <b>{{ username }}</b>, <br />Your account status has changed to <b>{{ status }}</b> by the administrator on {{ ts|date('F jS, Y') }}.<br /><br /> Regards,<br/> SOAJS Team. </p>"
    },
	....
  }
}

What data is available for you to be used in the email content

  1. The entire user record. For more information go here User Model
  2. The following extra variable in addition to the user record are also available:
    1. limit: expiry of the link in hours.
    Links:
    1. link: The link with the token. Check the section below with an example about
    links.
    1. link.
    2. ts: the timestamp, if you want to highlight the date and time

Example

Custom Content of mail. As a template engine soajs is using https://handlebarsjs.com

Code Block
languagexml
titleMail ContentReset password
"<p>Dear <b>{{username}}</b>, <br />You have requested to reset your password.
<br />Please click the following link to proceed: <a href='{{link.forgotPassword}}'>{{link.forgotPassword}}</a>.
<br />Please note that the above link will expire in {{limit}} hours.<br /><br />Regards,<br/>SOAJS Team.</p>"

Links

...


jslink: { addUser: 'http://dashboard.soajs.org:80/#/setNewPassword', changeEmail: 'http://dashboard.soajs.org:80/#/changeEmail/validate', forgotPassword: 'http://dashboard.soajs.org:80/#/resetPassword', join: 'http://dashboard.soajs.org:80/#/join/validate' },
Code Block
language
titleLink Example
Add user
<p>Dear <b>{{firstName}} {{lastName}}</b>, <br />
SOAJS administrator has created an account for you on {{ts}}<br />
{{#if link.addUser}}
Please click the following link to set a password to your account: <a href='{{link.addUser}}'>{{link.addUser}}</a>.<br /><br />
{{^}}
The administrator set as password the following: {{password}}<br /><br />
{{/if}}
Please note you can change your username and/or password in the 'My Account' section after you login.<br /><br />
Regards,<br/>
SOAJS Team.
</p>