wiki:quintagroup.portlet.cumulus

quintagroup.portlet.cumulus

Overview

quintagroup.portlet.cumulus allows to add tag cloud portlets to your Plone site. Your site's tags can be displayed in a portlet Flash movie that rotates them in 3D. It works just like a regular tags cloud, but is more visually exciting. This is the WordPress? WP-Cumulus plugin ported to Plone as a portlet.

When you add this portlet anywhere in the site it will display all site's tags. If you have QuillsEnabled? product installed, this portlet will display only blog's tags when rendered inside blog.

Installation

quintagroup.portlet.cumulus can be installed in the same way as othe packages for Plone. So to install quintagroup.portlet.cumulus to you buildout installation:

  • add 'quintagroup.portlet.cumulus' to the list of eggs to install (buildout.cfg file):
 [buildout]
   ...
   eggs = ...
          quintagroup.portlet.cumulus
  • add 'quintagroup.portlet.cumulus' to ZCML (buildout.cfg file):
  [instance]
   ...
   zcml = ...
          quintagroup.portlet.cumulus
  • Re-run buildout, e.g. with:
  $ ./bin/buildout
  • Restart Zope server process, for example, with the following command in the terminal:
  $ ./bin/instance restart

  • Install Tag cloud (cumulus) portlet with Quickinstaller in Plone.

Usage

First of all, you have to provide tags/keywords for site's content items: you can do this on the item's edit form in the Categorization tab. All tags from both Existing tags and New tags will be taken for cumulus portlet generation.

  • On the page you want to add such portlet go to portlet management area and select 'Tag Cloud (cumulus) portlet from Add portlet... drop-down menu
  • Provide your own values for portlet configuration (see detailed explanation below)
  • Save changes
  • The portlet will now display a cloud of keywords/tags used on your Plone site.

DEMO

See DEMO of Cumulus Portlet on a Plone 4 site - http://quintagroup.com/cms/screencasts/cumulus-portlet

Cumulus Portlet options

It is possible to set cumulus portlet options so that it fits your site design, color scheme etc. When you create cumulus portlet you can specify:

  • Width and height of the flash tag cloud portlet
  • Smallest and largest tag size
  • Main and optionally second color of the tags for creating multi-colored tag cloud
  • Optional highlight color when mouse is over it and background portlet color
  • Transparent or compatibility mode
  • Rotation speed

Supported Plone versions

  • Plone 4.1
  • Plone 4.0
  • Plone 3.x

FAQ

From what version of WP-Cumulus WordPress? plugin this product was ported?

It's ported from WP-Cumulus 1.20.

Some characters are not showing up

Because of the way Flash handles text, only Latin characters are supported in the current version. This is due to a limitation where in order to be able to animate text fields smoothly the glyphs need to be embedded in the movie. The Flash movie's source code is available for download through Subversion. Doing so will allow you to create a version for your language. There's a text field in the root of the movie that you can use to embed more characters. If you change to another font, you'll need to edit the Tag class as well.

See instructions for fixing this at How to add more characters to WP-Cumulus article.

Where can I find more information?

WP-Cumulus WordPress? plugin homepage: http://wordpress.org/extend/plugins/wp-cumulus/.

Last modified 6 years ago Last modified on Oct 31, 2011 12:08:59 PM

Attachments (4)

Download all attachments as: .zip