sekFormTools

Last updated Oct 27th, 2020 | 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

$306 per month—let's make that $500!

Learn more

What is sekFormTools?¶

SekFormTools is a quick way to add combo boxes with a customized appearance, auto-complete text fields, date pickers, and input fields with prompts to your form. Grab data from any table object and display in a combo box or filter through an auto-complete field with no snippet or chunk modification, just a simple json array of data. Methods have been built in to filter a combo box based on the selection of another combo box. Have text input or text area fields with a prompt overlaying the field. Add a date picker to the form with an easy to use snippet call.

Requirements¶

MODX Revolution 2.2.0-pl2 or later
PHP5 or later

History¶

SekFormTools was written by Stephen Smith, and first released on May 3th, 2012.

Download¶

It can be downloaded from within the MODX Revolution manager via Package Management, or from the MODX Extras Repository, here: https://modx.com/extras/package/sekformtools.

Development and Bug Reporting¶

SekFormTools is on GitHub: https://github.com/insomnix/sekFormTools, report any issues or feature requests here: https://github.com/insomnix/sekFormTools/issues.

Data¶

SekFormTools will install 5 tables, a country, state, US cities, US zipcodes, and a US city zip cross reference. Because of the size of the data files and number of records, the data for these tables are optionally downloaded and installed. If you wish to install this data, download sekformtoolsdata.zip, copy/paste each file into a temporary snippet, and run the snippet to install the data to the database. If anyone wishes to contribute to the these files, please contact me or post to the current support thread.

Usage¶

The sekFormTools is called through several snippets using the below tags?

sekFormTools.input.autocomplete - A jquery auto-complete field.
sekFormTools.input.combobox - A jquery auto-complete combo box.
sekFormTools.input.datepicker - A jquery date picker field.
sekFormTools.input.textfield - A jquery text field with suggestion overlay.
sekFormTools.input.helper - Called from a blank page, used to fill auto-complete and combo boxes from a database.
spellchecker - Call the [[spellchecker]] snippet from anywhere on a page will load spelling and grammar checking on every textarea.

For more complex setups, try Advanced Examples.

Available Settings¶

Name	Description	Default	Version
sekformtools.load_jquery	This will enable or disable JQuery from being loaded when sekFormTools is called on a page. If JQuery is being loaded from another extra used on the same pages as sekFormTools, or it is loaded in a template, this setting should be set to No/False.	Yes/True	>0.0.1
sekformtools.customcss	Location of the css file in relation to the modx assets folder.		>0.0.1
sekformtools.theme	The theme to use for the form fields.	smoothness	>0.0.1
sekformtools.helper_resource_id	The id of the page making the jquery calls.This only needs to be set if you plan to use the autocomplete snippet or filter a combobox,		>0.0.1

Themes¶

SekFormTools comes with 8 themes. Additional themes can be downloaded from the jquery.ui website and placed in the css folder.

Theme Name	Version
blitzer	>0.0.1
eggplant	>0.0.1
flick	>0.0.1
overcast	>0.0.1
pepper-grinder	>0.0.1
redmond	>0.0.1
smoothness	>0.0.1
ui-lightness	>0.0.1
humanity	>0.0.5