=== Plugin Name ===
Contributors: weefselkweekje, LukeMorton
Donate link: http://www.roytanck.com/about-my-themes/donations/
Tags: tag cloud, flash, sphere, categories, widget, tags, 3D, cloud
Requires at least: 2.3
Tested up to: 2.9
Stable tag: 1.23
WP-Cumulus displays your tags and/or categories in 3D by placing them on a rotating sphere.
== Description ==
WP-Cumulus allows you to display your site's tags, categories or both using a Flash movie that rotates them in 3D. It works just like a regular tags cloud, but is more visually exciting. Clicking the tags can be a little hard (depending on your speed setting) but does take you to the appropriate page :).
The sources code for the Flash movie are available from wordpress.org.
== Installation ==
= Installation =
1. Make sure you're running WordPress version 2.3 or better. It won't work with older versions.
1. Download the zip file and extract the contents.
1. Upload the 'wp-cumulus' folder to your plugins directory (wp-content/plugins/).
1. Activate the plugin through the 'plugins' page in WP.
1. See 'Options->WP Cumulus' to adjust things like display size, etc...
= In order to actually display the tag cloud, you have three options. =
1. Create a page or post and type [wp-cumulus] anywhere in the content. This 'tag' will be replaced by the flash movie when viewing the page. See [here](http://www.roytanck.com/2009/03/11/how-to-use-wp-cumulus-shortcodes/) for more info.
1. Add the following code anywhere in your theme to display the cloud. `<?php wp_cumulus_insert(); ?>` This can be used to add WP Cumulus to your sidebar, although it may not actually be wide enough in many cases to keep the tags readable.
1. The plugin adds a widget, so you can place it on your sidebar through 'Appearance'->'Widgets'. Open the widget to access it's own set of settings (background color, size, etc).
== Frequently Asked Questions ==
= My theme/site appears not to like this plugin. It's not displaying correctly. =
There are a number of things that may prevent WP-Cumulus from displaying or cause it to display a short message about how it needs the Flash plugin.
* In 99% of all cases where this happens the issue is caused by markup errors in the page where the plugin is used. Please validate your blog using [validator.w3.org](http://validator.w3.org) and fix any errors you may encounter.
* Older versions had issues with PHP 5.2 (or better). This has been fixed, so please upgrade to the latest version.
* The plugin requires Flash Player 9 or better and javascript. Please make sure you have both.
* There have been some cases where WordPress' Automatic Plugin Upgrade feature breaks the plugin. After upgrading the plugin the Flash movie file would be corrupt for some users. If this happens to you, please try disabling and reinstalling the plugin (through FTP).
* Please try using the 'compatibility mode' if you're using version 1.20 or better. Although it's better to fix whatever is causing the issues with the normal mode, this can be used as a workaround solution.
= Hey, but what about SEO? =
I'm not sure how beneficial tag clouds are when it comes to SEO, but just in case WP Cumulus outputs the regular tag cloud (and/or categories listing) for non-flash users. This means that search engines will see the same links. They're hidden through CSS by default, but there's an options to make them visible.
= I'd like to change something in the Flash movie, will you release the .fla? =
As of version 1.12 the source code is available from wordpress.org under the GPL license. Click "other versions" and get the developer version.
= Some of my tags occasionally hit the sides of the movie and are cropped =
If this happens you should change the aspect for the movie to make it wider. This can be done by increasing the width, but also by decreasing the height. Both will make the movie 'more landscape' giving long tags more room.
= 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.
More info [here](http://www.roytanck.com/2008/08/04/how-to-add-more-characters-to-wp-cumulus/).
= When I click on tags, nothing happens. =
This is usually caused by a Flash security feature that affects movies served from another domain as the surrounding page. If your blog is http://yourblog.com, but you have http://www.yourblog.com listed as the 'WordPress address' under Settings -> General this issue can occur. In this case you should adjust this setting to match your blog's actual URL. If you haven't already, I recommend you decide on a single URL for your blog and redirect visitors using other options. This will increase your search engine ranking and in the process help solve this issue :).
= I'm not using WordPress... =
* Steve Springett has ported this to Movable Type. More info over on [his site](http://www.6000rpms.com/blog/2008/04/04/flash-tag-cloud-for-mt-4.html).
* Michael Robinson has ported WP-Cumulus to RapidWeaver, see his tutorial [here](http://pagesofinterest.net/mikes/blog_of_interest_files/tag_cloud.php).
* Amanda Fazani managed to get Cumulus working on Blogger. More info on Blogumus [here](http://www.bloggerbuster.com/2008/08/blogumus-flash-animated-label-cloud-for.html).
* Yannick Lejeune has done a [TypePad version](http://www.yannicklejeune.com/2008/09/tumulus-wp-cumu.html) based in part on Steve's work.
* Christian Philipp's created a [TYPO3 version](http://typo3.org/extensions/repository/view/t3m_cumulus_tagcloud/current/).
* Rob Antonishen did a [Serendipity version](http://spartacus.s9y.org/index.php?mode=bygroups_event_en) (search for serendipity\_event\_freetag).
* Big Bear maintains the [Joomla version](http://joomlabear.com/Joomulus/).
* Pratul Kalia and Bj�rn Jacob have ported it to [Drupal](http://drupal.org/project/cumulus).
* Ryan Tomlinson has a [BlogEngine.NET version](http://www.99atoms.com/post/BlogCumulusNET-A-flash-based-tag-cloud.aspx).
* Colin Seymour has created a [Habari version](http://www.lildude.co.uk/projects/hb-cumulus/).
* Andreas Scherer uses [DasBlog](http://www.scherer.as/blog/).
* Jean-Yves Zinsou did an [eZ version](http://ez.no/developer/contribs/applications/ezcumulus).
* [Simple Tags](http://utilitees.silenz.org/index.php/notes/page/simple-tags-1.6.3/), an Expression Engien addon can now display tags using Cumulus. Thanks Oliver Heine.
* Catchpen ported Cumulus to [Social Web CMS](http://forums.socialwebcms.com/index.php?topic=672.0).
* Domi create a [PHP-Fusion](http://www.venue.nu/forum/viewthread.php?thread_id=672) port.
* [Bysoft](http://www.bysoft.fr/) did a [Magento](http://www.magentocommerce.com/extension/925/3d-advanced-tags-clouds-based-on-wp-cumulus--admin-manager-by-bysoft) version.
* Benjamin Anseaume created a [Sweetcron](http://www.anseaume.com/items/site/anseaume.com) version.
* Austin created a [phpBB](http://www.phpbb.com/community/viewtopic.php?f=70&t=1861475) version.
* Gautam Gupta managed to get Cumulus working in [bbPress](http://bbpress.org/plugins/topic/bb-cumulus/).
* BLEUnLIVE ported WP-Cumulus to [Tistory](http://zoc.kr/639).
* I wrote [this post](http://www.roytanck.com/2008/05/19/how-to-repurpose-my-tag-cloud-flash-movie/) on how to use the flash movie in other contexts.
This list is far from complete. Chances are you'll find the port you need through search engines. If you're having trouble setting it up, please contact the author(s) of the port.
== Screenshots ==