Define an email address where forms will be sent to.
| caption | Email address recipient |
| name | fb_email_to |
| description | Submitted forms will be sent to this address. If this field is empty, the form will be sent to the default email address of the website (which can be found under Extras > Configuration). |
| category | Settings - Email |
| sortOrder | 1 |
| type |
Define a BCC address where forms will also be sent to.
Tip: this can be convenient for linking your form to an automated service like Zapier.
| caption | Email BCC address |
| name | fb_email_bcc |
| description | Optional. |
| category | Settings - Email |
| sortOrder | 3 |
| type |
It will appear as if the form was sent from this email address.
| caption | Email FROM address |
| name | fb_email_from |
| description | Optional. Defaults to emailsender system setting. |
| category | Settings - Email |
| sortOrder | 5 |
| type |
It will appear as if the form was sent by this person or organization.
| caption | Email FROM name |
| name | fb_email_from_name |
| description | Optional. Defaults to site_name system setting. |
| category | Settings - Email |
| sortOrder | 6 |
| type | text |
Allows you to link to a specific redirect page.
| caption | Redirect page |
| name | fb_redirect_id |
| description | Enter the ID of the page, or drag the page from the menu tree to this input field. |
| category | Settings - General |
| sortOrder | 90 |
| type | number |
Allows you to change the default text inside the submit button of each form.
| caption | Text in submit button |
| name | fb_submit_button |
| description | Defaults to Send. |
| category | Settings - General |
| sortOrder | 92 |
| type | text |
Allows you to change the appearance of a form by selecting the position of the labels.
| caption | Layout type |
| name | fb_form_layout |
| description | Stacked means the labels are always above the input fields, Horizontal means the labels are next to the fields, Inline means everything is on 1 row (so only for very small forms). |
| category | Settings - General |
| sortOrder | 5 |
| type | listbox |
| inputOptionValues | Stacked==vertical||Horizontal==horizontal||Inline==inline |
| defaultValue | horizontal |
Assigned to the following templates
With this TV you can override the default fb_email_to field by a dynamically generated email address. This can be done by placing a custom snippet call inside the textarea of this TV. You can use any snippet you like, as long as it returns a valid email address (or comma separated list of addresses).
As an example, consider the following scenario:
You're building a website for an organization with several departments. Each department wants to have its own page on the site, with the option to contact that department directly through a web form. The form can be the same for all departments, but they want to have it sent to a different person in each case.
At this point you might think: let's just create a TV and attach it to template that all departments pages use. Then simply retrieve the value of this TV inside the fb_email_to field, instead of entering a real email address there. Unfortunately this won't work, because:
- The fb_email_to field is expecting an email address, meaning a string containing an @
- The form is coming from a different resource, meaning its content is already rendered when being loaded on the page
This is where the fb_email_to_dynamic field comes in. We can fetch the TV containing the email address of the department by sending out a snippet to go look for it. As you can see under Specifications, we can use the current_id placeholder to look inside the resource containing the form. The snippet call could be something like this (using the fastField shorthand syntax of pdoParser):
[[#[[+current_id]].tv.department_email]]Example
Now the same form can be used on multiple different pages, with a unique email_to address for every page.
| caption | Dynamic recipient address |
| name | fb_email_to_dynamic |
| description | You can place any snippet / FastField call here that outputs a single email address. Retrieve something inside a resource by using the [[+current_id]] placeholder. WARNING: populating this field will override the default recipient address, so test thoroughly! |
| category | Settings - Advanced |
| sortOrder | 1 |
| type | textarea |
Enables you to use your own email template.
| caption | Email template |
| name | fb_email_template |
| description | Optional. Name of the chunk containing your own customized (HTML) email template. Make sure there is a [[+content]] placeholder in there for listing the fields. |
| category | Settings - Advanced |
| sortOrder | 20 |
| type | text |
Define rows for your custom email template.
| caption | Email template rows |
| name | fb_email_template_rows |
| description | Optional. Name of the chunk containing the customized HTML for the template rows. This will be used to display each individual field in your email. Use [[+label]] and [[+value]] placeholders to show the content. |
| category | Settings - Advanced |
| sortOrder | 21 |
| type | text |