Home » HTML » HTML_QuickForm_Controller
The add-on to HTML_QuickForm package that allows building of multipage forms
This package is unmaintained.
Download latest release 1.0.10 (archived versions might be outdated)
License: PHP License
Description
The package is essentially an implementation of a PageController pattern.
Architecture:
* Controller class that examines HTTP requests and manages form values persistence across requests.
* Page class (subclass of QuickForm) representing a single page of the form.
* Business logic is contained in subclasses of Action class.
Cool features:
* Includes several default Actions that allow easy building of multipage forms.
* Includes usage examples for common usage cases (single-page form, wizard, tabbed form).
Documentation
Maintainers
- Alexey Borzov (avb) — lead, active
- Bertrand Mansion (mansion) — developer, active
Dependencies
Required
- PHP (>= 4.3.0)
- PEAR Installer (>= 1.5.4)
- HTML_QuickForm (>= 3.2.5)
Releases
- 1.0.10 (stable, 2009-10-02)
Release notes
License: PHP License
Jump Action could perform a wrong redirect if $_SERVER['HTTPS'] contained
'OFF' rather than 'off' (bug #16328) - 1.0.9 (stable, 2008-07-22)
Release notes
License: PHP License
Jump Action now uses an absolute URI in Location header, as required by
RFC 2616 (bug #13087) - 1.0.8 (stable, 2007-05-18)
Release notes
License: PHP License
Migrate to package.xml version 2.0, use proper header comment blocks.
Minor fixes to phpdoc comments, no code changes since previous release. - 1.0.7 (stable, 2006-10-08)
Release notes
License: PHP License
Fixed bug #8687: defaults for checkboxes and multiselects were not correctly
applied in non-modal forms if the user haven't seen the page containing them. - 1.0.6 (stable, 2006-05-31)
Release notes
License: PHP License
Fixed bug #6110: HTML_QuickForm::validate() can throw a PEAR_Error, but there
were no checks made for it. - 1.0.5 (stable, 2005-11-04)
Release notes
License: PHP License
This is a recommended upgrade for users running HTML_QuickForm 3.2.5
* Fixed bug #3443: honour session.use_only_cookies setting by not passing
session ID in URL when it is on.
* Fixed bug #5615: some elements' values not displayed properly after
browsing back to a form page (see also bug #5625)
* Fixed bug #5641: unwanted target="_self" form attribute
* Fixed bug #5743: wrong element name in example file statemachine.php* Implemented request #4973: internal values may be filtered from the
array returned by HTML_QuickForm_Page::exportValues()
* Redone tabbed.php example to use a common base class instead of
braindead copy-paste technique (see also request #5234) - 1.0.4 (stable, 2004-12-30)
Release notes
License: PHP License
* perform() methods of all Action subclasses now consistently return
values (bug #2689) - 1.0.3 (stable, 2004-10-01)
Release notes
License: PHP License
* Fixed an error in regWizard.php example (bug #1154)
* It is no longer possible to go to a page of a modal form unless all the
previous pages are valid (bug #2323)
* Controller's setDefaults() and setConstants() methods now accept filters,
like corresponding HTML_QuickForm's methods do (request #1547) - 1.0.2 (stable, 2004-03-23)
Release notes
License: PHP License
* HTML_QuickForm_Controller does not rely on form's "name" attribute anymore
(XHTML compliance fix, see also bug #925)
* Use new HTML_QuickForm::arrayMerge() method in place of PHP's builtin
array_merge(), depend on QuickForm 3.2.2
* Applied patch from #929, exportValues() does not overwrite elements with
the same names from different pages. - 1.0.1 (stable, 2003-12-11)
Release notes
License: PHP License
* Added a new example showing how to proceed to either of the two pages
based on user input (Donald Lobo). - 1.0 (stable, 2003-11-05)
Release notes
License: PHP License
This release is done to update package's status to 'stable'. The code is now
considered mature and tested enough to be used in production.Changes:
* No changes to classes since 0.9.3
* Added an example of wizard with file upload (Bertrand Mansion)
* Depend on newest version of HTML_QuickForm - 0.9.3 (beta, 2003-10-24)
Release notes
License: PHP License
* Controller now differentiates between invalid and not-yet-validated pages. False is stored
in container's ['valid'][$pageName] field for the former, null for the latter. This is
a POTENTIAL BC BREAK, so pay attention if you wrote your own Actions.
* Back action in modal forms does not validate the page anymore (the previous behaviour was
non-intuitive, thanks to Bob Van Zant for reporting). - 0.9.2 (beta, 2003-10-02)
Release notes
License: PHP License
Added Page::setDefaultAction() method to fix the Controller's behaviour when user presses
Enter instead of clicking on one of submit buttons. Thanks to Mike Carter for reporting this. - 0.9.1 (beta, 2003-09-19)
Release notes
License: PHP License
Changes and additions:
* Added Controller::exportValue() method (thanks to Arnaud Limbourg)
* Controller::exportValues() can return values for the single page (thanks to Arnaud Limbourg)
* Added a parameter for Controller::container() that forces the container reset
* Added a new example: registration wizard (Bertrand Mansion)Fixes:
* Action_Next on the last page validates the whole form, not just the page itself - 0.9 (beta, 2003-08-29)
Release notes
License: PHP License
Initial PEAR release
Bugs
| ID | Status | Type | Version | Date | Summary |
|---|---|---|---|---|---|
| #771 | No Feedback | Bug | 2004-02-16 | Error storing $_POST array values | |
| #873 | Bogus | Bug | 2004-02-26 | PEAR QA: improvement for get_class()-usage | |
| #929 | Closed | Bug | 2004-03-01 | exportValues overwrite submitted arrays in multipage forms | |
| #1133 | Wont fix | Bug | 2004-04-04 | Segmentation Fault whenever ::run() is called | |
| #1154 | Closed | Bug | 2004-04-07 | addRule doesnt work with grouped text fields | |
| #1490 | Bogus | Bug | 2004-05-25 | setDefaultAction does not work with multiple submits | |
| #1547 | Closed | Req | 2004-06-02 | SetDefaults doesn't accept filters | |
| #1592 | Duplicate | Bug | 2004-06-09 | Double assignment breaks in PHP5 | |
| #1809 | Bogus | Bug | 2004-07-06 | class doesn't work with mod_rewrite | |
| #1866 | Wont fix | Bug | 2004-07-13 | Back action and client side rule | |
| #1932 | Wont fix | Req | 2004-07-20 | Remove dependancy on GET variable when performing a $page->handle('jump'); | |
| #1937 | Wont fix | Req | 2004-07-21 | Session cleanup | |
| #2009 | Bogus | Req | 2004-07-28 | Warning occurs. | |
| #2227 | Bogus | Req | 2004-08-26 | extend HTML_QuickForm's $trackSubmit parameter | |
| #2323 | Closed | Bug | 2004-09-13 | destroying container: problem with the back button | |
| #2407 | Bogus | Bug | 2004-09-27 | First time set values in selects doesn't works ok | |
| #2689 | Closed | Req | 2004-11-04 | perform() methods of action classes should probably return values | |
| #3422 | Bogus | Bug | 2005-02-10 | Adding radio buttons is incorrect | |
| #3443 | Closed | Bug | 2005-02-12 | Jump action ads SID also when session.use_only_cookies | |
| #3582 | Wont fix | Req | 2005-02-24 | new method HTML_QuickForm_Page::rebuildForm() | |
| #4195 | Bogus | Bug | 2005-04-21 | updateAttributes for new target (form action) | |
| #4331 | Closed | Bug | 2005-05-11 | Start the session automatically! | |
| #4973 | Closed | Req | 2005-08-02 | HTML_QuickForm_Page::exportValues returns internal values | |
| #5234 | Wont fix | Req | 2005-08-29 | Implementations | |
| #5615 | Closed | Bug | 2005-10-06 | Checkbox problem after new release of QuickForm | |
| #5625 | Duplicate | Bug | 2005-10-07 | Fall to defaults using multiple choice selects | |
| #5641 | Closed | Bug | 2005-10-10 | generated xhtml code not validated | |
| #5743 | Closed | Bug | 2005-10-21 | Bug in example 'statemachine.php' | |
| #6110 | Closed | Bug | 2005-11-29 | invalid return value from callback is not handled when validating page | |
| #6453 | Wont fix | Req | 2006-01-10 | Page class assuming action to be empty | |
| #7174 | Bogus | Bug | 1.0.5 | 2006-03-21 | unable to pass argument |
| #7932 | Closed | Req | 1.0.6 | 2006-06-18 | Conditional Pages |
| #8247 | Closed | Req | 1.0.6 | 2006-07-19 | Enabling $_GET params in action attribute |
| #8687 | Closed | Bug | 1.0.6 | 2006-09-14 | Incorrect handling of default values for non-modal unseen pages. |
| #10043 | Bogus | Bug | 1.0.7 | 2007-02-07 | hidden field naming |
| #11651 | Closed | Req | 1.0.8 | 2007-07-20 | method to add URL parameters for form action |
| #12951 | Bogus | Req | 1.0.8 | 2008-01-21 | Container setDefaults method |
| #13462 | Bogus | Doc | 2008-03-22 | User note that is a documentation problem | |
| #16328 | Closed | Bug | 1.0.9 | 2009-06-15 | Case where $_SERVER["HTTPS"] is returned as uppercase not handled |
| #16810 | Bogus | Doc | 1.0.10 | 2009-11-20 | examples/tabbed.php Tab click results in a double page reload |
| #17068 | Bogus | Bug | 1.0.10 | 2010-02-05 | Cannot jump with port forwarding |
| #19866 | Open | Bug | 1.0.10 | 2013-03-22 | The action Jump translates incorrectly the URL when using PHP-FPM |