mxFormBuilder
Last updated Dec 10th, 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 morePurpose¶
The goal with mxFormBuilder to to provide a consolidated and easy to user interface to manage all aspects for forms in your ModX site. Additional focus was to have built in protection for common security threats associated with forms.
Getting Started¶
Installation¶
The first thing you need to do is install the component if you have not already completed this. In the Manager for the site you want to install mxFormBuilder on from the top menu select "System" -> "Package Management". Once the Package Management page loads click on the "Download Extras" button. Now that we have the package browser panel loaded lets enter the search term "mxFormBuilder" in the search box on the left side of the window. Once you find the package listed as mxFormBuilder select "Download". When that completes you can now click on the the "Back to Package Management" button above the grid list. This will now allow us to select the "Install" button next to our local package list of mxFormBuilder.
Properties¶
To customize your display and settings you can use the properties below. Its recommended that you create a property set globally for your site, which allows you to quickly change properties without having to type the same ones in each time.
Name | Type | Options | Default | Description |
---|---|---|---|---|
formid | int | null | The form id that you want to display for end user input. The form id is found on the mxFormBuilder grid next to the form name inside the standard snippet sample block. | |
context | string | null | Specify a specific context to filter the form rendering for context. | |
tvOwners | string | |||
emailOwners | string (comma delimeted) | null | Enter a comma-seperated list of email address that you'd like the success submission notification sent to. This is the same email that the form owner(s) recieve on submission if specified on the form. | |
subjectOwners | string | null | Create a specific title for the email subject when sent to email owners. The default subject is a combination of a lexicon entry and the name of the form. | |
emailNotifications | ||||
hooks | string (comma delimeted) | null | Calls system snippets after a successful submission. Allows you to extend logic beyond the built-in email and database options. You can use this for things like extending to a third party CRM. The snippets called will have full access to all submitted data for further parsing in hook snippet. | |
preHooks | string (comma delimeted) | null | Calls system snippets prior to form rendering. This allows you to modify form fields and options prior to the form rendering. Example use could be to append specific data to a form without requiring user input. Another example could be to change the rendered form output from an input field to selectlist. | |
disablecss | ||||
disablejs | ||||
onsuccess | ||||
disableToken | ||||
TEMPLATES | ||||
itemTpl | ||||
wrapperTpl | ||||
successTpl | ||||
errorTpl | ||||
errorMessage | ||||
emailOwnerTpl | ||||
emailUserTpl | ||||
debug |