plone.z3cform 2.0.0a2

A caveat about security

In Zope 2.12 and later, the security machinery is aware of __parent__ pointers. Thus, traversal and authorisation on @@some-view in the example above will work just fine for a standard widget. In earlier versions of Zope, you will need to mix acquisition into your widget (which rules out using any of the standard z3c.form widgets). For example:

from Acquisition import Explicit
from z3c.form.widget import Widget

class MyWidget(Widget, Explicit):
    ...

Unfortunately, in Zope 2.12, this will cause some problems during traversal unless you also mix acquisition into the view you registered on the widget (@@some-view above). Specifically, you will get an error as the publisher tries to wrap the view in the widget.

To stay compatible with both Zope 2.12+ and earlier versions, you have two options:

• Ensure that you mix acquisition into the view on the widget

• Ensure that the widget inherits from Explicit, but does not provide the IAcquirer interface. This tricks the publisiher into relying on __parent__ pointers in Zope 2.12.

To do the latter, you can use implementsOnly(), e.g.:

from zope.interface import implementsOnly
from Acquisition import Explicit
from z3c.form.widget import Widget

...

class MyWidget(Widget, Explicit):
    implementsOnly(IMyWidget) # or just IWdget from z3c.form
    ...

Setup

>>> from plone.z3cform.tests import setup_defaults
>>> setup_defaults()

A simple form

First, let’s define an interface and a class to play with:

>>> from zope import interface, schema
>>> class IPerson(interface.Interface) :
...     name = schema.TextLine()
...     age = schema.Int()

>>> @interface.implementer(IPerson)
... class Person(object):
...     def __init__(self, name=None, age=None):
...         self.name, self.age = name, age
...     def __repr__(self):
...         return "<Person with name=%r, age=%r>" % (self.name, self.age)

For this test, we take the the name of our persons as keys in our storage:

>>> storage = {'Peter': Person(u'Peter', 16),
...            'Martha': Person(u'Martha', 32)}

Our simple form looks like this:

>>> class MyForm(crud.CrudForm):
...     update_schema = IPerson
...
...     def get_items(self):
...         return sorted(storage.items(), key=lambda x: x[1].name)
...
...     def add(self, data):
...         person = Person(**data)
...         storage[str(person.name)] = person
...         return person
...
...     def remove(self, id_item):
...         id, item = id_item
...         del storage[id]

This is all that we need to render a combined edit add form containing all our items:

>>> class FakeContext(object):
...     def absolute_url(self):
...         return 'http://nohost/context'
>>> fake_context = FakeContext()

>>> from plone.z3cform.tests import TestRequest
>>> print(MyForm(fake_context, TestRequest())()) \
... # doctest: +ELLIPSIS +NORMALIZE_WHITESPACE
<div class="crud-form">...Martha...Peter...</div>

Editing items with our form

Before we start with editing objects, let’s log all events that the form fires for us:

>>> from zope.lifecycleevent.interfaces import IObjectModifiedEvent
>>> from plone.z3cform.tests import create_eventlog
>>> log = create_eventlog(IObjectModifiedEvent)

>>> request = TestRequest()
>>> request.form['crud-edit.Martha.widgets.select-empty-marker'] = u'1'
>>> request.form['crud-edit.Peter.widgets.select-empty-marker'] = u'1'
>>> request.form['crud-edit.Martha.widgets.name'] = u'Martha'
>>> request.form['crud-edit.Martha.widgets.age'] = u'55'
>>> request.form['crud-edit.Peter.widgets.name'] = u'Franz'
>>> request.form['crud-edit.Peter.widgets.age'] = u'16'
>>> request.form['crud-edit.form.buttons.edit'] = u'Apply changes'
>>> html = MyForm(fake_context, request)()
>>> "Successfully updated" in html
True

Two modified events should have been fired:

>>> event1, event2 = log.pop(), log.pop()
>>> storage['Peter'] in (event1.object, event2.object)
True
>>> storage['Martha'] in (event1.object, event2.object)
True
>>> log
[]

