# Email settings

The API sends a few type of e-mails.

## Confirmation after submitting an Idea or Article

After submitting an idea or an article an automatic *Thank you e-mail* is send to the user that submitted it.

By default this is a generic e-mail template. This can be customised per site in the config field of the Site model.

```
{
  "config": {
    "cms": {
      "url": "URL VAN DE WEBSITE"
    },
    "ideas": {
      "feedbackEmail": {
        "from": "NAAM <EMAIL@ADDRESS>",
        "subject": "ONDERWERP",
        "inzendingPath": "/PATH/NAAR/INGEDIEND/PLAN/[[ideaId]]",
        "template": "Beste {{user.fullName | default('indiener')}},<br/><br/>Bedankt voor je <a href=\"{{inzendingURL}}\">inzending</a>.<br/><br/>Groeten van het Project Team"
      }
    }
  }
}
```

Template uses the nunjucks templating engine, the following variables are available in the template:

* **user**: user object that created the Idea (see rest API for properties)
* **idea**: newly created Idea object (see rest API for properties)
* **HOSTNAME**: Hostname url of the site, same as site.config.cms.hostname
* **SITENAME**: Name of the site, same as site.title
* **URL**: URL of the site, sames as site.config.cms.url,
* **EMAIL**: from adres (email only),
* **inzendingURL**: The url leading to the path, warning path should be set correctly in the config since CMS can change the page: site.config.cms.url + site.config.ideas.feedbackEmail.inzendingPath.replace(/\[\[ideaId]]/, idea.id),

## Notifications to Moderators

Notifications can be send to moderators to let them know if ideas and arguments have been created or edited on their site.

The e-mail template is also configurable per site:

```
{
  "config": {
    "notifications": {
      "from": "NAAM <EMAIL@ADDRESS>",
      "to": "NAAM <EMAIL@ADDRESS>",
      "inzendingPath": "/PATH/NAAR/INGEDIEND/PLAN/[[ideaId]]",
      "template": "<div data-gb-custom-block data-tag="if"><div data-gb-custom-block data-tag="for">{{idea.title}}</div></div><div data-gb-custom-block data-tag="if"><div data-gb-custom-block data-tag="for">{{arg.description | nl2br | safe}}</div></div>",
        "attachments": [{ filename: "FILENAME1", "cid": "CID1" }, { filename: "FILENAME2", "cid": "CID2" }]
    }
  }
}
```

The notifications are bundles and send periodically so arguments and ideas are an array.

Template uses the nunjucks templating engine, the following variables are available in the template.

* **data.idea**: an array van idea objecten, met de user included, en een
* **inzendingURL** per idea
* **data.argument**: een array van argument objecten, met de user en idea included
* **HOSTNAME**: Hostname url of the site, same as site.config.cms.hostname
* **SITENAME**: Name of the site, same as site.title
* **URL**: URL of the site, sames as site.config.cms.url