Forms API: Multipart Forms and Documentation
After months of work between hunmonk, myself, and chx, we've finalized some substantial progress on multipart forms. A multipart form is a form that is spread across multiple pages (like a wizard), but doesn't truly "submit" until the final page. There are still some hiccups here and there, largely due to checkboxes and multi-selects, but we're at a decent enough place to show off some working code and let it alone for Drupal 4.7. You must be running Drupal 4.7b6 or higher to use this stuff. Documentation (by Morbus): http://drupal.org/node/54753 Fully working multipart_form_example.module (by hunmonk): http://cvs.drupal.org/viewcvs/drupal/contributions/docs/developer/examples/ Sweet, sweet, loving (by chx): <censored> -- Morbus Iff ( you are nothing without your robot car, NOTHING! ) Culture: http://www.disobey.com/ and http://www.gamegrene.com/ O'Reilly Author, Weblog, Cook: http://www.oreillynet.com/pub/au/779 icq: 2927491 / aim: akaMorbus / yahoo: morbus_iff / jabber.org: morbus
On 3/21/06, Morbus Iff <morbus@disobey.com> wrote:
After months of work between hunmonk, myself, and chx, we've finalized some substantial progress on multipart forms. A multipart form is a form that is spread across multiple pages (like a wizard), but doesn't truly "submit" until the final page.
There are still some hiccups here and there, largely due to checkboxes and multi-selects, but we're at a decent enough place to show off some working code and let it alone for Drupal 4.7.
You must be running Drupal 4.7b6 or higher to use this stuff.
Documentation (by Morbus): http://drupal.org/node/54753
Fully working multipart_form_example.module (by hunmonk): http://cvs.drupal.org/viewcvs/drupal/contributions/docs/developer/examples/
Sweet, sweet, loving (by chx): <censored>
You guys are the best ... This is a much needed feature, and many forms can benefit from it. Ecommerce checkout comes to mind as the obvious one. Register and Post comes to mind (e.g. a site that will prompt users to register then post something [resume, classified ad, ...etc.]) Thanks you all.
Kudos to all. Can we please call these "multipage forms" to avoid confusing them with multipart forms? http://www.w3.org/TR/REC-html40/interact/forms.html#h-17.13.4.2
Morbus Iff wrote:
After months of work between hunmonk, myself, and chx, we've finalized some substantial progress on multipart forms. A multipart form is a form that is spread across multiple pages (like a wizard), but doesn't truly "submit" until the final page.
I think this is an excellent case for a page element or somesuch. I'll try massaging it into one and putting it in extra_elements.inc [1].
There are still some hiccups here and there, largely due to checkboxes and multi-selects, but we're at a decent enough place to show off some working code and let it alone for Drupal 4.7.
I have a multiselect to deal with. [1] Info: http://delocalizedham.com/node/88 CVS: http://cvs.drupal.org/viewcvs/drupal/contributions/sandbox/drumm/extra_eleme... -- Neil Drumm http://delocalizedham.com/
This is really cool: now that developers have a proper template for doing multi-page forms in 4.7, doing them should be easier than it's ever been before! Thanks very much for your hard work on this, guys. It's great that there's a way to achieve this in 4.7, but clearly, looking ahead to 4.8/5.0, multi-page forms need to be implemented cleanly and natively into the forms API. I'm sure that the people working on the 4.8 install system already have plans for this. This 4.7 example will serve as a great starting point for the features needed in a native FAPI implementation of multi-page support (e.g. page-to-element mapping, forward/back navigation, per-page theming). Has any work been started on the 4.8 version of multi-page forms, and if so, can anyone point me to links in the issue tracker, the handbook, contrib CVS, etc? Even if there's only a proposal so far, it would still be good to have a URL to refer to for tracking this. Jaza. On 3/22/06, Morbus Iff <morbus@disobey.com> wrote:
After months of work between hunmonk, myself, and chx, we've finalized some substantial progress on multipart forms. A multipart form is a form that is spread across multiple pages (like a wizard), but doesn't truly "submit" until the final page.
There are still some hiccups here and there, largely due to checkboxes and multi-selects, but we're at a decent enough place to show off some working code and let it alone for Drupal 4.7.
You must be running Drupal 4.7b6 or higher to use this stuff.
Documentation (by Morbus): http://drupal.org/node/54753
Fully working multipart_form_example.module (by hunmonk): http://cvs.drupal.org/viewcvs/drupal/contributions/docs/developer/examples/
Sweet, sweet, loving (by chx): <censored>
-- Morbus Iff ( you are nothing without your robot car, NOTHING! ) Culture: http://www.disobey.com/ and http://www.gamegrene.com/ O'Reilly Author, Weblog, Cook: http://www.oreillynet.com/pub/au/779 icq: 2927491 / aim: akaMorbus / yahoo: morbus_iff / jabber.org: morbus -- Pending work: http://drupal.org/project/issues/documentation/ List archives: http://lists.drupal.org/pipermail/documentation/
Has any work been started on the 4.8 version of multi-page forms, and if so, can anyone point me to links in the issue tracker, the handbook, contrib CVS, etc? Even if there's only a proposal so far, it would still be good to have a URL to refer to for tracking this.
i'm pretty excited about 4.8 too. but please, lets focus on getting 4.7 out the door. then we will have a multipage form cck dance party. we need everyone's focus for a short while to make this release. 4.7 critical bugs: http://drupal.org/project/issues?projects=3060&versions=10238,10195,9902,984... 4.7 all bugs (needs verifying/prioritizing/fixing): http://drupal.org/project/issues?projects=3060&versions=10238,10195,9902,984...
On Wed, 2006-03-22 at 21:01 -0500, Moshe Weitzman wrote:
Has any work been started on the 4.8 version of multi-page forms, and if so, can anyone point me to links in the issue tracker, the handbook, contrib CVS, etc? Even if there's only a proposal so far, it would still be good to have a URL to refer to for tracking this.
i'm pretty excited about 4.8 too. but please, lets focus on getting 4.7 out the door. then we will have a multipage form cck dance party. we need everyone's focus for a short while to make this release.
4.7 critical bugs: http://drupal.org/project/issues?projects=3060&versions=10238,10195,9902,984...
4.7 all bugs (needs verifying/prioritizing/fixing): http://drupal.org/project/issues?projects=3060&versions=10238,10195,9902,984...
Gotta have 4.7 release before we can 4.8... Use all that 4.8 anxiety to close bugs!!
participants (8)
-
Darrel O'Pry -
Jeremy Epstein -
John VanDyk -
Khalid B -
Matt Westgate -
Morbus Iff -
Moshe Weitzman -
Neil Drumm