If we don’t make any changes, we’ll get a message that says so:

>>> html = MyForm(fake_context, request)()
>>> "No changes made" in html
True
>>> log
[]

Now that we renamed Peter to Franz, it would be also nice to have Franz use ‘Franz’ as the id in the storage, wouldn’t it?

>>> storage['Peter']
<Person with name='Franz', age=16>

We can override the CrudForm’s before_update method to perform a rename whenever the name of a person is changed:

>>> class MyRenamingForm(MyForm):
...     def before_update(self, item, data):
...         if data['name'] != item.name:
...             del storage[item.name]
...             storage[str(data['name'])] = item

Let’s rename Martha to Maria. This will give her another key in our storage:

>>> request.form['crud-edit.Martha.widgets.name'] = u'Maria'
>>> html = MyRenamingForm(fake_context, request)()
>>> "Successfully updated" in html
True
>>> log.pop().object == storage['Maria']
True
>>> log
[]
>>> sorted(storage.keys())
['Maria', 'Peter']

Next, we’ll submit the form for edit, but we’ll make no changes. Instead, we’ll select one time. This shouldn’t do anything, since we clicked the ‘Apply changes’ button:

>>> request.form['crud-edit.Maria.widgets.name'] = u'Maria'
>>> request.form['crud-edit.Maria.widgets.age'] = u'55'
>>> request.form['crud-edit.Maria.widgets.select'] = [u'selected']
>>> html = MyRenamingForm(fake_context, request)()
>>> "No changes" in html
True
>>> log
[]

And what if we do have changes and click the checkbox?

>>> request.form['crud-edit.Maria.widgets.age'] = u'50'
>>> html = MyRenamingForm(fake_context, request)()
>>> "Successfully updated" in html
True
>>> log.pop().object == storage['Maria']
True
>>> log
[]

If we omit the name, we’ll get an error:

>>> request.form['crud-edit.Maria.widgets.name'] = u''
>>> html = MyRenamingForm(fake_context, request)()
>>> "There were some errors" in html
True
>>> "Required input is missing" in html
True

We expect an error message in the title cell of Maria:

>>> checkbox_pos = html.index('crud-edit.Maria.widgets.select-empty-marker')
>>> "Required input is missing" in html[checkbox_pos:]
True

Delete an item with our form

We can delete an item by selecting the item we want to delete and clicking the “Delete” button:

>>> request = TestRequest()
>>> request.form['crud-edit.Peter.widgets.select'] = ['selected']
>>> request.form['crud-edit.form.buttons.delete'] = u'Delete'
>>> html = MyForm(fake_context, request)()
>>> "Successfully deleted items" in html
True
>>> 'Franz' in html
False
>>> storage
{'Maria': <Person with name='Maria', age=50>}

Add an item with our form

>>> from zope.lifecycleevent.interfaces import IObjectCreatedEvent
>>> from plone.z3cform.tests import create_eventlog
>>> log = create_eventlog(IObjectCreatedEvent)

>>> request = TestRequest()
>>> request.form['crud-add.form.widgets.name'] = u'Daniel'
>>> request.form['crud-add.form.widgets.age'] = u'28'
>>> request.form['crud-add.form.buttons.add'] = u'Add'
>>> html = MyForm(fake_context, request)()
>>> "Item added successfully" in html
True

Added items should show up right away:

>>> "Daniel" in html
True

>>> storage['Daniel']
<Person with name='Daniel', age=28>
>>> log.pop().object == storage['Daniel']
True
>>> log
[]

What if we try to add “Daniel” twice? Our current implementation of the add form will simply overwrite the data:

>>> save_daniel = storage['Daniel']
>>> html = MyForm(fake_context, request)()
>>> "Item added successfully" in html
True
>>> save_daniel is storage['Daniel']
False
>>> log.pop().object is storage['Daniel']
True

Let’s implement a class that prevents this:

>>> class MyCarefulForm(MyForm):
...     def add(self, data):
...         name = data['name']
...         if name not in storage:
...             return super(MyCarefulForm, self).add(data)
...         else:
...             raise schema.ValidationError(
...                 u"There's already an item with the name '%s'" % name)

