skip to navigation
skip to content

Not Logged In

collective.datagridcolumns 0.3.2

Additional columns for Plone and DataGridField

Latest Version: 0.6.2

Introduction

This is an additional set of column types for DatagridField product for Plone.

New columns

TextAreaColumn

Like the base Column type, just display a textarea HTML element.

Additional parameters:

rows
Default: 3. Number of rows of the textarea.
cols
Default: 0. Number of columns of the textarea. If not provided the html cols attribute is omitted and an inline style "width: 100%" wil be used instead.

Example:

...
DataGridField('foo',
          columns=("type", "description"),
          widget = DataGridWidget(
                    columns={
                         'type' : Column(_(u"Type")),
                         'description' : TextAreaColumn(_(u"Description"),
                                                        rows=10,
                                                        cols=20),
                    },
         ),
),
...

SelectColumn

Like the default SelectColumn from DataGridField product, but explicitly support the vocabulary_factory way to provide vocabularies.

Additional parameters:

vocabulary_factory
Provide the name of a registered vocabulary using a Zope Component Utility. See the Archetypes Develop Manual for more.
vocabulary
As default SelectColumn, required only if you don't provide vocabulary_factory. Use this to call a method on the context to obtain the vocabulary.

Example:

...
DataGridField('foo',
          columns=("type", "description"),
          widget = DataGridWidget(
                    columns={
                         'type' : SelectColumn(_(u"Type"),
                                               vocabulary_factory='plone.app.vocabularies.PortalTypes'),
                         'description' : Column(_(u"Description"),),
                    },
         ),
),
...

Note: the base SelectColumn of DataGridField 1.8 already have some kind of support for Zope-3-like vocabularies, however the use of it is not clean (and this version also works on Plone 3).

ReferenceColumn

This is a complex column type that store an unique object "UID". The default view rendering of this column will display a proper link to the referenced object.

You can use this is different ways. In the simpler example, just use it as a textual column:

...
DataGridField('foo',
          columns=("uid", "comment"),
          widget = DataGridWidget(
                    columns={
                         'uid' : ReferenceColumn(_(u"Reference")),
                         'comment' : Column(_(u"Comment")),
                    },
         ),
),
...

So you are on your own to store a propert UID in the field (not very interesting, isn't it?).

If you want something more, you can enable an additional JavaScript module and you'll get an autocomplete feature of referenced objects:

...
DataGridField('foo',
          columns=("uid", "comment"),
          widget = DataGridWidget(
                    helper_js= ('datagridwidget.js', 'datagridautocomplete.js'),
                    columns={
                         'uid' : ReferenceColumn(_(u"Reference")),
                         'comment' : Column(_(u"Comment")),
                    },
         ),
),
...

So you will add to the default datagridwidget.js (automatically provided by the widget) a new datagridautocomplete.js ones.

When using autocomplete text field, you can query Plone in two different way:

  • starting a query with the "/" character will query documents by path, so you can manually surf the whole site.
  • starting as query with other character will perform a full-text query on titles.

This will required jQueryUI autocomplete. Please, read also the "Dependencies" section below.

Additional parameters:

object_provides
When using the full-text query, only return results of objects that provide those interfaces. Default is an empty list (no filter).
surf_site
Choose to be able to surf the site tree using a "/dir/dir/..." term. Default to True (allowed).
search_site
Choose to be able to search items in the site by full-text query or not. Default to True (allowed).

Dependencies

This product has been tested on Plone 3.3 and DataGridField 1.6. Tests and feedback with Plone 4 and DataGridField 1.8 are welcome!

jQuery

The ReferenceColumn need jQuery 1.4.1 or better to work. Plone 3.3 is shipped with jQuery 1.3. You can fix this dependency by your how, or using a 3rd party library.

An alternative Generic Setup import step ("DataGridField: register jQuery 1.4") is provided with the product. Run this and the default Plone jQuery version will be disabled, then a 1.4 version will be registered.

Do not run this on Plone 4!

jQueryUI

A column above need that Plone provide jQueryUI library. This product will not cover this requirement, even by dependency.

If you have already jQueryUI autocomplete behaviour in your Plone site, you are already ok.

If you need it, take a look at collective.jqueryui.autocomplete (or read it's documentation page to understand how cover this need).

Authors

This product was developed by RedTurtle Technology team.

RedTurtle Technology Site

Contribute!

You are welcome to help us, contributing and adding new columns!

Credits

Developed with the support of Regione Emilia Romagna; Regione Emilia Romagna supports the PloneGov initiative.

Changelog

0.3.2 (2012-10-17)

  • Fixed a bug introduced with version 0.3. See #1 [keul]

0.3.1 (2012-06-27)

  • Fixed manifest and readme [cekk]

0.3.0 (2012-06-27)

  • ReferenceColumn - added base Column default paremeters: default_method, label_msgid, required [cekk]

0.2.0 (2012-01-30)

  • ReferenceColumn - added an alternative jQuery library, installable using a separate Generic Setup profile [keul]
  • ReferenceColumn - fulltext search is now restricted to the path of the calling context [keul]
  • ReferenceColumn - URL where to perform AJAX call is taken from a ICallingContextProvider adapter. 3rd party products can provide a more specific one than the default (that still call the portal url) [keul]

0.1.1 (2012-01-12)

  • ReferenceColumn - fixed bug that when saving empty new row it will save a random site content [keul]
  • ReferenceColumn - Added surf_site and search_site parameters [keul]

0.1.0 (2011-12-01)

  • Initial release
 
File Type Py Version Uploaded on Size
collective.datagridcolumns-0.3.2.zip (md5) Source 2012-10-17 59KB
  • Downloads (All Versions):
  • 49 downloads in the last day
  • 330 downloads in the last week
  • 1470 downloads in the last month