Create a ModX Revolution Form with built in jQuery validation in Moments
FormItBuilder deprecated
It is strongly recommended now using JsonFormBuilder instead of FormItBuilder. FormItBuilder is no longer being supported and is deprecated. It is fast to update your currecnt FormItBuilder forms to use JsonFormBuilder in most cases. Visit the upgrading from FormItBuilder tutorial for instructions.
Download FormItBuilder, the ModX Form Builder
| Current Version: | 1.3.3 pl |
| Last Updated: | 7th Aug, 2012 |
| Author: | Marcus House |
| Download: | FormItBuilder |
An e-form can be built dynamically and validated with the jQuery Validation plugin.
FormItBuilder is a small ModX Revolution framework to assist in quick development of FormIt forms and emails. Using a snippet (with some basic PHP commands) a complex form can be built much faster, and can automatically use the jQuery Validation plugin methods.
Need your web form in a database? Easy and fast with FormItBuilder.
As of version 0.1.8 you have the ability to map form fields to write to an xPDO table. Add with this the ability to quickly view the data in ModX Revolution using an extra like Rowboat.
Use PHP to drive it all via a single snippet, generating, validating, recording and sending the email.
FormItBuilders main purpose is to act as a wrapper to simplify much of the FormIt syntax and automatically build forms and email chunks dynamically without the need to duplicate HTML code and FormIt tags. If the output is not 100% appropriate for the job, FormItBuilder can output the raw form HTML to be used and modified as needed (like any FormIt form). Likewise email output can also be output in this same manner.
Read the documentation
To use FormItBuilder, follow the instructions and check out the example snippet. There will be much more functionality and help information to come.
Need Help?
Need a feature or form element that is not yet supported or documented?
Contact Support
News
7th Aug 2012
Released version 1.3.3pl with the following updates (3000 downloads and counting).
- Small bugfix in select form element compare code.
- Added hidden spans before/after each main element label for extra css flexibility.
- Added methods to set / get redirectParams for the redirect FormIt hook.
- Added $o_form->setSubmitVar('myCustomSubmitVar') to allow processing to be ignored or run only in certain conditions.
- Replaced all inbuilt FormIt post check calls (like FormItIsSelected, FormItIsChecked and any other +fi. placeholder). Replaced with own processing (faster).
- Added Matrix Element (with text, radio and checkbox types).
26th May 2012
Released version 1.3.2pl with the following updates.
- Added ability to supply "yyyy" in the FormRuleType::date to check a valid year
- Added a custom minimum length rule instead of using the FormIt one (FormIt would not allow and empty field that had a minimum length). Users frequently want a non required field with a minumum length.
- Added new FormItBuilder_elementDate element that allows date selection via a series of three dropdowns for date/month/year.
- Added ability to add extra classes onto the element wrapper using the setExtraClasses method. e.g. $o_fe_postcode->setExtraClasses(array('tiny','numeric'));
- Added and around all input elemetns to allow field prefixes and suffix labels such as a unit (meters, feet pints etc). Using the CSS command :after or :before allows text inside this spans that would normally be invisible. Could also use javascript to inject html into these areas as well.
- Added power user ability to assign custom variables into each element for retrieval in scripts. e.g. $o_fe_minLen->setCustomObject(array('asfsaf'=>'fdhdfh','dyhsg'=>32456));
- Fixed but in checkbox default (Setting default ticked to true did not work).
- In checkbox you can now supply a value such as "Checked", "Agree" as well as boolean true to have the checkbox checked by default. e.g. new FormItBuilder_elementCheckbox('agree_terms','I agree terms', 'Agree', 'Disagree', 'Agree');
- Now FormItBuilder will pass "0" as valid. Had to make an inbuilt custom validator for the required rule. This is because MANY people want "0" to pass validation. FormIT does not allow "0" to pass.
- Added the ability to output labels after the elements by using the new setLabelAfterElement(true) method on each element. Although CSS can position one in from of the other it can cause extra frustration when trying to align elements in a variety of ways. By setting this property to true you can force an element to output the label after the element.
- Made file field not output row in email table by default.
30th Apr 2012
FormItBuilder has just broken 2000 downloads. 1000 downloads in just over two months.
14th Apr 2012
A quick release that repairs a few fairly critical bugs with the HTML output of the checkbox group.
- Fixed checkbox group HTML output (missing open div tag, but was causing a lot of grief)
- Repair bug in FormRuleType::date causing issues with javascript validation. (Thanks for the report Kiel)
- Removed default "Created by FormItBuilder" form title attribute.
29th Mar 2012
A new update to FormItBuilder has just been released. A small update to add the hidden field element.
- Added new FormItBuilder_elementHidden element*
* Thanks for the suggestion Bimo
10th Mar 2012
A new update to FormItBuilder has just been released. This version is the first PL release and contains the following new updates
- Added new FormItBuilder_elementCheckboxGroup element*
- Added setDescription method on form element classes (Allows a sub label to be displayed within the main label )*
- Modified architecture of FormItBuilder_customValidation
- More code comments
* Thanks for the suggestions and assistance Michelle
25th Feb 2012
FormItBuilder has just broken 1000 downloads. There must be a number of people out there using it now. As always, feedback is appreciated. Just drop me a line in our contact us form.
7th Feb 2012
Quick update released today.
- Fixed a great number of trivial PHP errors in the ModX error log. (Thanks for the report Alex)
- Fixed some glitches in date custom validation
- Code comments
24th Jan 2012
New version released today.
A range of new updates has been added which allows more stylability due to extra class names on elements.
- Added element type class to element wrappers (for extra CSS flexibility)
- Add title attributes
- Added default value for text field.
- Fix single digit date issues with date field
- Added ability to output javascript into a placeholder with the setPlaceholderJavascript method.
- Added "store" FormIt config option.
- Added captcha support
- Fixed bug in non-required date fields (if date field was not required and empty an error message would be thrown).
- Fix some class orders that were having issues with some PHP installs.
23rd Nov 2011
New version released. After adding the new version there was quite a delay in the extra approval (about a week). You may have noticed the download option for FormItBuilder was not available until the 29th.
A range of new updates has been added
- Added emailFromName, emailToName, emailReplyToAddress, emailReplyToName, emailCCAddress, emailCCName, emailBCCAddress, emailBCCName
- Added ability to alter dynamic emailTpl
- Added file upload support*
- Added customValidators (see customValidators property for formIt)*
- Added validate (to allow extra validate options to be set)*.
* Thanks for the assistance Adam & Alex!
19th Oct 2011
A keen FormItBuilder user has assisted in reporting and debugging a few issues in relation to incorrect character escaping which was causing problems with multibyte characters and other special characters. Other small changes have been implemented also in response to user requests to output raw formIt syntax and email chunk output. A quick patch update to version 0.1.7-beta has just been released.
Keep those reports coming!
5th Oct 2011
The first beta version of FormItBuilder 0.1.5-beta released.