Welcome, guest | Sign In | My Account | Store | Cart

Notice! PyPM is being replaced with the ActiveState Platform, which enhances PyPM’s build and deploy capabilities. Create your free Platform account to download ActivePython or customize Python with the packages you require and get automatic updates.

pypm install collective.taxonomysupport

How to install collective.taxonomysupport

  1. Download and install ActivePython
  2. Open Command Prompt
  3. Type pypm install collective.taxonomysupport
 Python 2.7Python 3.2Python 3.3
Windows (32-bit)
Windows (64-bit)
Mac OS X (10.5+)
Linux (32-bit)
1.4.0 Available View build log
1.3.1 Available View build log
Linux (64-bit)
1.4.0 Available View build log
1.3.1 Available View build log
Lastest release
version 1.4.0 on Nov 26th, 2012

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:


This product has been tested on:

  • Plone 3.3
  • Plone 4.2


Developed with the support of Regione Emilia Romagna;

Regione Emilia Romagna supports the PloneGov initiative.


This product was developed by RedTurtle Technology team.

RedTurtle Technology Site


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]
  • Initial release

Subscribe to package updates

Last updated Nov 26th, 2012

Download Stats

Last month:2

What does the lock icon mean?

Builds marked with a lock icon are only available via PyPM to users with a current ActivePython Business Edition subscription.

Need custom builds or support?

ActivePython Enterprise Edition guarantees priority access to technical support, indemnification, expert consulting and quality-assured language builds.

Plan on re-distributing ActivePython?

Get re-distribution rights and eliminate legal risks with ActivePython OEM Edition.