Summary
-------
The tag cube allows to add labels to an entity as a simple yet
powerful way to classify your content. Tags can be used to refine a
search using facets.
It is a CubicWeb component. CubicWeb is a semantic web application
framework, see http://www.cubicweb.org
Install
-------
Auto-install from sources is preferred with *pip/Distribute*::
pip install cubicweb-tag
If you have troubles, use *easy_install/setuptools* and eggs::
easy_install cubicweb-tag
You can install the package manually from the uncompressed
`tarball <http://www.cubicweb.org/project/cubicweb-tag>`_::
python setup.py install # auto-install dependencies
If you don't want the dependencies to be installed automatically, you
can force the setup to use the standard library *distutils*::
NO_SETUPTOOLS=1 python setup.py install
More details at http://www.cubicweb.org/doc/en/admin/setup
Usage
-----
To allow tags on an entity type, you must allow the `tags` relation between `Tag`
and your entity type(s).
For instance to activate the tag functionality on Person, Company and Division
entity type, one should add to his schema:
.. sourcecode:: python
from yams.buildobjs import RelationDefinition
class tags(RelationDefinition):
subject = 'Tag'
object = ('Person', 'Company', 'Division')
You should then see the tags box appearing on the primary view for entities of
those type. The`TagsBox` display tags applied to the entity but also provides
an easily way to add / remove tags, if you've the permission to do so.
More views
----------
- The `SimilarEntitiesBox` shows some entities which share the most tags together
- The `TagsCloudView`, a classical, displaying a set of tags appearing more or
less big according to the number of tagged entities. It's used by the
`TagsCouldBox`, which is not visible by default (user can activate it using
their preferences) but that you can activate by default using the code snippet below:
.. sourcecode:: python
from cubicweb_tag.views import TagsCloudBox
# make the tags cloud box visible by default
TagsCloudBox.visible = True
- The primary view for tags provides a tags merging interface to site administrators,
very useful to manage tags on a site where people tend to express the same thing with
different words, or spelling.
Documentation
-------------
Look in the ``doc/`` subdirectory or read
http://www.cubicweb.org/doc/en/
Raw data
{
"_id": null,
"home_page": "https://forge.extranet.logilab.fr/cubicweb/cubes/cubicweb-tag",
"name": "cubicweb-tag",
"maintainer": "",
"docs_url": null,
"requires_python": "",
"maintainer_email": "",
"keywords": "",
"author": "Logilab",
"author_email": "contact@logilab.fr",
"download_url": "https://files.pythonhosted.org/packages/cd/52/35f42330336bd4e20f9f4d53e287ab48ce1b9fecce7a3c5da3f062ed4961/cubicweb-tag-3.0.0.tar.gz",
"platform": null,
"description": "Summary\n-------\n\nThe tag cube allows to add labels to an entity as a simple yet\npowerful way to classify your content. Tags can be used to refine a\nsearch using facets.\n\nIt is a CubicWeb component. CubicWeb is a semantic web application\nframework, see http://www.cubicweb.org\n\nInstall\n-------\n\nAuto-install from sources is preferred with *pip/Distribute*::\n\n pip install cubicweb-tag\n\nIf you have troubles, use *easy_install/setuptools* and eggs::\n\n easy_install cubicweb-tag\n\nYou can install the package manually from the uncompressed\n`tarball <http://www.cubicweb.org/project/cubicweb-tag>`_::\n\n python setup.py install # auto-install dependencies\n\nIf you don't want the dependencies to be installed automatically, you\ncan force the setup to use the standard library *distutils*::\n\n NO_SETUPTOOLS=1 python setup.py install\n\nMore details at http://www.cubicweb.org/doc/en/admin/setup\n\nUsage\n-----\n\nTo allow tags on an entity type, you must allow the `tags` relation between `Tag`\nand your entity type(s).\n\nFor instance to activate the tag functionality on Person, Company and Division\nentity type, one should add to his schema:\n\n.. sourcecode:: python\n\n from yams.buildobjs import RelationDefinition\n class tags(RelationDefinition):\n subject = 'Tag'\n object = ('Person', 'Company', 'Division')\n\nYou should then see the tags box appearing on the primary view for entities of\nthose type. The`TagsBox` display tags applied to the entity but also provides\nan easily way to add / remove tags, if you've the permission to do so.\n\nMore views\n----------\n- The `SimilarEntitiesBox` shows some entities which share the most tags together\n\n- The `TagsCloudView`, a classical, displaying a set of tags appearing more or\n less big according to the number of tagged entities. It's used by the\n `TagsCouldBox`, which is not visible by default (user can activate it using\n their preferences) but that you can activate by default using the code snippet below:\n\n .. sourcecode:: python\n\n from cubicweb_tag.views import TagsCloudBox\n # make the tags cloud box visible by default\n TagsCloudBox.visible = True\n\n- The primary view for tags provides a tags merging interface to site administrators,\n very useful to manage tags on a site where people tend to express the same thing with\n different words, or spelling.\n\nDocumentation\n-------------\n\nLook in the ``doc/`` subdirectory or read\nhttp://www.cubicweb.org/doc/en/\n",
"bugtrack_url": null,
"license": "LGPL",
"summary": "tag component for the CubicWeb framework",
"version": "3.0.0",
"project_urls": {
"Homepage": "https://forge.extranet.logilab.fr/cubicweb/cubes/cubicweb-tag"
},
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "c51c5836c0510e3ea49c7425b51c691275eccffdeee1e8f3de13eb620919dfee",
"md5": "9d4f99e1c5aa0c3883b9408e3c6ccb5f",
"sha256": "d29ac01f0c932fe078b8200dc7f074a358359d653b3cb31145f2e803d2ed6122"
},
"downloads": -1,
"filename": "cubicweb_tag-3.0.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "9d4f99e1c5aa0c3883b9408e3c6ccb5f",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 45490,
"upload_time": "2023-08-02T13:43:35",
"upload_time_iso_8601": "2023-08-02T13:43:35.808367Z",
"url": "https://files.pythonhosted.org/packages/c5/1c/5836c0510e3ea49c7425b51c691275eccffdeee1e8f3de13eb620919dfee/cubicweb_tag-3.0.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "cd5235f42330336bd4e20f9f4d53e287ab48ce1b9fecce7a3c5da3f062ed4961",
"md5": "fabfa454d40ea06c7d12974a62e9a75c",
"sha256": "b6698194330390c3037de4645bfcbe51d12411b3cb3bcab37ade48fd257ad7c6"
},
"downloads": -1,
"filename": "cubicweb-tag-3.0.0.tar.gz",
"has_sig": false,
"md5_digest": "fabfa454d40ea06c7d12974a62e9a75c",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 46311,
"upload_time": "2023-08-02T13:43:37",
"upload_time_iso_8601": "2023-08-02T13:43:37.203681Z",
"url": "https://files.pythonhosted.org/packages/cd/52/35f42330336bd4e20f9f4d53e287ab48ce1b9fecce7a3c5da3f062ed4961/cubicweb-tag-3.0.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-08-02 13:43:37",
"github": false,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"lcname": "cubicweb-tag"
}