collective.categorizing 0.2.3

collective.categorizing aims to add hierarchical categorizing to Plone with Category content type.

Introduction

Contents in Plone can be categorized by subjects (keywords) with collection machinery. However, it does not support hierarchical categorizing and backward categorizing. It is also not aware of languages.

collective.categorizing aims to provide easy to categorize with all those functions supported.

This package is tested with Plone-3.3rc4.

Changelog

0.2.3 - (2009-08-20)

• French translation added [toutpt]

0.2.2 - (2009-07-13)

• Needless resource directories deleted.

0.2.1 - (2009-07-12)

• Category portlet header and footer link fixed.

0.2.0 - (2009-07-11)

• Categories portlet added.

• Some bug fixes.

0.1.1 - (2009-07-09)

• Japanese translations added.

0.1.0 - (2009-07-08)

• Initial release

Installation

To install collective.categorizing into the global Python environment (or a workingenv), using a traditional Zope 2 instance, you can do this:

• When you’re reading this you have probably already run easy_install collective.categorizing. Find out how to install setuptools (and EasyInstall) here: http://peak.telecommunity.com/DevCenter/EasyInstall

• If you are using Zope 2.9 (not 2.10), get pythonproducts and install it via:

  python setup.py install --home /path/to/instance

into your Zope instance.

• Create a file called collective.categorizing-configure.zcml in the /path/to/instance/etc/package-includes directory. The file should only contain this:

  <include package="collective.categorizing" />

Alternatively, if you are using zc.buildout and the plone.recipe.zope2instance recipe to manage your project, you can do this:

• Add collective.categorizing to the list of eggs to install, e.g.:

  [buildout]

  …

  eggs =

  …

  collective.categorizing

• Tell the plone.recipe.zope2instance recipe to install a ZCML slug:

  [instance]

  recipe = plone.recipe.zope2instance

  …

  zcml =

  collective.categorizing

• Re-run buildout, e.g. with:

  $ ./bin/buildout

You can skip the ZCML slug if you are going to explicitly include the package from another package’s configure.zcml file.

HOWTO

This part of document describes how to categorize contents in a plone site.

1. Once you have installed this package, you can add CategoryContainer content type. Add it any ware within a folderish content type. You need to select content types to be categorized when you add the CategoryContainer. All the plone default content type should be shown there. Those content types you have selected and which resides in the same parent folderish content type (Parent Folder) as CategoryContainer will be categorized.

   Example

   To categorize all the Document content type of the plone site, add the CategoryContainer exactly under the plone root and select Documet in the “Content Type” field of CategoryContainer.

2. Add Category (Let’s call this, Category A) content type to CategoryContainer. You may also add another Category (Category B) to already added Category A. Category B is now subcategory of Category A. If you have another Cateogry (Category C), which is not hierarchically subcategory of Category A, but still want to make it as a subcategory of Category A, you may refer it from edit page of Category A at the field of subcategory.

3. If you already have content types which surpposed to be categorized, they are already categorized. If you don’t have one, add one to a Parent Folder or any subfolders of the Parent Folder.

4. The categorized contents now have a new tab called whatever you have input to CategoryContainer’s Title. There you see to which category the content belongs and can be updated through the page.

TODO

• Event subsriber when moving categories should be done more clean way. Right now, category which causes hierarchy looping would be deleted when looping happens.

• Hierarchy level (depth) is not activated yet.

• Category portlet to view hierarchically must be nice to add.

• Make ReferenceBrowserWidget Language aware.

• Make amount of contents in a category shown.