TM::Apeform Change Log

2004-04-30
    * Support for units added. Call $form->text("Label", "Help\tUnit") for
      example. The units value is displayed behind the element.
    * Added two examples adopted from PEAR::HTML_QuickForm.
    * Added another nice CSS-only example to example_templates.php.
    * test.php is back (uses PEAR::PHPUnit now).

2004-04-18
    * In template 'input' the tag {error} is optional now. If omited, an error
      message will replace the label (as previous versions of the class did). If
      present, an error message will NOT replace the label. WARNING! This change
      is incompatible to previous versions of the class!
    * New elements: header() (Thanks to Shimrod!) and staticText() (similar to
      text, but not editable). New template for header added.
    * Added posibility to specify an id for the form using Apeform(0, 0, "id").
      Now two or more forms in one page are possible. (Thanks to René Pönitz!)
      See example_multiform.php.
    * Auto-focus is disabled by default if the form gets a non-default id. Set
      setFocus to true to enable it.
    * Submit button always get accesskey="s" if only one button is defined.
    * Multiple calls of toHtml() failed. Fixed.
    * Changed element id's from "element3l" to "element3i".
    * The default templates <br> wasn't XHTML compatible. Changed to <br />.

2004-03-08
    * Tiny speed-ups (count() moved out of for()).

2004-01-10
    * The file upload triggers an user warning if "safe mode" restrictions are
      in effect and tmpDir is not set properly. The garbage collection does not
      crash any more.
    * Handling of special "umlaut" characters improved in _getUnixName().
    * In action="...", any "&" becomes "&amp;" according to the W3C.
    * A bunch of code beautyfications.
    * example_multiform.php added.
    * Removed test.php.

2003-12-28
    * Added summary="" to the default <table> template.

2003-11-17
    * Added getName(). (Thanks to Shimrod!)
    * In toHtml(), replaced PHP_SELF with PHP_SELF?QUERY_STRING. (Thanks to
      Shimrod!) REQUEST_URI doesn't work on non-Apache servers.
    * In _getFocusHandler(), replaced forms[0] with forms['form']. (Thanks to
      Shimrod!)
    * In file(), removed the environment stuff. tempnam() handles this. (Was a
      bug caused by a bug in realpath(). It never returns false.)
    * file() displays at least first 12 characters of the filename submitted.
    * _doGarbageCollection() introduced.
    * Improved the example_advertisement.php example.

2003-11-12
    * <strong><label> didn't worked in Opera. Switched to <lable><strong>.
    * Introduced _getUnixName(), improved returned 'unixname' a lot.
    * file() calls it's temporary files tmp* instead of Ape*.

2003-11-11
    * Option $setFocus added to toHtml() and display().
    * _getFocusHandler() introduced.

2003-11-10
    * Apeform("invalid int value") is ignored now.

2003-10-29
    * Added semi-automatic accesskey support for the error messages.
    * file() displays the file name if there was something submitted before.
    * file() uses one of the TMP/TEMP/TMPDIR/upload_tmp_dir environment
      variables if tmpDir does not exists.

2003-10-23
    * Introduced _magicQuotes, use Apeform(..., ..., false) to disable.
    * file() returns 'unixname', additionaly to 'name'.
    * Improved handler(), now it's no problem to call them multiple times.

2003-10-14
    * Select() also accepts array values instead of keys as defaultValue.
    * Bugfix: Now, defaultValue = "0" is possible in text() etc.
    * Added image(), <input type="image"> (EXPERIMENTAL).

2003-09-28
    * Renamed build() into toHtml(), added display(), renamed is_valid() into
      isValid(), according to the PEAR coding standards.
    * text(..., $maxLength = 8, $size = 0) will set size to 8 instead of the
      default size.
    * Bugfix: Changed the magic_quotes behaviour in select() and radio().
    * Bugfix: $_SERVER['PHP_SELF'] vs. $PHP_SELF problem solved.

2003-05-16
    * Use error("...", -1) to add an error message to any previous element.

2003-05-06
    * Added title="..." tooltips. They show the help texts so you can remove
      any {help} from your HTML templates if you want.

2003-05-04
    * Uploaded files will be stored in a temporary directory automaticaly. Set
      the directory using $form->tmpDir or leav it empty to use default /tmp.
      Don't use move_uploaded_file() any more! Use copy()/rename() instead!

2003-04-15
    * Onload handler added. Focus() works much better now.

2003-03-20
    * Rename $value into $defaultValue; cleared some function headers; now it's
      easier to understand what it is for.
    * checkbox("Label") without any options do work now.
    * Bugfix: Unchecking a via $defaultValue checked checkbox won't cause a
      ping-pong loop any more. Still critical but works in most cases.
    * Bugfix: checkbox(), radio() and select() are returning references too.

2003-03-11
    * If a password element got an error it will be reseted anytime.
    * Bugfix: Hidden element returns reference now.

2003-03-10
    * Textarea wrap mode can be changed/disabled now (default is "virtual").
    * Added the #form anchor.
    * Removed some "\n".
    * Bugfix: <... selected> and <... checked> are valid XHTML now.

2003-03-09
    * Hidden variables can be named now (added second parameter).
    * Bugfix: Submit buttons show default value if empty.
    * Bugfix: Submit buttons show array values instead of keys.

2003-03-06
    * All elements return references when using $ref = &$form->text();
    * When adding more than one error message per element, using the first.
    * Added $HTTP_POST_VARS (will make it run in any older version of PHP).

2003-03-05
    * Most elements are using <label> now. Their text can be clicked this way.
    * Encryption type will only be set when needed (whe using file upload).
    * Select, radio and checkbox can be selected/checked by default.
    * Multiple buttons in one row are possible using an "a|b" value.
    * Added a leading '_' to all private variables and method names.
    * handler() added, adds JavaScript handlers to the form or any element.
    * Sets focus() to the first element containing an error.
    * Access keys in radio buttons and multiple checkboxes are possible.

2003-03-02
    * Default maximum length will be handled in the compile method now.
    * Submit button returns false if not submitted before (similar to file).
    * Adds access keys if there are underlined <u>c</u>haracters.
    * Renamed "title" to "label" everywhere.

2003-02-28
    * Element names are handled by the script ("element0", "element1", ...).
    * Added file, radio and some other form elements.