= quintagroup.portlet.cumulus = [[PageOutline]] == Links == * Home page - http://quintagroup.com/services/plone-development/products/quintagroup.portlet.cumulus/ * Releases - http://plone.org/products/quintagroup.portlet.cumulus/releases and http://pypi.python.org/pypi/quintagroup.portlet.cumulus * SVN repository - http://svn.quintagroup.com/products/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/zopectl 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. [[Image(tags.png, nolink)]] * 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. [[Image(screenshot.jpeg, nolink)]] == 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 [[Image(options.jpeg, nolink)]] [[Image(options1.jpeg, nolink)]] == Supported Plone versions == * 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. === Where can I find more information? === WP-Cumulus WordPress plugin homepage: http://wordpress.org/extend/plugins/wp-cumulus/.