collective.labels


Namecollective.labels JSON
Version 3.0.0a1 PyPI version JSON
download
home_pagehttps://github.com/collective/collective.labels
SummaryA Plone addon for labels.
upload_time2025-09-19 11:20:39
maintainerNone
docs_urlNone
author4teamwork AG
requires_pythonNone
licenseGPL2
keywords collective labels
VCS
bugtrack_url
requirements zc.buildout packaging pip setuptools wheel
Travis-CI No Travis.
coveralls test coverage No coveralls.
            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``):

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


Set label for a content (``ILabelSupport``):

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



Installation
------------

- Add ``collective.labels`` to your buildout configuration:

.. code:: rst

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

.. code:: xml

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

.. code:: xml

    <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``

.. code:: xml

    <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 <http://www.4teamwork.ch/>`_.

``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]

            

Raw data

            {
    "_id": null,
    "home_page": "https://github.com/collective/collective.labels",
    "name": "collective.labels",
    "maintainer": null,
    "docs_url": null,
    "requires_python": null,
    "maintainer_email": null,
    "keywords": "collective labels",
    "author": "4teamwork AG",
    "author_email": "mailto:info@4teamwork.ch",
    "download_url": "https://files.pythonhosted.org/packages/41/63/4fad5e3009228105ba426f72edecdf0e2f5b0079a030502c3f8a7672edb7/collective.labels-3.0.0a1.tar.gz",
    "platform": null,
    "description": "collective.labels\n=================\n\nA Plone addon for labels.\n\nContainers, Folders for example, can be marked as label container.\nFor each label container a set of labels with colors can be defined.\nItems whithin this container which support labelling can then be labelled\nwith one or more labels.\n\nFork of ftw.labels that was unmaintained see https://github.com/4teamwork/ftw.labels/issues/67\n\n\nScreenshots\n-----------\n\nManaging labels on the label container (``ILabelJar``):\n\n.. image:: https://raw.github.com/collective/collective.labels/master/docs/label_jar.png\n\n\nSet label for a content (``ILabelSupport``):\n\n.. image:: https://raw.github.com/collective/collective.labels/master/docs/label_support.png\n\n\n\nInstallation\n------------\n\n- Add ``collective.labels`` to your buildout configuration:\n\n.. code:: rst\n\n    [instance]\n    eggs +=\n        collective.labels\n\n- Install the generic setup profile of ``collective.labels``.\n\n\nUsage / Integration\n-------------------\n\nAdd the ``ILabelJar`` marker interface to any container class you want:\n\n.. code:: xml\n\n    <class class=\"Products.ATContentTypes.content.folder.ATFolder\">\n        <implements interface=\"collective.labels.interfaces.ILabelRoot\" />\n    </class>\n\nFor objects providing ``ILabelJar`` a left-column-portlet is added\non the root of the Plone site which allows to manage labels.\n\n\nAdd the ``ILabelSupport`` marker interface to any item you want to be able to\nset labels on:\n\n.. code:: xml\n\n    <class class=\"plone.app.blob.content.ATBlob\">\n        <implements interface=\"collective.labels.interfaces.ILabelSupport\" />\n    </class>\n\nFor objects providing ``ILabelSupport`` a right-column-portlet is added\non the root of the Plone site which allows to manage labels.\n\n\nAdd the ``ILabelJarChild`` marker interface to any container class to\ndisplay the labels stored in a parents ``ILabelJar``\n\n.. code:: xml\n\n    <class class=\"Products.ATContentTypes.content.folder.ATFolder\">\n        <implements interface=\"collective.labels.interfaces.ILabelJarChild\" />\n    </class>\n\nFor objects providing ``ILabelJarChild`` you can manage and store the\nsame labels as defined in the ``ILabelJar`` content without defining\na new ``ILabelRoot``\n\n\nUninstall\n---------\n\nThe package provides an uninstall mechanism.\nUse Plone's addon control panel or portal_quickInstaller to uninstall\nthe package.\n\n\n\nLinks\n-----\n\n- Github: https://github.com/collective/collective.labels\n- Issues: https://github.com/collective/collective.labels/issues\n- Pypi: http://pypi.python.org/pypi/collective.labels\n- Continuous integration: https://jenkins.4teamwork.ch/search?q=collective.labels\n\n\nCopyright\n---------\n\nThis package was created by `4teamwork <http://www.4teamwork.ch/>`_.\n\n``collective.labels`` is licensed under GNU General Public License, version 2.\n\nChangelog\n=========\n\n\n3.0.0a1 (2025-09-19)\n--------------------\n\n- Rename the package into collective.labels\n  [mpeeters]\n\n\n2.0.1 (2019-11-26)\n------------------\n\n- Corrected bug when removing multiple personal labels, if one is not assigned.\n  [sgeulette]\n\n2.0.0 (2019-10-15)\n------------------\n\n- Replaced string by list parameter in ILabeling pers_update method.\n  [sgeulette]\n\n1.3.1 (2018-10-02)\n------------------\n\n- Add upgrade step to migrate from 1.2.x version to 1.3.1 (Transform PersistentList in PersistentMapping\n  and Add 'by_user' key to False in jar)\n  [anuyens]\n\n1.3.0 (2018-04-25)\n------------------\n\n- Labels can also be set user by user, not only globally.\n  [sgeulette]\n\n1.2.1 (2018-02-12)\n------------------\n\n- Set applyPrefix=\"True\" for \"++resource++collective.labels/select2.css\"\n  in cssregistry.xml.\n  [gbastien]\n\n1.2.0 (2018-02-02)\n------------------\n\n- Added French translations.\n  [gbastien]\n- Redirect to HTTP_REFERER instead context.absolute_url after a label is\n  added using the labejar portlet.\n  [gbastien]\n- Display 'Edit labels' title when hovering edit labels icon.\n  [gbastien]\n\n1.1.1 (2017-02-09)\n------------------\n\n- Fix labeljar portlet if you use it without collective.table.\n  The javascript for the collective.table-integration was executed\n  even if you don't have an collective.table.\n  [elioschmutz]\n\n\n1.1.0 (2016-03-21)\n------------------\n\n- Add statusmessage instead of raising an error if the user\n  does not choose a title for a new lable.\n  [elioschmutz]\n\n- Fix portelt structure.\n  Adjust it to plone default structure.\n  https://github.com/4teamwork/collective.labels/issues/43\n  [elioschmutz]\n\n- Add ILabelJarChild interface to inherit labels of a parents ILabelJar\n  https://github.com/4teamwork/collective.labels/issues/41\n  [elioschmutz]\n\n- Do not show label configuration button for not permitted users.\n  https://github.com/4teamwork/collective.labels/issues/39\n  [elioschmutz]\n\n- Do not redirect to referer when updating the labels jar.\n  The referer is usually the form submitting the change.\n  [jone]\n\n\n1.0.2 (2014-06-24)\n------------------\n\n- Hide portlet for unprivileged users when there are no labels.\n  [jone]\n\n\n1.0.1 (2014-06-23)\n------------------\n\n- Fix edit label link permission check in labels jar portlet.\n  [jone]\n\n- Fix edit link permission check in labeling viewlet.\n  [jone]\n\n\n1.0.0 (2014-06-18)\n------------------\n\n- Initial implementation.\n  [elioschmutz, jone]\n",
    "bugtrack_url": null,
    "license": "GPL2",
    "summary": "A Plone addon for labels.",
    "version": "3.0.0a1",
    "project_urls": {
        "Homepage": "https://github.com/collective/collective.labels"
    },
    "split_keywords": [
        "collective",
        "labels"
    ],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "41634fad5e3009228105ba426f72edecdf0e2f5b0079a030502c3f8a7672edb7",
                "md5": "8a7dbc82fef20536bd5c6eb0e8c84fda",
                "sha256": "b49765cd9ccc9b03bf72f282633e3feec95f596d58118c8ab07c49066d6e35e3"
            },
            "downloads": -1,
            "filename": "collective.labels-3.0.0a1.tar.gz",
            "has_sig": false,
            "md5_digest": "8a7dbc82fef20536bd5c6eb0e8c84fda",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": null,
            "size": 309205,
            "upload_time": "2025-09-19T11:20:39",
            "upload_time_iso_8601": "2025-09-19T11:20:39.127942Z",
            "url": "https://files.pythonhosted.org/packages/41/63/4fad5e3009228105ba426f72edecdf0e2f5b0079a030502c3f8a7672edb7/collective.labels-3.0.0a1.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2025-09-19 11:20:39",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "collective",
    "github_project": "collective.labels",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": false,
    "requirements": [
        {
            "name": "zc.buildout",
            "specs": [
                [
                    "==",
                    "4.1.12"
                ]
            ]
        },
        {
            "name": "packaging",
            "specs": [
                [
                    "==",
                    "24.2"
                ]
            ]
        },
        {
            "name": "pip",
            "specs": [
                [
                    "==",
                    "25.0.1"
                ]
            ]
        },
        {
            "name": "setuptools",
            "specs": [
                [
                    "==",
                    "75.8.2"
                ]
            ]
        },
        {
            "name": "wheel",
            "specs": [
                [
                    "==",
                    "0.45.1"
                ]
            ]
        }
    ],
    "lcname": "collective.labels"
}
        
Elapsed time: 1.55889s