Introduction

Dexterity wants to make some things really easy. These are:

• Create a "real" content type entirely through-the-web without having to know programming.
• As a business user, create a schema using visual or through-the-web tools, and augment it with adapters, event handlers, and other Python code written on the filesystem by a Python programmer.
• Create content types in filesystem code quickly and easily, without losing the ability to customise any aspect of the type and its operation later if required.
• Support general "behaviours" that can be enabled on a custom type in a declarative fashion. Behaviours can be things like title-to-id naming, support for locking or versioning, or sets of standard metadata with associated UI elements.
• Easily package up and distribute content types defined through-the-web, on the filesystem, or using a combination of the two.

Philosophy

Dexterity is designed with a specific philosophy in mind. This can be summarised as follows:

Reuse over reinvention
As far as possible, Dexterity should reuse components and technologies that already exist. More importantly, however, Dexterity should reuse concepts that exist elsewhere. It should be easy to learn Dexterity by analogy, and to work with Dexterity types using familiar APIs and techniques.

Small over big
Mega-frameworks be damned. Dexterity consists of a number of specialised packages, each of which is independently tested and reusable. Furthermore, packages should have as few dependencies as possible, and should declare their dependencies explicitly. This helps keep the design clean and the code manageable.

Natural interaction over excessive generality
The Dexterity design was driven by several use cases that express the way in which we want people to work with Dexterity. The end goal is to make it easy to get started, but also easy to progress from an initial prototype to a complex set of types and associated behaviours through step-wise learning and natural interaction patterns. Dexterity aims to consider its users - be they business analysts, light integrators or Python developers, and be they new or experienced - and cater to them explicitly with obvious, well-documented, natural interaction patterns.

Real code over generated code
Generated code is difficult to understand and difficult to debug when it doesn't work as expected. There is rarely, if ever, any reason to scribble methods or 'exec' strings of Python code.

Zope 3 over Zope 2
Although Dexterity does not pretend to work with non-CMF systems, as many components as possible should work with plain Zope 3, and even where there are dependencies on Zope 2, CMF or Plone, they should - as far as is practical -follow Zope 3 techniques and best practices. Many operations (e.g. managing objects in a folder, creating new objects or manipulating objects through a defined schema) are better designed in Zope 3 than they were in Zope 2.

Zope concepts over new paradigms
We want Dexterity to be "Zope-ish". Zope is a mature, well-designed (well, mostly) and battle tested platform. We do not want to invent brand new paradigms and techniques if we can help it.

Automated testing over wishful thinking
"Everything" should be covered by automated tests. Dexterity necessarily has a lot of moving parts. Untested moving parts tend to come loose and fall on people's heads. Nobody likes that.

Getting started

Please read the installation guide to get Dexterity up and running.

Then log in to Plone, go to Site Setup, and go to the Dexterity Types control panel to get started creating content types through the web.

Or read the Dexterity Developer Manual to get started developing Dexterity content types on the filesystem.

The 2.0.x release series of Dexterity is compatible with and included with Plone 4.3.

Upgrading

If you are upgrading from a previous release of Dexterity, you need to:

1. Update your buildout with the new versions (or extend the updated KGS), and re-run it.
2. Restart Zope.
3. Go to the Add-ons control panel in Plone Site Setup, and run the upgrade steps for "Dexterity Content Types" if there are any available.

Documentation

Various documentation is available:

• Dexterity Developer Manual
• How to create reusable behaviors for Dexterity types

The following documents are not Dexterity-specific, but will likely be useful to users of Dexterity:

• Schema-driven forms manual

Issue tracker

Please report issues via the Plone issue tracker.

Support

Dexterity use questions may be answered via Plone's support channels.

Contributing

Contributors please read the document Process for Plone core's development

Sources are at the Plone code repository hosted at Github.

Dexterity wouldn't be possible without the hard work of a lot of people, including:

• Martin Aspeli
• Jian Aijun
• Wichert Akkerman
• Jonas Baumann
• David Brenneman
• Joel Burton
• Vincent Fretin
• Rok Garbas
• Anthony Gerrard
• Nathan van Gheem
• David Glick
• Craig Haynal
• Wouter Vanden Hove
• Jean-Michel Francois
• Jim Fulton
• Jamie Lentin
• Alex Limi
• Steve McMahon
• Jason Mehring
• Alec Mitchell
• Daniel Nouri
• Ross Patterson
• Maurits van Rees
• Lennart Regebro
• Laurence Rowe
• Israel Saeta Perez
• Hanno Schlichting
• Christian Schneider
• Carsten Senger
• Jon Stahl
• Eric Steele
• Gaudenz Steinlin
• Dorneles Tremea
• Sean Upton
• Sylvain Viollon
• Matthew Wilkes
• Matt Yoder
• Andi Zeidler
• Hector Velarde
• Giacomo Spettoli
• Jens Klein

