Jump to main content Jump to doc navigation

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?

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