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
SiteAreas and getSiteAreas metadata
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:
reindex “SiteAreas” index from portal_catalog in ZMI
launch a view that update metadatas for all items in the catalog with a selected taxonomy: http://your-plone-site/@@fix-metadata
SearchableText index
With 1.5.0 version, SiteAreas categorization is also saved in SearchableText index.
To update the catalog entries before this change, there is a view that reindex SearchableText for all contents in the catalog with a SiteArea: http://your-plone-site/@@fix-searchabletext
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.
Changelog
1.4.1 (2016-06-30)
Make taxonomy categorization searchable in SearchableText index. We don’t provide an upgrade step to update old stored contents because it could be a very slow task and it’s better to do it in a separate task (maybe with a script or pdb). [cekk]
1.4.0 (2012-10-12)
Added utility view that update metadata infos [cekk]
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
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Hashes for collective.taxonomysupport-1.4.1.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | d0a12a5469f21e93543a2a90dec0d7af7756b0abc8d49d54dbc294147fa9f591 |
|
MD5 | 315678802b6b0557d5ef321e405572df |
|
BLAKE2b-256 | 0dd77a1ec8726d32ec18e5edcf3e795cd0329707376e917285c0b23c21f72722 |