Skip to main content
Pre-release

This release is a pre-release and may not be stable for production use.

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):

https://raw.github.com/collective/collective.labels/master/docs/label_jar.png

Set label for a content (ILabelSupport):

https://raw.github.com/collective/collective.labels/master/docs/label_support.png

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.

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)

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]

Release files for collective.labels 3.0.0a1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for collective.labels 3.0.0a1
File Size Uploaded
collective.labels-3.0.0a1.tar.gz 309.2 kB Details

Release files / collective.labels-3.0.0a1.tar.gz

Download URL collective.labels-3.0.0a1.tar.gz
Size 309.2 kB
Tags Source
SHA-256 checksum
How to use checksums
b49765cd9ccc9b03bf72f282633e3feec95f596d58118c8ab07c49066d6e35e3
BLAKE2b-256 checksum
How to use checksums
41634fad5e3009228105ba426f72edecdf0e2f5b0079a030502c3f8a7672edb7
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/3.1.1 pkginfo/1.4.2 requests/2.23.0 setuptools/65.7.0 requests-toolbelt/0.9.1 tqdm/4.40.0 CPython/3.8.18

Release history Release notifications | RSS feed

This release

3.0.0a1 This release

1 release file

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page