About Site Map Submit Contact Us Log in | Create an account
Create an account Log In
Average Rating
User Rating:
Visitors Rating:
My rating:

Write review
See full specifications

linux default iconcollective.z3cform.wizard Publisher's description

This is a library for creating multi-page wizards using z3c.form. Values are stored in a session until the wizard is finished.

This library implements a simple z3c.form-based wizard. The wizard is composed of multiple steps. Each step is a form. Data is stored in a session until the user clicks the Finish button on the last step.

In order to make good use of this library you'll need to be reasonably familiar with z3c.form first. Here are some places to start:

* Official documentation: http://docs.zope.org/z3c.form
* Slides from Stephan Richter's tutorial at Plone Conference 2008: http://svn.zope.org/*checkout*/z3c.talk/trunk/Z3CForms/Z3CForms.html?rev=92118

Wizard Step

A wizard step is a normal z3c.form form with a few additional features.

By default, the content accessed by this form will be a dictionary within the wizard's session, with a key equal to the step's prefix.

Additional attributes:

The wizard this step is being used in.
Boolean indicating whether the current step can be accessed via the wizard navigation links. By default, only steps for which there is already data stored in the session can be accessed. (The next and previous steps can always be accessed via the respective buttons regardless of the value of this property.)
Boolean indicating whether the user should be allowed to move on to the next step. Defaults to True. If False, the Continue button will be disabled.

Additional methods:

Saves changes from this step to its content (typically a PersistentDict in the wizard's session.)
Loads the session data for this step based on a context.
Updates a context based on the session data for this step.

Wizard Group Step

Same as a Wizard Step; it just handles a list of groups just like a z3c.form GroupForm.

Additional attributes:

The list of groups you'd like to show up in the form as separate fieldsets


The wizard is also a form, with a list of steps and built-in logic for moving between those steps.

Class attributes. Override these to affect how the wizard behaves:

A sequence of step classes that will be instantiated when the wizard's update method is called.
Returns the unique session key used by this wizard instance. By default, this is a tuple of 'collective.z3cform.wizard' and the URL path to the wizard.

Attributes set during the update method:

A sequence of wizard step instances.
The wizard step instance currently being displayed.
The (0-based) index of the current step within the activeSteps sequence.
The session where data for this wizard is persisted.
Boolean. True if the first step of the wizard is being displayed.
Boolean. True if the last step of the wizard is being displayed.
Boolean. True if the 'available' attribute of each wizard step is True.
Boolean. True if the wizard has been completed.
The URL of the wizard.



Called the first time a wizard is viewed in a given session.

This method may be used to populate the session with data from some source.

The default implementation calls the loadSteps method.

Loads the wizard session data from a context.

The default implementation calls the 'load' method of each wizard step.

Called when a wizard is successfully completed, after validation of the final step.

Use this method to carry out some actions based on the values that have been filled out during completion of the wizard.

The default implementation calls the applySteps method.

Updates a context based on the wizard session data.

The default implementation calls the 'apply' method of each wizard step.
Mark the session as having changed, to ensure that changes get persisted. This is required since we aren't using a persistence-aware dictionary class for our session variables.

What's New in This Release:

Remove stray debugging statement. [khink]

System Requirements:

No special requirements.
Program Release Status:
Program Install Support: Install and Uninstall

collective.z3cform.wizard Tags:

Click on a tag to find related softwares

Is collective.z3cform.wizard your software?

Manage your software

Most Popular

linux default icon GDB 7.4
GDB, the GNU Project debugger, allows you to see what is going on `inside' another program while it... Read more
linux default icon Coral 0.9.1
Coral is a tool and a development platform to create and transform models and modeling languages.
linux default icon Forum Paid Plus Script 6.1
Forum Paid Pay Per Post Exchange is targeted at forum owners who wish to...
linux default icon sdo 0.6.5
Converts oracle SDO_GEOMETRY objects to WKT and GeoJSON.
linux default icon Get Paid Plus Script 6.1
Get Paid Plus Script

Related Category

» Other (877)
» Tools & Editors (359)
» Web Development (146)