Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
Python Shell

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.
Products
docs
.coveragerc
.gitignore
.travis.yml
MANIFEST.in
README.rst
bootstrap.py
buildout.cfg
setup.cfg
setup.py
travis.cfg

README.rst

Travis CI badge Coveralls badge Downloads

Plone Keyword Manager

Plone Keyword Manager allows you to change, merge and delete keywords (aka tags or subjects) in Plone and updates all corresponding objects automatically. It uses a similiarity search to support you in identifying similar keywords. PloneKeywordManager helps you to build an inductive vocabulary with several people working on the same Plone site. Keywords can be cleaned up from time to time by a site-manager to create a consistent vocabulary.

Plone Keyword Manager is a quite simple solution to a major problem in the real world use of Plone: If you can't work with restricted vocbularies, your keyword-vocabulary will get duplicate entries very quickly - depending on your authors' interpretation of existing keywords.

Installation

In your buildout add Products.PloneKeywordManager to your instances eggs section or policy packages setup.py. If you want similiarity search add Products.PloneKeywordManager`[Levenshtein] instead.

Run buildout. Activate it at Site Setups Add Ons page.

Usage

After installing, you will find an entry in Site Setup a section called Keyword Manager. Inside, you will see an alphabetical listing and a selection for all keywords existing in your site.

Use the last one to see similar terms for a single keyword. Use the former one if you want to see a list of all keywords starting with letter 'b', click it. The Plone Keyword Manager will then search all keywords starting with 'b' and will also look for similar keywords. You can now select several keywords and delete them for example. If you only want to change a single keyword, select it, then enter the new keyword and click on merge. If you want to merge several keywords into one new one, select them, enter the new keyword and click on merge.

The last selected keyword is entered automatically into the textbox if JavaScript is enabled. This may be irritating at first glance, but you'll learn to appreciate quite fast. If you use it the right way, you don't have to copy&paste into the textbox. Try it yourself, you'll get the idea behind it...

For developer and integrator

You can also use KeywordManager to import your keywords with GenericSetup. You must have access to the file system to do this.

  • Add a file keywords.txt to the directory Products/PloneKeywordManager/profiles/default, with one keyword per line.
  • In the ZMI, go to portal_setup, Import tab. Locate the step called Create or update keywords. Check the box next to it, then click the button Import Selected Steps.

This will add or update a Document titled Keywords (with ID keyword) in the root of the Plone site; this document will have all the listed keywords assigned to it.

Leave this document in the private state so only an administrator will be able to see and edit it.

Each time you run this import step, the Keywords document's keywords will be completely replaced with the contents of the keywords.txt file.

Source Code

Source code of this project is in the Plone Collective

For instructions how to contribute please read the Collective Information Page

Further development focuses on Plone 4.2 and higher.

Credits

PloneKeywordManager was mainly coded by Maik Jablonski during the Plone Paderborn Sprint (September 2003), founded by the Bertelsmann Foundation.

Main code -- Maik Jablonski

User Interface updates and Setup Code -- Alexander Limi from Plone Solutions.

Thanks to Joe Geldart from "Netalley Networks":http://www.netalleynetworks.com for updating the template to Plone 2.0 format.

We would also like to thank Maik for letting us put this code in the Collective - so it can be improved and expanded by the Collective developers.

Something went wrong with that request. Please try again.