FormSave
Last updated Nov 29th, 2019 | 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 moreFormSave is a hook for FormIt that allows you to save virtually any form to the database and export the results to CSV/XML/Print view right out of the box. You can also add your own export templates to make any export format possible.
FormSave is created and maintained by SCHERP Ontwikkeling.
Requirements¶
FormSave requires MODX® Revolution 2.2.0 or later.
History¶
Version | Release date | Author | Changes |
---|---|---|---|
1.0.1-PL1 | June 8th, 2012 | Patrick Nijkamp (SCHERP Ontwikkeling) | Added ability to delete form entries, fixed a bug. |
1.0.0-PL1 | April 24th, 2012 | Patrick Nijkamp (SCHERP Ontwikkeling) | Initial release. |
Download & Installation¶
Install the package through the MODX® package manager.
What you need to know¶
FormSave is a hook for FormIt, this means you need FormIt installed and you need to know how FormIt works. Check out the RTFM for FormIt if you don't know what FormIt is.
Using FormSave in the front-end¶
Using the snippet¶
As an example we'll use the call from FormIt's example contact page which looks like this:
[[!FormIt?
&hooks=`recaptcha,spam,email,redirect`
&emailTpl=`MyEmailChunk`
&emailTo=`user@example.com`
&redirectTo=`123`
&validate=`name:required,
email:email:required,
subject:required,
text:required:stripTags,
numbers:required,
colors:required`
]]
But now we want to save the form to the database to view the results later. To do this we simply add the hook and a parameter to the FormIt call:
[[!FormIt?
&hooks=`recaptcha,spam,FormSave,email,redirect` <-- added the hook here after spam and recaptcha check
&emailTpl=`MyEmailChunk`
&emailTo=`user@example.com`
&redirectTo=`123`
&fsFormTopic=`contact` <-- added the form topic to specify which form this is
&validate=`name:required,
email:email:required,
subject:required,
text:required:stripTags,
numbers:required,
colors:required`
]]
These are the parameters you can use in the FormIt call:
Parameter | Explanation |
---|---|
fsFormTopic | The topic for the form. Used to separate multiple forms. (Defaults to "form") |
fsFormFields | A comma separated list of fields to save, if omitted all form fields will be saved. (example: name,email,message) |
fsFormPublished | Whether or not the form should have published "1" in the database. Currently unused. |
External sources¶
Developers website: http://scherpontwikkeling.nl/modx/formsave
GitHub repository: http://www.github.com/b03tz/FormSave/
Report bugs and request features: http://www.github.com/b03tz/FormSave/issues