collective.labels 3.0.0a1

A Plone addon for labels.

collective.labels

A Plone addon for labels.

Containers, Folders for example, can be marked as label container. For each label container a set of labels with colors can be defined. Items whithin this container which support labelling can then be labelled with one or more labels.

Fork of ftw.labels that was unmaintained see https://github.com/4teamwork/ftw.labels/issues/67

Screenshots

Managing labels on the label container (ILabelJar):

Set label for a content (ILabelSupport):

Installation

• Add collective.labels to your buildout configuration:

[instance]
eggs +=
    collective.labels

• Install the generic setup profile of collective.labels.

Usage / Integration

Add the ILabelJar marker interface to any container class you want:

<class class="Products.ATContentTypes.content.folder.ATFolder">
    <implements interface="collective.labels.interfaces.ILabelRoot" />
</class>

For objects providing ILabelJar a left-column-portlet is added on the root of the Plone site which allows to manage labels.

Add the ILabelSupport marker interface to any item you want to be able to set labels on:

<class class="plone.app.blob.content.ATBlob">
    <implements interface="collective.labels.interfaces.ILabelSupport" />
</class>

For objects providing ILabelSupport a right-column-portlet is added on the root of the Plone site which allows to manage labels.

Add the ILabelJarChild marker interface to any container class to display the labels stored in a parents ILabelJar

<class class="Products.ATContentTypes.content.folder.ATFolder">
    <implements interface="collective.labels.interfaces.ILabelJarChild" />
</class>

For objects providing ILabelJarChild you can manage and store the same labels as defined in the ILabelJar content without defining a new ILabelRoot

Uninstall

The package provides an uninstall mechanism. Use Plone’s addon control panel or portal_quickInstaller to uninstall the package.

Links

• Github: https://github.com/collective/collective.labels

• Issues: https://github.com/collective/collective.labels/issues

• Pypi: http://pypi.python.org/pypi/collective.labels

• Continuous integration: https://jenkins.4teamwork.ch/search?q=collective.labels

Copyright

This package was created by 4teamwork.

collective.labels is licensed under GNU General Public License, version 2.

Changelog

3.0.0a1 (2025-09-19)

• Rename the package into collective.labels [mpeeters]

2.0.1 (2019-11-26)

• Corrected bug when removing multiple personal labels, if one is not assigned. [sgeulette]

2.0.0 (2019-10-15)

• Replaced string by list parameter in ILabeling pers_update method. [sgeulette]

1.3.1 (2018-10-02)

• Add upgrade step to migrate from 1.2.x version to 1.3.1 (Transform PersistentList in PersistentMapping and Add ‘by_user’ key to False in jar) [anuyens]

1.3.0 (2018-04-25)

• Labels can also be set user by user, not only globally. [sgeulette]

1.2.1 (2018-02-12)

• Set applyPrefix=”True” for “++resource++collective.labels/select2.css” in cssregistry.xml. [gbastien]

1.2.0 (2018-02-02)

• Added French translations. [gbastien]

• Redirect to HTTP_REFERER instead context.absolute_url after a label is added using the labejar portlet. [gbastien]

• Display ‘Edit labels’ title when hovering edit labels icon. [gbastien]

1.1.1 (2017-02-09)

• Fix labeljar portlet if you use it without collective.table. The javascript for the collective.table-integration was executed even if you don’t have an collective.table. [elioschmutz]

1.1.0 (2016-03-21)

• Add statusmessage instead of raising an error if the user does not choose a title for a new lable. [elioschmutz]

• Fix portelt structure. Adjust it to plone default structure. https://github.com/4teamwork/collective.labels/issues/43 [elioschmutz]

• Add ILabelJarChild interface to inherit labels of a parents ILabelJar https://github.com/4teamwork/collective.labels/issues/41 [elioschmutz]

• Do not show label configuration button for not permitted users. https://github.com/4teamwork/collective.labels/issues/39 [elioschmutz]

• Do not redirect to referer when updating the labels jar. The referer is usually the form submitting the change. [jone]

1.0.2 (2014-06-24)

• Hide portlet for unprivileged users when there are no labels. [jone]

1.0.1 (2014-06-23)

• Fix edit label link permission check in labels jar portlet. [jone]

• Fix edit link permission check in labeling viewlet. [jone]

1.0.0 (2014-06-18)

• Initial implementation. [elioschmutz, jone]