Cumulus plugin

• Download the Plugin
• Bugs / Feature Wishes
• Source Repository

This plugin enables you to use a Flash movie to display a nice rotating 3D word/tag cloud, for example Roy Tanck's movie. A special feature is the ability to display all root namespaces of your Wiki installation.

Step 1. Download and install the plugin using the Plugin Manager using the URL given above. Refer to Plugins on how to install plugins manually.

Step 2. Find latest version of, for example Roy Tanck's Flash movie, a file called “tagcloud.swf” and put it in the plugin folder.

..dokuwiki/lib/plugins/cumulus/

	The Flash movie is NOT included in the download

This inconvenience because the Roy's Flash movie is released under GPL v3 and I'm a little bit hesitant to include it in the download. This plugin just plays any file called “tagcloud.swf” in the plugin folder .

~~CUMULUS[&flag=value]~~

• flag can be one or several (separated by & ) of:
  • max — Maximum number of words displayed
  • width — Width in pixels (500 or more is recommended)
  • height — Height in pixels (ideally around 3/4 of the width)
  • tcolor — Color of the tags (6 char HEX color value without the ‘#’ prefix)
  • tcolor2 — Optional second color for gradient between small and large font links (6 char HEX color value without the ‘#’ prefix)
  • hicolor — Optional highlight color (6 char HEX color value without the ‘#’ prefix)
  • bgcolor — Background color (6 char HEX color value without the ‘#’ prefix)
  • trans — Background transparency (true|false)
  • distr — Distribute tags evenly on sphere (true|false)
  • speed — Rotation speed (percentage, default is 100)
  • show — By default a word cloud is displayed. By using show=tag the plugin shows tags from the tag plugin instead. The alternative show=namespace displays all namespaces in the wiki root.

Example:

~~CUMULUS&max=20&bgcolor=000000&distr=true&show=tags~~

All properties described above can also be set in the configuration manager.

showtags — The plugin always includes all tags as standard HTML <a> links in a hidden <div> for SEO purposes but this setting decides if it should be visible as a “standard” tag cloud if the users browser doesn't support Flash 9 movies. The cloud will have same CSS class as the cloud.

The code itself is pretty straight forward. It's an example how to use DokuWiki core function html_flashobject() to play a Flash movie.

• Better handling of missing flash file (2010/01/26 23:21)
• First commit (2010/01/26 21:37)

English is included. If you make a translation to another language I'm happy to include it, use Git, mail me or paste it on this page.

Thank you for inspiration Roy Tanck. Gina Häußge, Michael Klier and Esther Brunner has also contributed by making the Cloud plugin.

Maybe I'm doing something wrong: I just get a black square. When clicking right mouse I see “No film loaded”. If I take the example with ”~~WP-CUMULUS …~~” there is just this text rendered. Doing without “WP-” gives the black square. So what am I doing wrong? Karl

First I'm sorry for the typo in the example, it should be ”~~CUMULUS …~~”. Then the issue of the black square.
Do you have the file ”..dokuwiki/lib/plugins/cumulus/tagcloud.swf” as described under Download and Installation?
— HåkanS 2010/02/06 19:06

Thank You for the hint with the typo. The issue of the black square: The tagcloud.swf is at the right place as described under Download and Installation.
— Karl 2010/02/06 21:22
I'm just a newbie to PHP. When looking in syntax.php I found at line 29 this: ” $this→Lexer→addSpecialPattern('~~\w*?CUMULUS.*?~~',$mode,'plugin_cumulus');” Don't know if this has to do with my problem regarding the original example?
— Karl 2010/02/06 22:28

Probably a path issue, are you using some kind of rewrite. The plugin tries to load the flash movie from http:<yourserver>/lib/plugins/cumulus/tagcloud.swf > — HåkanS 2010/02/13 20:00