Skip to main content

Tagging add-on for Plone

Project description

Overview

ftw.tagging extends Plone content types with a tags field using schemaextender for Archetype or a behavior for Dexterity.

It’s possible to define tag roots to restrict tags to a part of the site. If no tag root is set, the Plone-root will also be your tag-root.

A tag cloud portlet is provided that shows a tag cloud for the current tag root.

As an example, ftw.tagging is used by ftw.blog for tagging blog entries.

Install

  • Add ftw.tagging to your buildout configuration:

[instance]
eggs =
  ftw.tagging
  • Run buildout

  • Install ftw.tagging in portal_setup

Usage

Enable tagging on your AT types:

<class class="path.to.my.class">
  <implements interface="ftw.tagging.interfaces.tagging.ITaggable" />
</class>

Enable tagging on your DX types with a behavior:

<property name="behaviors" purge="False">
  <element value="ftw.tagging.behavior.ITagging" />
</property>

Optionally define tag roots (AT or DX):

<class class="path.to.my.class">
  <implements interface="ftw.tagging.interfaces.tagging.ITagRoot" />
</class>

For DX, you could alternatively use a behavior to define tag roots:

<property name="behaviors" purge="False">
  <element value="ftw.tagging.interfaces.tagging.ITagRoot" />
</property>

Tag Cloud

You can show the tag-cloud by adding the tag-cloud portlet provided by this package.

Compatibility

Runs with Plone 4.3.

Changelog

1.2.0 (2018-12-10)

  • Fix DecodeUnicodeError in the tag cloud portlet. [mbaechtold]

  • Convert index values to UTF8 byte strings. [mbaechtold]

  • Remove superfluous space after linked tag. [mbaechtold]

  • Drop support for Plone 4.2. [mbaechtold]

  • Add support for Dexterity. [mbaechtold]

  • Drop Plone 4.0 and 4.1 support. [jone]

1.1.1 (2014-09-23)

  • Lowering tags for sorting. [mathias.leimgruber]

1.1.0 (2013-08-29)

  • Add Spanish translations. [spanish]

1.0.3 (2013-04-17)

  • Updates in tests, readme and buildout. [jone]

1.0.2 (2012-02-28)

  • Fixed MANIFEST.in: Include README.rst, no longer exclude .mo files. [Thomas Buchberger]

1.0.1 (2012-02-27)

  • Add english translations. [jone]

1.0 (2011-02-25)

  • Made getTagRootTags() method more robust and more efficient. [buchi]

1.0b1

  • Fix portlet html structure [mathias.leimgruber]

1.0a3

1.0a2

  • Fixed MANIFEST.in - again [jone]

1.0a1

  • Fixed MANIFEST.in [jone]

0.1

  • 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

ftw.tagging-1.2.0.tar.gz (26.2 kB view hashes)

Uploaded Source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page