>>> save_daniel = storage['Daniel']
>>> html = MyCarefulForm(fake_context, request)()
>>> "Item added successfully" in html
False
>>> "There's already an item with the name 'Daniel'" in html
True
>>> save_daniel is storage['Daniel']
True
>>> len(log) == 0
True

Render some of the fields in view mode

We can implement in our form a view_schema attribute, which will then be used to view information in our form’s table. Let’s say we wanted the name of our persons to be viewable only in the table:

>>> from z3c.form import field
>>> class MyAdvancedForm(MyForm):
...     update_schema = field.Fields(IPerson).select('age')
...     view_schema = field.Fields(IPerson).select('name')
...     add_schema = IPerson

>>> print(MyAdvancedForm(fake_context, TestRequest())()) \
... # doctest: +ELLIPSIS +NORMALIZE_WHITESPACE
<div class="crud-form">...Daniel...Maria...</div>

We can still edit the age of our Persons:

>>> request = TestRequest()
>>> request.form['crud-edit.Maria.widgets.age'] = u'40'
>>> request.form['crud-edit.Daniel.widgets.age'] = u'35'
>>> request.form['crud-edit.form.buttons.edit'] = u'Apply Changes'
>>> html = MyAdvancedForm(fake_context, request)()
>>> "Successfully updated" in html
True

>>> storage['Maria'].age
40
>>> storage['Daniel'].age
35

We can still add a Person using both name and age:

>>> request = TestRequest()
>>> request.form['crud-add.form.widgets.name'] = u'Thomas'
>>> request.form['crud-add.form.widgets.age'] = u'28'
>>> request.form['crud-add.form.buttons.add'] = u'Add'
>>> html = MyAdvancedForm(fake_context, request)()
>>> "Item added successfully" in html
True
>>> len(storage)
3
>>> storage['Thomas']
<Person with name='Thomas', age=28>

Our form can also contain links to our items:

>>> class MyAdvancedLinkingForm(MyAdvancedForm):
...     def link(self, item, field):
...         if field == 'name':
...             return 'http://en.wikipedia.org/wiki/%s' % item.name

>>> print(MyAdvancedLinkingForm(fake_context, TestRequest())()) \
... # doctest: +ELLIPSIS +NORMALIZE_WHITESPACE
<div class="crud-form">...
...<a href="http://en.wikipedia.org/wiki/Daniel"...
...<a href="http://en.wikipedia.org/wiki/Maria"...
...<a href="http://en.wikipedia.org/wiki/Thomas"...
</div>

What if we wanted the name to be both used for linking to the item and for edit? We can just include the title field twice:

>>> class MyAdvancedLinkingForm(MyAdvancedLinkingForm):
...     update_schema = IPerson
...     view_schema = field.Fields(IPerson).select('name')
...     add_schema = IPerson

>>> print(MyAdvancedLinkingForm(fake_context, TestRequest())()) \
... # doctest: +ELLIPSIS +NORMALIZE_WHITESPACE
<div class="crud-form">...
...<a href="http://en.wikipedia.org/wiki/Thomas"...Thomas...</a>...
</div>

We can now change Thomas’s name and see the change reflected in the Wikipedia link immediately:

>>> request = TestRequest()
>>> for name in 'Daniel', 'Maria', 'Thomas':
...     request.form['crud-edit.%s.widgets.name' % name] = storage[name].name
...     request.form['crud-edit.%s.widgets.age' % name] = storage[name].age
>>> request.form['crud-edit.Thomas.widgets.name'] = u'Dracula'
>>> request.form['crud-edit.form.buttons.edit'] = u'Apply Changes'

>>> print(MyAdvancedLinkingForm(fake_context, request)()) \
... # doctest: +ELLIPSIS +NORMALIZE_WHITESPACE
<div class="crud-form">...
...<a href="http://en.wikipedia.org/wiki/Dracula"...Dracula...</a>...
</div>
>>> storage['Thomas'].name = u'Thomas'

Don’t render one part

