<?xml version="1.0" encoding="ISO-8859-1" ?>
<!DOCTYPE package SYSTEM "http://pear.php.net/dtd/package-1.0">
<package version="1.0">
  <name>DB_DataObject_FormBuilder</name>
  <summary>Class to automatically build HTML_QuickForm objects from a DB_DataObject-derived class</summary>
  <description>DB_DataObject_FormBuilder will aid you in rapid application development using the packages
DB_DataObject and HTML_QuickForm. For having a quick but working prototype of your application,
simply model the database, run DataObject´s createTable script over it and write a script
that passes one of the resulting objects to the FormBuilder class.
The FormBuilder will automatically generate a simple but working HTML_QuickForm object that you can
use to test your application. It also provides a processing method that will automatically detect
if an insert() or update() command has to be executed after the form has been submitted.
If you have set up DataObject´s links.ini file correctly, it will also automatically detect
if a table field is a foreign key and will populate a selectbox with the linked table´s entries.
There are many optional parameters that you can place in your DataObjects.ini or in the properties
of your derived classes, that you can use to fine-tune the form-generation, gradually turning
the prototypes into fully-featured forms, and you can take control at any stage of the process.</description>
  <maintainers>
    <maintainer>
      <user>mw21st</user>
      <name>Markus Wolff</name>
      <email>mw21st@php.net</email>
      <role>lead</role>
    </maintainer>
  </maintainers>
  <release>
    <version>0.8.2</version>
    <date>2003-08-28</date>
    <license>PHP License</license>
    <state>beta</state>
    <notes>New features:
- Support for custom field order (Fabien Franzen)
- Support for grouped elements (Fabien Franzen)
- Optional call to DB_DataObject::validate() on processing form data (suggested by Ron McClain)
- Possibility to optionally use existing form objects (suggested by Alexey Borzoff)</notes>
    <deps>
      <dep type="php" rel="ge" version="4.1.0"/>
      <dep type="pkg" rel="has">HTML_QuickForm</dep>
      <dep type="pkg" rel="has">DB_DataObject</dep>
    </deps>
    <provides type="class" name="DB_DataObject_FormBuilder" />
    <provides type="function" name="DB_DataObject_FormBuilder::create" />
    <provides type="function" name="DB_DataObject_FormBuilder::useForm" />
    <provides type="function" name="DB_DataObject_FormBuilder::getFieldLabel" />
    <provides type="function" name="DB_DataObject_FormBuilder::getSelectOptions" />
    <provides type="function" name="DB_DataObject_FormBuilder::getForm" />
    <provides type="function" name="DB_DataObject_FormBuilder::validateData" />
    <provides type="function" name="DB_DataObject_FormBuilder::getValidationErrors" />
    <provides type="function" name="DB_DataObject_FormBuilder::processForm" />
    <provides type="function" name="DB_DataObject_FormBuilder::debug" />
    <filelist>
      <file role="php" baseinstalldir="/DB/DataObject" md5sum="2dba693ae8cf774d0bdcb8c1eeee6704" name="FormBuilder.php"/>
    </filelist>
  </release>
  <changelog>
    <release>
      <version>0.8.1</version>
      <date>2003-08-23</date>
      <state>beta</state>
      <notes>Bugfix release:
- Fixed a bug in getSelectOptions() that occured if the linked field was NULL
- Fixed a bug with tables containing integer fields but having no entry in the links.ini (thanks to Fabien Franzen for reporting it)

</notes>
    </release>
    <release>
      <version>0.8</version>
      <date>2003-08-21</date>
      <state>beta</state>
      <notes>- Initial release.

</notes>
    </release>
  </changelog>
</package>
