FormIt
Last updated Mar 11th, 2021 | Page history | Improve this page | Report an issue
Support the team building MODX with a monthly donation.
The budget raised through OpenCollective is transparent, including payouts, and any contributor can apply to be paid for their work on MODX.
Backers
Budget
$301 per month—let's make that $500!
Learn moreFormIt Hooks¶
New in version 1.1 are two hooks for FormIt. If you use FormIt to make your forms you can now take advantage of both Eletters and FormIt. FormIt allows you to make easy forms and the build in email hook works but now you can set up an email as a Resource/Document and then log and provide the recipient a link to view the web version. Future versions will have an easy review log in the MODX Manager.
EletterFormItEmail replaces the default FormIt Email hook¶
The EletterFormItEmail hook, which is just a snippet, aims to be a drop in replacement for the FormIt Email hook.
Available Properties¶
Name | Description |
---|---|
emailNewsletterID | (Int) use the newsletter ID to identify the newsletter |
emailResourceID | (Int) Optional instead of using the emailNewsletterID use the standard resource ID to identify the newsletter resource |
emailUseChunk | Boolean, default false - on true it will use the standard chunk rather then the newsletter resource |
emailUploads | Boolean, default true - on true will send uploads via email |
emailFiles | Boolean, default true - on true will send any files attachments that a newsletter resource may have, these would be added via the Manager TVs |
emailLog | Boolean, default true - on true will save output email content to database and allow a you to create a link to View as Webpage. Will also log any error if email is not delivered. |
See the FormIt Email documentation for additional available properties: FormIt email Hook
Example¶
- After your form is created you will need to create a new Resource and put in placeholders that would match the FormIt form. The Resource needs to have the Eletter TVs, be published and send a test.
- Then put in the ID of the Resource as the value for the emailResourceID in the FormIt Snippet call.
The following will send out an email of the Resource #10 after the form validated.
[[!FormIt?
&submitVar=`submit`
&validationErrorMessage=`<h3>Please fill in all fields</h3>`
&validate=`email:email:required,question:required`
&hooks=`eletterFormItEmail`
&emailSubject=`Question`
&emailTo=`email@email.com`
&emailResourceID=`10`
]]