What if we wanted our form to display only one part, that is, only the add or the edit form. Our CrudForm can implement editform_factory and addform_factory to override one or both forms. Seeting one of these to crud.NullForm will make them disappear:

>>> class OnlyEditForm(MyForm):
...     addform_factory = crud.NullForm
>>> html = OnlyEditForm(fake_context, TestRequest())()
>>> 'Edit' in html, 'Add' in html
(True, False)

>>> class OnlyAddForm(MyForm):
...     editform_factory = crud.NullForm
>>> html = OnlyAddForm(fake_context, TestRequest())()
>>> 'Edit' in html, 'Add' in html
(False, True)

Render only in view, and define own actions

Sometimes you want to present a list of items, possibly in view mode only, and have the user select one or more of the items to perform some action with them. We’ll present a minimal example that does this here.

We can simply leave the update_schema class attribute out (it defaults to None). Furthermore, we’ll need to override the ediform_factory with our custom version that provides other buttons than the ‘edit’ and ‘delete’ ones:

>>> from pprint import pprint
>>> from z3c.form import button

>>> class MyEditForm(crud.EditForm):
...     @button.buttonAndHandler(u'Capitalize', name='capitalize')
...     def handle_capitalize(self, action):
...         self.status = u"Please select items to capitalize first."
...         selected = self.selected_items()
...         if selected:
...             self.status = u"Capitalized items"
...             for id, item in selected:
...                 item.name = item.name.upper()

>>> class MyCustomForm(crud.CrudForm):
...     view_schema = IPerson
...     editform_factory = MyEditForm
...     addform_factory = crud.NullForm     # We don't want an add part.
...
...     def get_items(self):
...         return sorted(storage.items(), key=lambda x: x[1].name)

>>> request = TestRequest()
>>> html = MyCustomForm(fake_context, TestRequest())()
>>> "Delete" in html, "Apply changes" in html, "Capitalize" in html
(False, False, True)
>>> pprint(storage)
{'Daniel': <Person with name='Daniel', age=35>,
 'Maria': <Person with name='Maria', age=40>,
 'Thomas': <Person with name='Thomas', age=28>}

>>> request.form['crud-edit.Thomas.widgets.select'] = ['selected']
>>> request.form['crud-edit.form.buttons.capitalize'] = u'Capitalize'
>>> html = MyCustomForm(fake_context, request)()
>>> "Capitalized items" in html
True
>>> pprint(storage)
{'Daniel': <Person with name='Daniel', age=35>,
 'Maria': <Person with name='Maria', age=40>,
 'Thomas': <Person with name='THOMAS', age=28>}

We cannot use any of the other buttons:

>>> del request.form['crud-edit.form.buttons.capitalize']
>>> request.form['crud-edit.form.buttons.delete'] = u'Delete'
>>> html = MyCustomForm(fake_context, request)()
>>> "Successfully deleted items" in html
False
>>> 'Thomas' in storage
True

Customizing sub forms

The EditForm class allows you to specify an editsubform_factory-a classs inherits from EditSubForm. This allows you to say, override the crud-row.pt page template and customize the look of the fields.

>>> import zope.schema
>>> class MyCustomEditSubForm(crud.EditSubForm):
...
...     def _select_field(self):
...         """I want to customize the field that it comes with..."""
...         select_field = field.Field(
...         zope.schema.TextLine(__name__='select',
...                              required=False,
...                              title=u'select'))
...         return select_field

>>> class MyCustomEditForm(MyEditForm):
...     editsubform_factory = MyCustomEditSubForm

>>> class MyCustomFormWithCustomSubForm(MyCustomForm):
...     editform_factory = MyCustomEditForm

>>> request = TestRequest()
>>> html = MyCustomFormWithCustomSubForm(fake_context, TestRequest())()

Still uses same form as before

>>> "Delete" in html, "Apply changes" in html, "Capitalize" in html
(False, False, True)

Just changes the widget used for selecting…

>>> 'type="checkbox"' in html
False

Using batching

