/* $Id: README.txt,v 1.2 2008/02/29 03:30:53 sun Exp $ */

-- SUMMARY --

Form controller closes a gap in Drupal's module framework.  While we have CCK
and Views for contents, Blocks and Panels for regions, and similarly
configurable solutions for other things, we haven't had a module to configure
and control forms.

The primary purpose of this module was to have a "Form Spy"-alike helper that
aids in retrieving and selecting form ids for modules like Journal [1],
#translatable [2], Fivestar [3], Compact forms [4], aso.  However, it quickly
turned out that Form controller is basically able to be a general purpose helper
for most modules that implement hook_form_alter().

For this reason, Form controller does (almost) nothing on its own.  It allows
other modules to implement hook_form_controller() to allow administrative users
to define settings for any FAPI-based form in Drupal.  Form controller loads
those settings and returns the form values back to the hook_form_controller()
implementation (for now, that is).  Modules can use this valuable information to
alter/don't alter a form, or for whatever they like.

Form controller is very lightweight.  Admittedly, the included JavaScript needs
some love from a jQuery guru, however, it works for now.


For a full description visit the project page:
  http://drupal.org/project/form_controller
Bug reports, feature suggestions and latest developments:
  http://drupal.org/project/issues/form_controller


[1] http://drupal.org/project/journal
[2] http://drupal.org/project/translatable
[3] http://drupal.org/project/fivestar
[4] http://drupal.org/project/compact_forms


-- REQUIREMENTS --

* jQuery Update (http://drupal.org/project/jquery_update)
  and optionally, cutting edge jQuery 1.2+.


-- INSTALLATION --

* Install as usual, see http://drupal.org/node/70151 for further information.

* Enable the module in administer >> Modules.


-- CONFIGURATION --

* Configure user permissions in administer >> Access control >> Form controller.

* There are no module settings yet.


-- CONTACT --

Current maintainers:
* Daniel F. Kudwien (sun) - dev@unleashedmind.com

This project has been sponsored by:
* UNLEASHED MIND
  Specialized in consulting and planning of Drupal powered sites, UNLEASHED
  MIND offers installation, development, theming, customization, and hosting
  to get you started. Visit http://www.unleashedmind.com for more information.