collective.taxonomysupport

by Luca Fabbri last modified Oct 12, 2012 08:53 AM

Add support for taxonomies to Plone contents as a news tag-like field

Project Description

What is this?

This product add a new field to all Plone contents (someway similar to the keyword field) that allow to select one or more taxonomies to reference.

A Taxonomy is commonly like normal folder and you can create them all around the site. They gives only some differences when you add additional contents inside them (but to select a taxonomy for a content you don't need that the content is inside it).

Also the taxonomy support must be explicitly enabled on the site root and/or in one or many of the site's subsections. In this way you can have different taxonomies set in different areas of the site.

The list of taxonomies selectable on simple contents is filtered locally if there are different sections activated.

The activation to one section block the inheritance of other taxonomies from upper levels.

Filtering policies are the following:

  • if there isn't any parent of the object that implements the "ITaxonomyLevel" interface, no taxonomy will be shown and so no one are selectable.
  • if there are one or more parents that provides the interface, we take the nearest parent and search its availables taxonomies.
  • if there aren't taxonomies, or there isn't any activated object (object that implements ITaxonomyLevel interface; it could be also the site root) the field doesn't appears in the field edit form.
  • if an object is created inside a taxonomy, the taxonomy will be the default value in the field.

How to use?

To activate the taxonomy level you can access the "Add to taxonomy roots" in the "Action" menu.

Create Taxonomy folders normally in the site.

You can also mark any other object as a Taxonomy-like but to do this you need to manually apply the collective.taxonomysupport.interfaces.IFolderTaxonomy interface.

Collection criteria

This product add also a new collection criteria (Site Areas) for easilly use taxonomies in (old-style) collections.

Updating the catalog

Taxonomies stores 2 indexes in catalog: getSiteAreas and SiteAreas.

The first index stores a list of uids fo selected taxonomies of an object, and the second (SiteAreas) stores the titles of selected taxonomies, for a human-usage. If you need to update the all catalog (or even rebuild it), "SiteAreas" indexes and metadata will be partially inconsistent because the indexer method make a catalog query to get the taxonomy right titles, so you need to do 2 more steps:

Dependencies

This product has been tested on:

  • Plone 3.3
  • Plone 4.2

Credits

Developed with the support of Regione Emilia Romagna;

Regione Emilia Romagna supports the PloneGov initiative.

Authors

This product was developed by RedTurtle Technology team.

RedTurtle Technology Site

Changelog

1.4.0 (2012-10-12)

  • Added utility view that update metadata infos for

1.3.1 (2012-08-07)

  • Added catalog.xml for "SiteAreas" metadata [andrea]
  • Add modify to handle default page case and add test [lucabel]
  • Add import permission.zcml from CMFCore in case of plone4 [lucabel]
  • Update test to works on plone 4

1.3.0 (2012-08-02)

  • Added Plone 4.2 compatibility
  • updated documentation [keul]
  • fixed translations [keul]
  • added proper i18ndude script [keul]
  • Add action to mark/unmark taxonomy root [lucabel]

1.2.0 (2011-09-27)

  • changed product to allow all contents to be a taxonomy, implementing IFolderTaxonomy [andrea]
  • added tinyMCE configuration for FolderTaxonomy content [mirco]

1.1.0 (Unreleased)

  • version 1.0.2 was bad; partial rever of changes [keul]
  • added a new collection criterion, only for Taxonomy [keul]
  • fixed translations [keul]

1.0.2 (2010-11-12)

  • when used for collections, show all Taxonomy, not only the used ones [keul]

1.0.1 (2010-09-27)

  • collective.taxonomysupport was breaking some contents like EasyNewsletter [keul]

1.0.0

  • Initial release

Self-Certification

[X] Internationalized

[ ] Unit tests

[X] End-user documentation

[X] Internal documentation (documentation, interfaces, etc.)

[X] Existed and maintained for at least 6 months

[ ] Installs and uninstalls cleanly

[ ] Code structure follows best practice

Current Release
collective.taxonomysupport 1.4.0

Released Oct 12, 2012 — tested with Plone 4.2, Plone 4.1, Plone 4, Plone 3

added view to update metadata in catalog
More about this release…

Download file Get collective.taxonomysupport for all platforms
collective.taxonomysupport-1.4.0.zip
If you are using Plone 3.2 or higher, you probably want to install this product with buildout. See our tutorial on installing add-on products with buildout for more information.

All Releases

Version Released Description Compatibility Licenses Status
1.4.0 Oct 12, 2012 added view to update metadata in catalog More about this release…
Plone 4.2
Plone 4.1
Plone 4
Plone 3
GPL final
1.3.1 Aug 07, 2012 Compatibility with Plone 4.2 More about this release…
Plone 4.2
Plone 4.1
Plone 4
Plone 3
GPL final
1.3.0 First public release (liberated code) More about this release…
Plone 4.2
Plone 4.1
Plone 4
Plone 3
GPL beta