(Please add your name if we have neglected to.)

Release Notes

Dexterity 2.0 is a major release of Dexterity. It has focused on getting Dexterity included in Plone core, by cleaning things up and making dependencies that are not ready for primetime optional.

Grok-style configuration no longer included by default

Dexterity 1.0 included five.grok to allow configuring components via Python directives rather than in separate XML-based ZCML files. It also included two packages, plone.directives.form and plone.directives.dexterity, to provide some grok-style directives for Dexterity-specific features.

The Dexterity authors still like grok and believe it makes it easier to learn how to customize Plone. However, it has been turned into an optional feature so that Dexterity has a chance to enter Plone core even if the Plone framework team doesn't want to add grok to the already complex stack.

To include these three grok-related packages when you install Dexterity, enable the "grok" extra:

[instance]
eggs =
    plone.app.dexterity [grok]

By the way, a number of schema directives from plone.directives.form that used to require grok to work have been reimplemented so that they work without grok. In particular, the Schema class and the model, fieldset, and primary directives were moved to plone.supermodel.model. The omitted, no_omit, mode, widget, order_before, order_after, read_permission, and write_permission directives were moved to plone.autoform.directives. There are aliases in the old locations so you don't need to update existing code, but you can switch to the new locations if you're trying to avoid depending on grok.

Relation support no longer included by default

Dexterity 1.0 included support for object relations based on the zc.relation catalog and plone.app.relationfield, as well as a behavior (plone.app.dexterity.behaviors.related.IRelatedItems) providing a generic list of related items based on that implementation.

Since this feature was added to Dexterity, we discovered that it will be hard to support this type of relation well in Zope 2 until Zope 2 is setting __parent__ pointers everywhere. In addition, we encountered some problems with using interfaces as keys in the zc.relation catalog. And Dexterity gained support for the Archetypes reference engine in plone.app.referenceablebehavior. As a result of these factors, the zc.relation approach to object relationships will not be included in Dexterity or Plone core for the time being.

VERY IMPORTANT: If you are upgrading a site with Dexterity 1.0 to Dexterity 2.0, it will break unless you install plone.app.relationfield, since your database contains persistent intid and relations utilities. The easiest way to include plone.app.relationfield is to install plone.app.dexterity with the "relations" extra:

[instance]
eggs =
    plone.app.dexterity [relations]

Using relations via plone.app.relationfield

If you were relying on the support for relations, you can re-enable support by installing the plone.app.relationfield package. You need to add it to your package's install_requires in setup.py:

install_requires=[
    'plone.app.relationfield',
    ]

Make sure your package is including its ZCML in configure.zcml:

And install its GenericSetup profile as a dependency in your package's metadata.xml:

  profile-plone.app.relationfield:default

If you have any content types using the IRelatedItems behavior, you should update them to import the behavior from the new location:

    <element value="plone.app.relationfield.behavior.IRelatedItems">
</element>

Content tree and Autocomplete widgets no longer included by default

In Dexterity 1.0, the widgets in plone.formwidget.autocomplete and plone.formwidget.contenttree were installed as dependencies of plone.app.dexterity. In Dexterity 2.0 they are no longer installed by default, because they are not used by any of the included behaviors or made available via the through-the-web content type editor at this time.

If you use these widgets, make sure your package lists them as dependencies in setup.py, loads their ZCML in configure.zcml, and activates their GenericSetup profiles as dependencies in metadata.xml.

Changelog

4.0.2 (2024-10-23)

Internal:

• Update configuration files. [plone devs]

Tests

