The goal of plone.app.widgets is to provide an implementation for a new set of javascript widgets being developed outside Plone as part of Mockup project. It overrides explicit widgets used in dexterity and archetypes to provide tested and modularized widgets based on the concept of patterns.

Contents

• Versions
• Is safe to use this package?
• What is included?
• Installation

Versions

2.x is only to be used with Plone 5 and 1.x is to be used in Plone 4.3.

Is safe to use this package?

This package should be safe to install and easy to uninstall (there is also uninstall profile). That means its fairly safe to give it a try, but just in case don't forget to create backup before testing it.

As of version 1.4.0 there is quite comprehensive unittest coverage of python code as well as high coverage of our javascript code. There are also some robot tests which are testing integration with Plone, but this will be improved with future releases.

This project will be integrated with Plone 5 and will never reach version 2.0.0. You can monitor progress of PLIP here.

If you wonder why there is no Alpha/Beta marker in version, its because version of this package is kept in sync with other projects deriving from Mockup (eg. plone.app.toolbar). Version 1.4.1 would then mean we're using Mockup version 1.4 and there was one bugfix only to the python code. Version packaged javascript inside is still in sync with Mockup project.

What is included?

The fields that are using updated widgets are:

• Tags field (AjaxSelectWidget)
• Language field (SelectWidget)
• Effective date field (DatetimeWidget)
• Expire date field (DatetimeWidget)
• Contributors field (AjaxSelectWidget)
• Creators field (AjaxSelectWidget)
• Related items field (RelatedItemsWidget)
• Query string field (QueryStringWidget) in case plone.app.contenttypes is installed.

All client side code (javascript/css/images) is done and tested as part of Mockup project.

For any feature / bug / comment please create an issue in the issue tracker.

Installation

For now only tested with latest Plone 4.3:

[buildout]
extends =
    http://dist.plone.org/release/4.3-latest/versions.cfg
    https://raw.github.com/plone/plone.app.widgets/master/versions.cfg
versions = versions
parts = instance

[instance]
recipe = plone.recipe.zope2instance
user = admin:admin
http-address = 8080
eggs =
    Pillow
    Plone
    plone.app.widgets[archetypes,dexterity]
zcml =
    plone.app.widgets

Make sure you install the "Plone Widgets" profile when creating your Plone site or include plone.app.widgets:default profile in your metadata.xml..