Skip to main content

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

Project description

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.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
collective.categorizing-0.2.3.tar.gz (31.7 kB) Copy SHA256 hash SHA256 Source None

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page