• port robot tests [1letter] (#393)

4.0.1 (2024-09-03)

Breaking changes:

• plone.app.discussion is now a core addon. The plone.discussion behavior class was moved over there. This is the real reason that 4.0.0 was a breaking release: this is for Plone 6.1 only. [@jensens] (#371)

4.0.0 (2024-05-30)

Bug fixes:

• Remove a DeprecationWarning from a moved p.a.z3cform.widgets import. [@jensens] (#387)

Internal:

• Update configuration files. [plone devs] (6e36bcc4)

3.2.0 (2023-11-03)

Internal:

• Make the dependency on plone.app.content conditional. This is for INameFromTitle, which we want to move to plone.base. [maurits] (#3858)

3.1.2 (2023-10-25)

Internal:

• Update configuration files. [plone devs] (55bda5c9)
• Move some tests to plone.app.content to avoid a circular dependency with that package. [gforcada] (#3858)

3.1.1 (2023-05-22)

Bug fixes:

• Fix transitive circular dependency on plone.app.layout. Use moved imports in plone.base. Move plone.app.layout.nextprevious.interfaces.INextPreviousProvider to .behaviors.nextprevious. Move defaultpage warning viewlet to plone.app.layout. [@jensens] (fix-circular-dep-palayout)

3.1.0 (2023-05-08)

New features:

• Content types control panel: Show behavior name and interface. @ksuess, @stevepiercy (#363)

3.0.5 (2023-04-14)

Bug fixes:

• Fix for searchable Named(Blob)File indexer. Safely convert to str. [petschki] (#362)

Internal:

• Update configuration files. [plone devs] (#47959565)

3.0.4 (2023-02-08)

Bug fixes:

• Restore and deprecate "ModelEditorView.modelSource". It will be removed in Plone 7. [thet] (#359)
• Deprecate ModelEditorView.escaped_model_source which is not needed anymore. It will be removed in Plone 7. [thet] (#359)
• Use the tal engine to escape HTML via non-structure variable insertion. [thet] (#359)

3.0.3 (2022-12-12)

Bug fixes:

• Modeleditor: Don't double escape the xml.

  Use the page template's structure keyword when inserting the escaped HTML into the modeleditor's textarea. This allows the source code pattern to properly parse and display the XML for editing.

  Fixes: #357 (#358)

3.0.2 (2022-12-10)

Bug fixes:

• Fix XMLSyntaxError when saving model source in the modeleditor. [maurits] (#3695)

3.0.1 (2022-12-02)

Bug fixes:

• Remove deprecated imports from plone.app.widgets [petschki] (#355)

3.0.0 (2022-12-02)

Bug fixes:

• Final release for Plone 6.0.0. (#600)

3.0.0b2 (2022-10-04)

Bug fixes:

• Fix folder_listing to show the content ID if no title is available. [jensens] (#353)

3.0.0b1 (2022-07-21)

Bug fixes:

• Tests: add names to behaviors. [maurits] (#169)

3.0.0a11 (2022-05-24)

Bug fixes:

• Rename "Dexterity Content Types" to just "Content Types" [tisto] (#331)
• Don't acquire language from portal root default_language for ICategorization.language. Fixes [jaroel] (#350)

3.0.0a10 (2022-05-09)

Breaking changes:

• Code Style: isort + black. Pyupgrade and six removal. Short name usage of behaviors in tests. Sleep in editing.rst reduced (saves 10sec in tests). Use plone.base. [jensens] (#348)

Bug fixes:

• Make compatible with robotframework 3-5. [maurits] (#5)
• Replaced use of plone.api. That should not be done in Plone core. [maurits] (#346)
• Better naming and description of plone.textindexer in behaviors control panel. [jensens] (#347)

3.0.0a9 (2022-04-07)

Breaking changes:

• Remove JavaScript from this package and move it to Mockup. [thet]

  Modeleditor: Use pat-code-editor from Patternslib instead ACE. Make the model editing form usable without JavaScript. Allow editing the form even with XML errors to be able to fix the problem. [thet] (#334)

New features:

• PLIP 2780: Move features of collective.dexteritytextindexer to core. [zworkb] (#2780)

Bug fixes:

• Remove deprecation warnings after PLIP 3395, some black & isort, some six removal. [jensens] (#345)
• Modeleditor: when there is no model_source yet, show the model_file. [maurits] (#3473)

3.0.0a8 (2022-02-24)

Bug fixes:

• Update the new type icon to svg, the old one was png and the expression as url does not work anymore (must be a icon resolver compatible name). [yurj] (#340)

3.0.0a7 (2022-01-28)

Bug fixes:

• Depend on plone.namedfile core instead of its empty [scales] extra. [maurits] (#106)

3.0.0a6 (2022-01-19)

Bug fixes:

• Fix warning about legacy version specifiers in setup.py. [maurits] (#337)

3.0.0a5 (2022-01-07)

Bug fixes:

• Use the shared 'Plone test setup' and 'Plone test teardown' keywords in Robot tests. [Rotonen] (#292)
• Fix form text. [agitator] (#336)

3.0.0a4 (2021-11-23)

Bug fixes:

• Rename "Dexterity Content Types" to just "Content Types" [timo] (#331)

• Fix broken test for

  [agitator] (#333)

3.0.0a3 (2021-09-15)

Bug fixes:

• Remove cyclic dependency with Products.CMFPlone [ericof] (#329)

3.0.0a2 (2021-08-04)

Bug fixes:

• Update documentation. (#1)

3.0.0a1 (2021-04-20)

Breaking changes:

• Update for Plone 6 with Bootstrap markup [petschki, agitator] (#322)

2.6.9 (2021-01-08)

Bug fixes:

• Fix the constraint types mode calculation, disabling acquisition and gracefully checking for the existence of a portal type attribute in the container (#319)

2.6.8 (2020-11-17)

Bug fixes:

• For increased security, in the modeleditor do not resolve entities, and remove processing instructions. [maurits] (#3209)

2.6.7 (2020-10-30)

Bug fixes:

• Update tests to fix updated schema cache. See [@avoinea, maurits] (#313)

2.6.6 (2020-09-21)

Bug fixes:

• Do not require nextPreviousEnabled (#312)

2.6.5 (2020-04-15)

Bug fixes:

• Make sure getNextItem function returns None if position can not be looked up. [timo] (#308)

2.6.4 (2019-11-25)

Bug fixes:

• Use https links to documentation. [vincentfretin] (#299)
• Update documentation introduction w/r/t archetypes (#301) (#302)
• Fix mr.bob command in documentation (#305)

2.6.3 (2019-06-27)

Bug fixes:

• Update docu for creating dexterity behaviors (#281)
• The @@behaviors form was wrongly encoding the added behavior names on Python3 [ale-rt] (#296)
• Fix tests in Python 3.8 [pbauer] (#298)

2.6.2 (2019-06-19)

Bug fixes:

• Update docu for creating dexterity behaviors (#281)

2.6.1 (2019-05-21)

Bug fixes:

• Moved TTW creation of content types to use and add/remove named behaviors. [iham] (#290)
• Improper naming issue resolved,IBasic.description must be IDublinCore.description [Ritwik Agarwal] (#294)

2.6.0 (2019-04-29)

New features:

• IWidgetsLayer is no longer needed, use IPloneFormLayer instead. Import IFieldPermissionChecker from plone.app.z3cform instead of plone.app.widgets. [jensens] (#268)

Bug fixes:

• Speed up traversal by marking main_template as a browser-view. [pbauer] (#289)

2.5.3 (2019-02-08)

Bug fixes:

• Release upload lock when name chooser fails. [maurits] (#276)
• Import Type Profile fails because code was using StringIO instead of ByteIO (#279)
• Do not acquire constrain_types_mode from parent when not defined [frapell] (#284)

2.5.1 (2018-09-23)

Bug fixes:

• Remove bbb for MessageFactory import. [jensens]
• Python 3 fixes. [jensens, pbauer]

2.5.0 (2018-06-24)

New features:

• Add plone.schema>=1.1.0 as minimal dependency in setup.py. [timo]
• Add JSONField that has been added to plone.schema 1.1.0 to ALLOWED_FIELDS in types.py. [timo]

2.4.10 (2018-06-18)

Bug fixes:

• Python 3 fixes. [pbauer]

2.4.9 (2018-04-03)

Bug fixes:

• Don't break if types are without widgets or groups. Fixes an error with displaying TTW Dexterity types via plone.app.contenttypes full_view. [thet]

2.4.8 (2018-02-04)

Bug fixes:

• Do not fail in upgrade step or tests when portal_quickinstaller is not there. [maurits]
• Python 2 / 3 compatible imports. [vincero]

2.4.7 (2017-10-17)

Bug fixes:

• Make sure robot autologin test fixture is not accidentally torn down when the Dexterity fixture's ZODB sandbox is reverted. [davisagli]

2.4.6 (2017-09-03)

Bug fixes:

• Uniformity with the "Contributors" label. [arsenico13]

2.4.5 (2017-08-27)

Bug fixes:

• Modernized the vocabularies documentation. [jensens]

2.4.4 (2017-07-03)

Bug fixes:

> - The ICategorization behavior should only expose those content > languages which are configured instead of all available languages. > [thetet]

2.4.3 (2017-06-26)

New features:

> add documentation for > plone.app.contenttypes.behaviors.thumb_icon.IThumbIconHandling see > PLIP > [fgrcon]

Bug fixes:

• The ICategorization behavior should only expose those content languages which are configured instead of all available languages. [thet]
• fix typo in deprecation message [tkimnguyen]
• Remove the transaction.begin call before creating a dx object, remove the transaction.commit call after creating a dx object. Fixes #243. [ale-rt]

2.4.2 (2017-05-24)

Bug fixes:

• Cleanup code of permissions.py (ZCA-decorator, reduce complexity) [jensens]
• Fix issue with field permissions check on add forms when the parent has no "Modify portal content" permission. New: For add forms use the "Add portal content" permission as default field permission. As great side effect vocabularies for i.e. AjaxSelectWidget from plone.app.content, which are using the check, are working on add forms in a context w/o "Modify portal content". [jensens]
• removed deprecated getIcon() from documentation [fgrcon]
• JavaScript formatting according to style guides. [thet]

2.4.1 (2017-03-26)

Bug fixes:

• Made exclude_from_nav optional. Fixed #101 [jaroel]

2.4.0 (2017-02-12)

Breaking changes:

• When setting the Description field, do not remove new lines but keep the input as-is. Instead remove new lines in the plone.dexterity Description metadata accessor. [thet]

Bug fixes:

• Do not import IFileFactory in interfaces from plone.app.widgets. It is only imported over there. [jensens]
• Fix tests when using zope.testbrowser 5.0 [davisagli]

2.3.6 (2017-01-20)

New features:

• Add generic version of folder_listing view & macro. Only registered for Plone 5.1, to avoid taking precedence over skin layer templates for Archetypes content in Plone 5.0 [davisagli]

2.3.5 (2016-11-18)

Bug fixes:

• Update code to follow Plone styleguide. [gforcada]
• Documentation: Add dexterity test example using a behavior. [ramiroluz]
• Add a generic version of the folder_listing view so that the container view can use it even without plone.app.contenttypes (such as in tests using the DEXTERITY_FIXTURE) [davisagli]

2.3.4 (2016-10-03)

Bug fixes:

• Replaced secureSend with send in documentation. secureSend has long been deprecated. [maurits]

2.3.3 (2016-09-14)

Bug fixes:

• TTW behaviors selection of the name is now bound to the registration, prior it was bound to the interface. But interfaces may be used by more than one registered behavior. [jensens]

2.3.2 (2016-08-12)

Bug fixes:

• Use zope.interface decorator. [gforcada]

Documentation changes:

• Revised tutorial sections to use mr.bob and bobtemplates.plone rather than ZopeSkel. [smcmahon]

2.3.1 (2016-06-07)

Bug fixes:

• Removed dexterity-types from portal_actions. This is set correctly in controlpanel.xml. Issue

  [maurits]

2.3.0 (2016-05-21)

New features:

• The defaults of exclude from navigation is now obtained from a contextaware default factory, which value is obtained from an adapter. The default adapter returns False. An alternative adapter which defaults to True is provided but not registered. This change makes it possible to provide a custom context specific implementation. [jensens]
• Documentation: Shortnames added and some missing behaviors added. [jensens]

Bug fixes:

• Linebreaks in description are replaced with a space instead of vanishing it. Thus an editor can use them w/o having word glued together afterwards. [jensens]

2.2.0 (2016-04-28)

New:

• Assign short names for all behaviors as supported by plone.behavior. [jensens]

Fixes:

• Remove dups from TTW behavior FTI editor. [jensens]
• Fix problem in ConstrainTypesBehavior: when mode was ENABLED but only setLocallyAllowedTypes were set, then getImmediatelyAddableTypes returned None, but all consuming code expect it to return a list [jensens]
• Lookup of Content Type from MIME-Type for using right Plone Content Type to store Images (especially Tiff) correct as Images not Files. [loechel]

2.1.20 (2016-03-31)

Fixes:

• Docs: Overhaul of chapter form-schema-hints.rst [jensens]
• Use the type ID in HTML classes in the type listing rather than titles. [davidjb]

2.1.19 (2016-02-26)

Fixes:

• Rerelease due to possible brown bag release. [maurits]

2.1.18 (2016-02-26)

Fixes:

• Make the form permission validator a bit more generic so it can be used with non-AddForms. [alecm]

2.1.17 (2016-01-08)

Fixes:

• Update event handler documentation. [jensens]
• Remove unused locales folder, translations are now in plone.app.locales. [vincentfretin]

2.1.16 (2015-12-03)

Fixes:

• Fix wrong usage of MessageFactory [jensens]
• Use plone i18n domain [gforcada]
• Fix non existing self._request with schema.Choice value_type. [pcdummy]

2.1.15 (2015-10-28)

New:

• Updated Traditional Chinese translation. [l34marr]
• Updated Brazil translations. [claytonc]

Fixes:

• Updated doc links in modeleditor. Issue CMFPlone#1027. [pabo3000]
• Fixed icons in dexterity types list. Issues CMFPlone#1013 and CMFPlone#1151. [fgrcon]
• No longer rely on deprecated bobobase_modification_time from Persistence.Persistent. [thet]
• Fixed typos in german translation. Thx bierik for reporting in Issue dexterity#183. [jensens]
• Avoid re-adding the UUID on an upgrade step. [gforcada]

2.1.14 (2015-09-21)

• Updated French translations. [enclope]

2.1.13 (2015-09-20)

• Fixed issue with permission checker add form context. Issue CMFPlone#1027. [alecm]
• Fixed ace editor javascript reference. Issue CMFPlone#895. [rodfersou]
• Rerun i18ndude and updated German translation. [pabo3000]

2.1.12 (2015-09-15)

• Remove unittest2 dependency. [gforcada]

2.1.11 (2015-09-11)

• Updated basque translation [erral]

2.1.10 (2015-09-08)

• Fix modeleditor for Plone 5 [vangheem]

2.1.9 (2015-09-07)

• Restrict allowed field types to regular types (so plone.app.users do not show up) [ebrehault]

2.1.8 (2015-08-20)

• Avoid DeprecationWarning for getIcon and splitSchemaName. [maurits]

2.1.7 (2015-07-18)

• Remove duplicate plone.app.z3cform pin in setup.py. This fixes . [timo]
• Fixed an adapter path at custom add forms documentation. [brunobbbs]
• Change the category of the configlet to 'plone-content'. [sneridagh]
• Unlock before changing id (fixes ). [pbauer]
• Remove superfluous 'for'. Fixes plone/Products.CMFPlone#669. [fulv]
• Schemaeditor does not redirect anymore. [barichu]

2.1.6 (2015-06-05)

• change control panel title to be upper cased [vangheem]
• ignore protected fields when testing addability. [ebrehault]
• Update Japanese translation. [terapyon]

2.1.5 (2015-05-04)

• pat-modal pattern has been renamed to pat-plone-modal [jcbrand]

2.1.4 (2015-03-26)

• Add i18n:domain for Default Page Warning template. [l34marr]
• Update Traditional Chinese translation. [l34marr]

2.1.3 (2015-03-13)

• Code and docs housekeeping: pep8 et al, zca decorators, doc style. [jensens]
• Ensure the default creator value is a unicode string. [lentinj]
• Add facility to import type profiles in zip archives. Added button to types edit page. Import format is identical to export. [smcmahon]
• Update markup and javascript for Plone 5. [davisagli]
• Fix the IDexterityContainer view to make use of plone.app.contenttype's new listing view. Accessing it's macro needs the macro-caller's view variable set to the new listing view. [thet]

2.1.2 (2014-10-23)

• Added transifex-client configuration for manage the translations from Plone transifex organization [macagua].
• Updated Spanish translation [flamelcanto, macagua].
• Add validator to ensure expires date is after effective date. [benniboy]
• Remove line feeds and carriage returns from meta description and added upgrade step to do it for existing content [bosim]
• Fixed issue. Multiple (two or more) acquisition from parent was failing when user didn't have add permission on parent. [keul, cekk]

2.1.1 (2014-04-13)

• Add behavior to let an item's id be edited from its edit form (plone.app.dexterity.behaviors.id.ShortName). [davisagli]
• Cloning of types containing white space did not work, this commit fixes that bug. [bosim]

2.1.0 (2014-03-01)

• Don't throw an error if allowed_content_types is none or missing. Fix [pbauer]
• PLIP #13705: Remove <base> tag. [frapell]

2.0.11 (2013-12-07)

• Fix bug where the type editor's inline javascript was mangled by diazo. [davisagli]
• Fixed Add view URL of cloned content type. Refs . [thomasdesvenain]
• Add robot testing environment and first robot test. [cedricmessiant]
• Better string normalization when setting type id from type title (change accented or special characters with corresponding letters). [cedricmessiant]
• Show a warning when editing the default page of a folder. [davisagli]

2.0.10 (2013-09-16)

• Fix determination of allowed types so it checks permission in the context of the original folder when inheriting allowed types. [davisagli]

2.0.9 (2013-08-13)

• Add documentation for defaultFactory tag in XML ref. [smcmahon]
• Removed line breaks within documentation URLs in modeleditor.py. [smcmahon]
• Fixed XML export so that GenericSetup's parser can successfully parse it later on at install time. [zupo]
• Use @@ploneform-render-widget to render widgets in display mode. [cedricmessiant]
• Call the IBasic description field 'Summary' and give it help text that is actually helpful. [davisagli]
• Don't show the 'Allow Discussion' field on an item's default view. [davisagli]

2.0.8 (2013-05-23)

• Add XML Model Editor based on plone.resourceditor. If plone.resourceditor is available, this is exposed by an "Edit XML Field Model" button on the fields tab of a content type -- if the content type is editable TTW. [smcmahon]
• Added catalan translations [sneridagh]

2.0.7 (2013-04-09)

• Fix bug in determining whether to show the allowed contained type fields. [ericof]
• Let the behavior INameFromFileName also set the title from the filename if the type has such a field and it is left empty. [pbauer]
• Updated french translations. [thomasdesvenain]

2.0.6 (2013-04-06)

• Add missing translation strings. [vincentfretin]

2.0.5 (2013-04-06)

• Updated pt_BR translation [ericof]

2.0.4 (2013-03-05)

• Add zh_TW translation [TsungWei Hu]
• Add support for constraining container allowed content types using the "Restrictions" form in the add menu. Merged from Patrick Gerken's (@do3cc) work in plone.app.contenttypes. [rpatterson]
• When a new type is added, redirect to the fields tab as the next view. [davisagli]
• Don't show the short name as a field on the type overview page. [davisagli]
• Remove the 'Container' checkbox when adding a new type, and default to creating a container. [davisagli]
• Tweaks to type control panel based on user testing. [davisagli]
• Set default language for a new content item based on the language of its container. [frapell]
• Fixed i18n of "Contents" in folder default view. [vincentfretin]
• Added Ukrainian translations [kroman0]

2.0.3 (2013-01-17)

• Nothing changed yet.

2.0.2 (2013-01-01)

• Added French translations [cedricmessiant]
• The behavior controlpanel now correctly invalidates any modified FTIs. [malthe]
• I18n improved by adding many missing strings [giacomos]
• better graphical integration in the control panel [giacomos]
• Allow discussion behavior added. [timo]

2.0.1 (2012-08-31)

• Update MANIFEST.in to correct packaging error. [esteele]

2.0 (2012-08-30)

• DC metadata fields are now correctly encoded and decoded (from byte strings to unicode and vice versa). Currently, UTF-8 is assumed. [malthe]
• Use lxml instead of elementtree. [davisagli]
• Use ViewPageTemplateFile from zope.browserpage. [hannosch]
• Add upgrade step to make sure that only uninstalling plone.app.intid will remove the intids utility. [davisagli]
• Fix traversal over the types context so that skin items used by widgets can be acquired. [davisagli]
• Provide an additionalSchemata property on the schema context so the schema editor can include a preview of fields from behaviors. [davisagli]
• Give a more explicit warning before deleting content types that have existing instances. [davisagli]
• Add validation to prevent giving a type the same name as an existing type. [davisagli]
• Make sure the title and description of new FTIs are stored encoded, and with a default i18n domain of 'plone'. [davisagli]
• Add overview tab for each type in the control panel. [davisagli]
• Added Sphinx source for the Dexterity Developer manual. [giacomos]
• Added Italian translation. [giacomos]
• Internationalized content type settings pages, I18N fixes, messages extraction, French translations. [thomasdesvenain]
• Added Spanish translation. [hvelarde]
• Install the profile from collective.z3cform.datetimewidget to enable the Jquery Tools date picker for date/time fields. [davisagli]
• Bugfix: Make sure type short names are validated. [davisagli]
• Bugfix: Fix display of type descriptions in the types control panel. [davisagli]
• Bugfix: Make sure subject can still be retrieved as unicode for the categorization behavior now that the Subject accessor returns a bytestring. [davisagli]
• Add intro message to Dexterity control panel. [jonstahl, davisagli]
• Grok support is now an optional "grok" extra. Use this if you want five.grok, plone.directives.form, and plone.directives.dexterity. See the release notes for more information. The behaviors in this package were updated to work without using grok. [davisagli]
• plone.formwidget.autocomplete and plone.formwidget.contenttree are no longer included by default. See the release notes for more information. [davisagli]
• Moved the 'Related Items' behavior to plone.app.relationfield. plone.app.relationfield is no longer installed as a dependency. See the release notes for more information including how to update your package if it depends on relation support or the 'Related Items' behavior. IMPORTANT: You must install plone.app.relationfield on sites that are being upgraded from Dexterity 1.0 to Dexterity 2.0, or the site will break. [davisagli]
• Converted tests to plone.app.testing-based setup. The old PloneTestCase-based test case classes and layer are now deprecated. [davisagli]
• Remove ++resource++plone.app.dexterity.overlays.css from the CSS registry. [davisagli]
• Removed support for Plone 3 / CMF 2.1 / Zope 2.10. [davisagli]
• Update dependencies and imports as appropriate for Zope 2.12 & Zope 2.13 [davisagli]
• Remove CDATA section from "browsertypes_listing.pt" (in HTML5: allowed only in SVG/MathML namespaces). [kleist]

1.0 - 2011-05-20

• Fix publishing dates DateTime/datetime conversions so as not to drift by the timezone delta every save. [elro]
• Make sure cloned types get a new factory. [davisagli]
• Don't override overlay CSS in Plone 4. [davisagli]
• Fixed cloning of types with a period (.) in their short name. [davisagli]
• Allow specifying a type's short name when adding a type. [davisagli]
• Make sure the Basic metadata adapter accesses the content's title attribute directly so it doesn't get encoded. Also make sure encoded data can't be set via this adapter. [davisagli]

1.0rc1 - 2011-04-30

• Added upgrade step to install new javascript from plone.formwidget.autocomplete [davisagli]

• Added basic support for making TTW changes to schemas defined in filesystem models and code. (Note: This feature will not actually work until some further changes are completed in plone.dexterity.)

  In order to support this change, the event handling to serialize schema changes was revised. We now register a single event handler for the SchemaModifiedEvent raised for the schema context. This allows us to keep track of the FTI that changes need to be serialized to on the schema context. The serializeSchemaOnFieldEvent and serializeSchemaOnSchemaEvent handlers were removed from the serialize module and replaced by serializeSchemaContext. The serializeSchema helper remains but is deprecated. [davisagli]

• Add MANIFEST.in. [WouterVH]

• Add "export" button to types editor. Exports GS-style zip archive of type info for selected types. [stevem]

• Fix old jquery alias in types_listing.pt. This closes

  [davisagli]

• Make display templates fill content-core on Plone 4. [elro]

• Add ids to the group fieldsets on display forms. [elro]

• Exclude from navigation behavior should be restricted to IDexterityContent. [elro]

1.0b4 - 2011-03-15

• Add a "Name from file name" behavior. [elro]
• Remove the NameFromTitle behavior factory, it is not necessary. [elro]
• Add "Next previous navigation" and "Next previous navigation toggle" behaviors. [elro]
• Add an "Exclude from navigation" behavior. [lentinj]
• Put the folder listing within a fieldset. [lentinj]

1.0b3 - 2011-02-11

• Add a navigation root behavior. [elro]
• Fix decoding error when an encoded description is stored in the FTI. [davisagli]
• Avoid empty <div class="field"> tag for title and description in item.pt and container.pt. [gaudenzius]
• Add locales structure for translations with cs , de, es, eu, fr, ja, nl, pt_BR [toutpt]
• Update french translation [toutpt]

1.0b2 - 2010-08-05

• Fix several XML errors in templates. Needed for Chameleon compatibility. [wichert]

• cloning a type through the dexterity UI in the control panel did not work if the type had a hyphen in it's name. This fixes

  [vangheem]

1.0b1 - 2010-04-20

• Require plone.app.jquerytools for the schema editor UI, and make sure it is installed when upgrading. [davisagli]
• Remove unused schemaeditor.css. [davisagli]
• Omit the metadata fields except on edit and add forms. [davisagli]
• Enable the "Name from title" behavior for new types, by default. [davisagli]
• Include plone.formwidget.namedfile so that File upload and Image fields are available out of the box. You must explicitly include z3c.blobfile in your environment if you want blob-based files. [davisagli]
• Added a DexterityLayer that can be used in tests. [davisagli]
• Fix issue with the BehaviorsForm accidentally polluting the title of the z3c.form EditForm 'Apply' button. [davisagli]
• Add upgrades folder and make sure plone.app.z3cform profile gets installed on upgrades from previous versions of Dexterity. [davisagli]
• Depend on the plone.app.z3cform profile, to make sure the Plone browser layer for z3c.form gets installed. [davisagli]
• Avoid relying on acquisition to get the portal_url for links in the type listing table. [davisagli]

1.0a7 - 2010-01-08

• Make sure the Dublin Core fieldsets appear in the same order as they do in AT content. [davisagli]
• Make sure the current user is loaded as the default creator for the IOwnership schema in an add form. [davisagli]
• Include behavior descriptions on the behavior edit tab. [davisagli]
• IBasic behavior: set missing_value of description-field to u'' . The description should never be None (live_search would not work any more). [jbaumann]
• Fix issue where traversing to a nonexistent type name in the types control panel did not raise NotFound. [davisagli]
• Make it possible to view the fields of non-editable schemata. [davisagli]
• Tweaks to the tabbed_forms template used for the types control panel. [davisagli]

1.0a6 - 2009-10-12

• Add plone.app.textfield as a dependency. We don't use it directly in this package, but users of Dexterity should have it installed and available. [optilude]

• Use some default icons for new types. [davisagli]

• Show type icons in type listing if available. [davisagli]

• Removed 'container' field from the types listing in the control panel (it wasn't working). [davisagli]

• Add message factories to titles and descriptions of metadata schema fields. Fixes . [optilude]

• Patch listActionInfos() instead of listActions() in order to get the folder/add category into the actions list. This avoids a problem with the 'actions.xml' export handler exporting the folder/add category incorrectly. Fixes

  [optilude]

1.0a5 - 2009-07-26

• Explicitly include overrides.zcml from plone.app.z3cform. [optilude]

1.0a4 - 2009-07-12

• Changed API methods and arguments to mixedCase to be more consistent with the rest of Zope. This is a non-backwards-compatible change. Our profuse apologies, but it's now or never. 😕

  If you find that you get import errors or unknown keyword arguments in your code, please change names from foo_bar too fooBar, e.g. serialize_schema() becomes serializeSchema(). [optilude]

1.0a3 - 2009-06-07

• Updated use of <plone:behavior /> directive to match plone.behavior 1.0b4. [optilude]

1.0a2 - 2009-06-01

• Remove superfluous <includeOverrides /> in configure.zcml which would cause a problem when the package is loaded via z3c.autoinclude.plugin [optilude]

1.0a1 - 2009-05-27

• Initial release