## Sending e-mail

Form controller allows to send form data via e-mail.

## Mailer parameters
### parseMailerParams
Allows to use form data in mail sending parameters  (&to=\`[+user.email.value+]\` etc.).

Possible values - 1, 0.

Default value - 0.

### isHtml
Allows to send e-mail in html format.

Possible values - 1, 0.

Default value - 1.

### to
Receiver's address. If it's not set then the mail is not sent, but form procession is finished successfully.

Possible values - e-mail address.

Default value - none.

### from
Sender's address.

Possible values - e-mail address.

Default value - the "emailsender" configuration parameter value.

### fromName
Sender's name.

Possible values - string.

Default value - the "site_name" configuration parameter value.

### replyTo
ReplyTo header.

Possible values - e-mail address.

Default value - none.

### cc
Cс header.

Possible values - e-mail address.

Default value - none.

### bcc
Bcc header.

Possible values - e-mail address.

Default value - none.

### noemail
If it's set, then the mail isn't sent, but supposed to be sent successfully.

Possible values - 1, 0.

Default value - 0.

### ignoreMailerResult
If it's set, the mail is sent and supposed to be sent successfully. 

Possible values - 1, 0.

Default value - 0.

### subject, ccSubject, autoSubject
Letter subject.

Possible values - string.

Default value - none.

### subjectTpl, ccSubjectTpl, autoSubjectTpl 
Letter subject template.

Possible values - template name, according to DocLister templating rules.

Default value - the "subject" parameter value ("ccSubject", "autoSubject").

### autosender
Address to send additional letter.

Possible values - e-mail address.

Default value - none.

### autosenderFromName
The name of the additional letter sender.

Possible values - string.

Default value - the "site_name" configuration parameter value.

### ccSender
If it's set then the receiver's address is defined by the value of form field.

Possible values - 1, 0.

Default value - 0.

### ccSenderField
Field name containing e-mail address.

Possible values - field name.

Default value - email.

### ccSenderFromName
Sender's name for the mail sent to the form field defined address.

Possible values - string.

Default value - none.

## ccMailConfig
Allows to redefine mail sending parameters for the letters to the address taken from the form field ((isHtml, from, fromName, subject, replyTo, cc, bcc, noemail)).

Possible values - json or php array.
 
Default value - none.

## autoMailConfig
Allows to redefine mail sending parameters for the additional letters (isHtml, from, fromName, subject, replyTo, cc, bcc, noemail). 

Possible values - json or php array.
 
Default value - none.

## Submit protection
### protectSubmit
Prevents submission of the form with the same data again.

Possible values - 1, 0 or fields list to check if the form is unique. Required fields are used by default.

Default value - 1.

### submitLimit
Prevents sending mail too often.

Possible values - number of seconds between form submits.

Default value - 60.

## Templates
### reportTpl
The main template of the letter.

Possible values - template name, according to DocLister templating rules.

Default value - the list of fields and their values.

### automessageTpl
Template of the additional letter.

Possible values - template name, according to DocLister templating rules.

Default value - none.

### ccSenderTpl
Template of the letter sent to the user defined address.

Possible values - template name, according to DocLister templating rules.

Default value - none.

### successTpl
Success message template.

Possible values - template name, according to DocLister templating rules.

Default value - none.

## Sending files
### attachments
Field names to store files. Single file fields (name="field" type="file") and multiple file fields as simple arrays (name="field[]" type="file" multiple) are supported. 

Default value - none.

### attachFiles
Allows to send any files. 

Possible values - array:
```
&attachFiles=`{
"field ":{
    "filepath":"assets/images/logo.png",
    "filename":"logo.png"
},
"field 2":[
    {
    "filepath":"assets/images/file1.jpg",
    "filename":"report.jpg"
    },
    {
    "filepath":"assets/images/file2.jpg",
    "filename":"report2.jpg"
    }
]
}`
```
### deleteAttachments
Allows to delete attachment files if the mail is sent successfully.

Possible values - 0 or 1.

Default value - 0.

### fileValidator
Class name to validate files. This class has to be loaded before snippet call.

Default value - \FormLister\FileValidator

### fileRules
Validation rules (see "Data validation" chapter). Default validator has the following rules:

- required: files are loaded successfully;
- optional: returns true even if files were not submitted (it makes file field not required);
- allowed: file extension is in defined array;
- images: file extension is jpg, jpeg, gif, png, bmp;
- minSize: file size in kilobytes is greater than defined;
- maxSize: file size in kilobytes is less than defined;
- sizeBetween: file size in kilobytes is in the range;
- minCount: files count is greater than defined;
- maxCount: files count is less than defined;
- countBetween: files count is in the range;

There's no sense to use the "!field name" construction in file validation rules,  because the value of the file field can not be empty, so use the "optional" rule instead.

There's the [+attachments.value+] placeholder available in reportTpl template, it contains the list of attached files. To output particular file field use the [+field name.value+] placeholder. Files are sent only in letters with reportTpl template.