The CrudForm base class supports batching. When setting the batch_size attribute to a value greater than 0, we’ll only get as many items displayed per page.

>>> class MyBatchingForm(MyForm):
...     batch_size = 2
>>> request = TestRequest()
>>> html = MyBatchingForm(fake_context, request)()
>>> "Daniel" in html, "Maria" in html
(True, True)
>>> "THOMAS" in html
False

Make sure, the batch link to the next page is available

>>> 'crud-edit.form.page=1' in html
True

Show next page and check content

>>> request = TestRequest(QUERY_STRING='crud-edit.form.page=1')
>>> request.form['crud-edit.form.page'] = '1'
>>> html = MyBatchingForm(fake_context, request)()
>>> "Daniel" in html, "Maria" in html
(False, False)
>>> "THOMAS" in html
True

The form action also includes the batch page information so the correct set of subforms can be processed:

>>> print(html) \
... # doctest: +ELLIPSIS +NORMALIZE_WHITESPACE
<BLANKLINE>
...
<form action="http://nohost/context?crud-edit.form.page=1"
          method="post">
...

Let’s change Thomas’ age on the second page:

>>> request.form['crud-edit.Thomas.widgets.name'] = u'Thomas'
>>> request.form['crud-edit.Thomas.widgets.age'] = '911'
>>> request.form['crud-edit.form.buttons.edit'] = u'Apply changes'
>>> html = MyBatchingForm(fake_context, request)()
>>> "Successfully updated" in html
True
>>> "911" in html
True

2.0.0a2 (2022-03-23)

New features:

