Tagging add-on for Plone
Python CSS
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
docs
ftw
.gitignore
MANIFEST.in
README.rst
bootstrap.py
development.cfg
setup.py
sources.cfg
test-plone-4.3.x.cfg

README.rst

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.

Links

Copyright

This package is copyright by 4teamwork.

ftw.tagging is licensed under GNU General Public License, version 2.