Mail Sending
Form controller allows to send form data via e-mail.
Mailer parameters
Property | Description |
---|---|
parseMailerParams | Allows to use form data in mail sending parameters 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 Possible values - json or php array. Default value - none. |
autoMailConfig | Allows to redefine mail sending parameters for the additional letters Possible values - json or php array. Default value - none. |
Submit protection
Property | Description |
---|---|
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
Property | Description |
---|---|
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
Property | Description |
---|---|
attachments | Field names to store files. Single file fields 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:
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 |
Suggest an edit to this page.