• compatibility with z3c.form >= 4.x [petschki] (#20)

2.0.0a1 (2021-04-21)

Breaking changes:

• Update for Plone 6 with Bootstrap markup Refs PLIP https://github.com/plone/Products.CMFPlone/issues/3061 [petschki, ale-rt, agitator] (#16)

1.1.3 (2020-06-16)

Bug fixes:

• Copy the HTTPRequest._decode from Zope4 because it is going away in Zope5 (#13)

1.1.2 (2020-04-21)

Bug fixes:

• Buttons in crud-table should be list items. [erral] (#9)

1.1.1 (2019-10-12)

Bug fixes:

• Fix edit/delete in paginated crud-forms [fRiSi]

1.1.0 (2019-04-09)

New features:

• Change license to GPLv2 [petschki]

• Enable :record[s] fields in z2.processInputs [petschki]

• Cosmetic tweaks. [gforcada]

1.0.0 (2018-11-04)

New features:

• Support for Python 3 [pbauer, davilima6, ale-rt, jensens]

Bug fixes:

• Test cleanup. [jensens]

• Rename folder templates to pagetemplates, because of ZCML browser directive warnings. [jensens]

• Removal of tuple parameter unpacking in method definition (Fixes #14) [ale-rt]

• Provide an up-to-date bootstrap.py [ale-rt]

• Use the adapter and implementer decorators [ale-rt]

0.9.1 (2017-09-03)

Bug fixes:

• Remove deprecated __of__ calls on BrowserViews [MrTango]

0.9.0 (2016-05-25)

New:

• Enable groups aka fieldsets to be orderable. [jensens]

Fixes:

• Fix batching navigation in CRUD form. [petschki]

• Added two missing German translations. One of those fixes https://github.com/plone/Products.CMFPlone/issues/1580 [jensens]

• QA: pep8. [maurits, thet]

0.8.1 (2015-01-22)

• Feature: take group class from parent-form if given. If not given it uses the default class. [jensens]

• Added Ukrainian translation [kroman0]

• Added Italian translation [giacomos]

0.8.0 (2012-08-30)

• Remove backwards-compatibility code for Zope < 2.12 [davisagli]

• Use plone.testing for functional test layer support. [hannosch]

• Use ViewPageTemplateFile from zope.browserpage. [hannosch]

• Use form action URL as given by the view, instead of implementing it in the template as a call to the getURL method of the request. [malthe]

• Use plone.batching for batches instead of z3c.batching [tom_gross]

0.7.8 - 2011-09-24

• Do not display h1 element if there is no label on view. [thomasdesvenain]

• Add Chinese translation. [jianaijun]

0.7.7 - 2011-06-30

• Avoid rendering a wrapped form if a redirect has already occurred after updating it. [davisagli]

• Remove <a name=””/> elements from inside the CRUD table TBODY element they were otherwise unused (and illegal in that location of the HTML content model). [mj]

0.7.6 - 2011-05-17

• Add ability to find widgets with non-integer names in lists. This shouldn’t generally be something that happens, and ideally should be removed if DataGridField looses it’s ‘AA’ and ‘TT’ rows. [lentinj]

0.7.5 - 2011-05-03

• Fix traversal tests on Zope 2.10 to handle TraversalError instead of LocationError. [elro]

• Fix traversal.py syntax to be python2.4 compatible.

• Revert [120798] as it breaks on Zope2.10 / Plone 3.3. We can deal with Zope 2.14 in 0.8.x. [elro]

0.7.4 - 2011-05-03

• Define ‘hidden’ within field macro. [elro]

• Ignore “form.widgets.” if ++widget++ path begins with it. [lentinj]

• Rework traverser to handle lists and subforms [lentinj]

• Only search a group’s widgets if they exist. collective.z3cform.wizard doesn’t create widgets for pages/groups other than the current one [lentinj, elro]

• Deal with forward compatibility with Zope 2.14.

• Adds Brazilian Portuguese translation. [davilima6]

0.7.3 - 2011-03-02

• Handle wrong fieldnames more cleanly in the ++widget++ traverser. [elro]

0.7.2 - 2011-02-17

• Make sure the CRUD add form doesn’t use a standalone template. [davisagli]

0.7.1 - 2011-01-18

• Add zope.app.testing to test dependencies so that it continues to work under Zope 2.13. [esteele]

0.7.0 - 2010-08-04

• Add a marker interface which can be used by widgets to defer any security checks they may be doing when they are set up during traversal with the ++widgets++ namespace [dukebody]

• Fix re-ordering of fields not in the default fieldset. Thanks to Thomas Buchberger for the patch. [optilude]

• Added Norwegian translation. [regebro]

0.6.0 - 2010-04-20

• In the CRUD table, fix odd/even labels, which were reversed. [limi]

• Added slots to the titlelessform macro. See README.txt for details. [optilude, davisagli]

• Remove the distinction between wrapped and unwrapped subforms. A subform is always wrapped by the form that contains it, and can use a Zope 3 page template. [davisagli]

• Fixed tests in Plone 3. [davisagli]

• Fixed tests in Plone 4 [optilude]

• Made it possible to distinguish wrapped and unwrapped forms via the IWrappedForm marker interface. [optilude]

• Made it possible to use z3c.form forms without a FormWrapper in Plone 4. [optilude]

0.5.10 - 2010-02-01

• A z3c.form.form.AddForm do a redirect in its render method. So we have to render the form to see if we have a redirection. In the case of redirection, we don’t render the layout at all. This version remove the contents method on FormWrapper, it’s now an attribute set during the FormWrapper.update. This change fixes status message not shown because it was consumed by the never shown rendered form. [vincentfretin]

0.5.9 - 2010-01-08

• Fix security problem with the ++widget++ namespace [optilude]

0.5.8 - 2009-11-24

• Don’t do the rendering if there is a redirection, use the update/render pattern for that. See http://dev.plone.org/plone/ticket/10022 for an example how to adapt your code, in particular if you used FormWrapper with ViewletBase. [vincentfretin]

0.5.7 - 2009-11-17

• Fix silly doctests so that they don’t break in Python 2.6 / Zope 2.12 [optilude]

0.5.6 - 2009-09-25

• Added title_required msgid in macros.pt to be the same as plone.app.z3cform because macros.pt from plone.app.z3cform uses plone.z3cform translations. Added French translation and fixed German and Dutch translations for label_required and title_required messages. [vincentfretin]

0.5.5 - 2009-07-26

• Removed explicit <includeOverrides /> call from configure.zcml. This causes race condition type errors in ZCML loading when overrides are included later. [optilude]

0.5.4 - 2009-04-17

• Added monkey patch to fix a bug in z3c.form’s ChoiceTerms on z3c.form 1.9.0. [optilude]

• Fix obvious bugs and dodgy naming in SingleCheckBoxWidget. [optilude]

• Use chameleon-based page templates from five.pt if available. [davisagli]

• Copied the basic textlines widget from z3c.form trunk for use until it is released. [davisagli]

0.5.3 - 2008-12-09

• Add translation marker for batch, update translation files. [thefunny42]

• Handle changed signature for widget extract method in z3c.form > 1.9.0 [davisagli]

• Added wildcard support to the ‘before’ and ‘after’ parameters of the fieldset ‘move’ utility function. [davisagli]

• Fixes for Zope 2.12 compatibility. [davisagli]

• Don’t display an ‘Apply changes’ button if you don’t define an update_schema. [thefunny42]

• Declare xmlnamespace into ‘layout.pt’ and ‘subform.pt’ templates

• Added support for an editsubform_factory for an EditForm so you can override the default behavior for a sub form now.

• Changed css in crud-table.pt for a table to “listing” so that tables now look like plone tables.

• Copy translation files to an english folder, so if your browser negociate to en,nl, you will get english translations instead of dutch ones (like expected). [thefunny42]

• Send an event IAfterWidgetUpdateEvent after updating display widgets manually in a CRUD form. [thefunny42]

0.5.2 - 2008-08-28

• Add a namespace traversal adapter that allows traversal to widgets. This is useful for AJAX calls, for example.

0.5.1 - 2008-08-21

• Add batching to plone.z3cform.crud CrudForm.

• Look up the layout template as an IPageTemplate adapter. This means that it is possible for Plone to provide a “Ploneish” default template for forms that don’t opt into this, without those forms having a direct Plone dependency.

• Default to the titleless form template, since the layout template will provide a title anyway.

• In plone.z3cform.layout, allow labels to be defined per form instance, and not only per form class.

0.5.0 - 2008-07-30

• No longer depend on <3.5 of zope.component.

0.4 - 2008-07-25

• Depend on zope.component<3.5 to avoid TypeError("Missing 'provides' attribute") error.

• Allow ICrudForm.add to raise ValidationError, which allows for displaying a user-friendly error message.

• Make the default layout template CMFDefault- compatible.

0.3 - 2008-07-24

• Moved Plone layout wrapper to plone.app.z3cform.layout. If you were using plone.z3cform.base.FormWrapper to get the Plone layout before, you’ll have to use plone.app.z3cform.layout.FormWrapper instead now. (Also, make sure you include plone.app.z3cform’s ZCML in this case.)

• Move out Plone-specific subpackages to plone.app.z3cform. These are:

  • wysywig: Kupu/Plone integration

  • queryselect: use z3c.formwidget.query with Archetypes

  Clean up testing code and development buildout.cfg to not pull in Plone anymore. [nouri]

• Relicensed under the ZPL 2.1 and moved into the Zope repository. [nouri]

• Add German translation. [saily]

0.2 - 2008-06-20

• Fix usage of NumberDataConverter with zope.i18n >= 3.4 as the previous test setup was partial and did not register all adapters from z3c.form (some of them depends on zope >= 3.4) [gotcha, jfroche]

• More tests [gotcha, jfroche]

0.1 - 2008-05-21

• Provide and register default form and subform templates. These allow forms to be used with the style provided in this package without having to declare form = ViewPageTemplateFile('form.pt').

  This does not hinder you from overriding with your own form attribute like usual. You can also still register a more specialized IPageTemplate for your form.

• Add custom FileUploadDataConverter that converts a Zope 2 FileUpload object to a Zope 3 one before handing it to the original implementation. Also add support for different enctypes. [skatja, nouri]

• Added Archetypes reference selection widget (queryselect) [malthe]

• Moved generic Zope 2 compatibility code for z3c.form and a few goodies from Singing & Dancing into this new package. [nouri]