# SMAM (Send Me A Mail)
Always wanted to implement a contact form in your website and/or portfolio, but don't want to busy yourself with something too complex (mail sending in PHP, for example, is a complete mess)? Here's a miracle solution for ya! Just run the nodemailer-based app, include a JavaScript file in your HTML page, and you're all set :wink:
## Install and run
Just clone this repository, edit the `settings.json` file (described below) and run the server:
```
git clone https://github.com/babolivier/smam
cd smam
npm install
npm start
```
The default port will be set to `1970`, but you can set the one you want by using an environment variable:
```bash
PORT=8080 npm start
```
Same goes with the host. Without further instructions, the server will listen on `0.0.0.0`, which means it will accept every connection, whatever the source. You can override this by using the `HOST` environment variable:
```bash
HOST=127.0.0.1 npm start
```
So, if we want our server to only listen to requests from its host, on the 8080 port, we'll start the server like this:
```bash
HOST=127.0.0.1 PORT=8080 npm start
```
Obviously, you'll need Node.js and NPM (or any Node.js package manager) to run the app. As we're launching a webserver (which will serve the necessary files and process the mail sending requests), this app will run continuously. One good practice would be to run it as a daemon (in a systemd service, for example).
## Usage
First, include the script in your HTML page's header:
```html
...
...
```
Then, add an empty `
```
## Configuration
First, you must rename the `settings.example.conf` into `settings.conf`, and edit it. You'll find yourself in front of a file with this structure:
```json
{
"mailserver": {
"pool": true,
"host": "mail.example.tld",
"port": 465,
"secure": true,
"auth": {
"user": "noreply@noreply.tld",
"pass": "hackme"
}
},
"recipients": [
"you@example.tld",
"someone.else@example.com"
]
}
```
The `mailserver` section is the set of parameters which will be passed to nodemailer's transporter initialisation, describing the output mail server and following the same structure as the `option` object in [nodemailer's SMTP configuration section](https://github.com/nodemailer/nodemailer#set-up-smtp). Please head there to have the full list of parameters.
The `recipients` server is an array containing the e-mail addresses any message sent via the form will be sent to. Just write down the form's recipient(s)'s addresse(s).
## Templating
Each e-mail sent by the form follows a template described in `template.pug` (it's [Pug](pugjs.org/)). If you want to change the way the e-mails you receive are displayed in your mailbox, just edit it! You don't even need to restart the server aftewards :smile:
## Personnalising
As you might have already seen, the contact form is generated without any form of style except your browser's default one. But that doesn't meen that you have to add an ugly form to your site to receive contact e-mails, as every element has a specific id (beginning with the `form_` prefix), allowing you to use your own style on your contact form.
The generated form will look like this:
```html