=== Configurable Tag Cloud (CTC) Widget ===
Contributors: zarathos
Tags: tags, tag cloud, widget
Requires at least: 2.3
Tested up to: 2.3
Stable tag: trunk

Display a tag cloud customized with your preferences in the sidebar. 

== Description ==

NOTE!!!  This widget is for Wordpress 2.3 ONLY!  It relies on the new tagging
features of WP 2.3, so if you're still on 2.2, this won't work for you.  I
suggest you upgrade as soon as possible.

The best new feature in Wordpress 2.3 is the integration of tagging into the core
of Wordpress. However, the tag cloud widget that is included leaves a lot to be
desired. So, with time on my hands, I decided to whip up my own version of the tag
cloud widget that lets you configure the tag cloud with all the customizations (well,
almost, see below) the tag cloud template tag allows.

You can find the widget home page (and leave comments) [here](http://reciprocity.be/ctc/).

== Installation ==
1. Upload `tag-cloud.php` to the `/wp-content/plugins/` directory (I like to keep all
   my widgets in a "widgets" folder under plugins, which works just fine). 
2. Activate `Configurable Tag Cloud` through the 'Plugins' menu in Wordpress.
3. Go to the `Widgets` control panel, and drag the `CTC` button into your sidebar list,
   and configure the options to your liking.  If you want to keep the defaults for the
   widget, just leave everything as-is (see below for caveats).

== Changelog ==

You can always find the most up-to-date information about the widget [here](http://reciprocity.be/ctc/).


    Version Date       Changes
    2.51    2007/10/19 *Fix:* Fixed bug that prevented tag count options
 					   from working.  It came down to a bad variable
					   name. Thank you to Paul & Joel for reporting the
					   bug.

    2.5     2007/10/16 *Change:* Added div surrounding tag cloud for
					   styling purposes.  Thanks to everyone who
					   suggested it.
					   *Fix:* Fixed bug that would produce "Divide by zero"
					   errors on display if you didn't input anything for
					   smallest and/or largest font size in config form.
					   Thanks to Ryan for uncovering this whopper.

    2.0     2007/10/03 *Change:* Added code necessary to enable coloring tag
					   links by weight.
					   *Change:* Stopped using Wordpress-native tag cloud
					   function in favor of internal widget function to
					   generate tag cloud (required for color).
					   *Change:* Removed `array` format.  I'm not sure it
					   would be of any use running in a widget, but if you
					   need it, the call to add it to the dropdown can be found
					   commented out at line 217 in tag-cloud.php.
					   *Change:* Added brief help text to the right of each
					   field in the form.

    1.0     2007/09/22 Initial release of widget.  Relied on WP tag cloud
					   function to generate cloud.

Thanks to all who sent bug reports and ideas for improvements.
Please send me a mail if I forgot you to mention here.

== Frequently Asked Questions ==

= Why are my tags black? =

The function I'm using to generate the colors for the tag gradient will return
#000000 (black) if either (or both) of the color fields in the config form are
left blank.  If you want your tags to be the same color as the other links
in your page, please set both color fields to your preferred color.

= Will this work without widgets support? =

At the moment, no.  I am planning on adding standard WP plugin capabilities,
but for now, you must have a theme that supports widgets in order to use CTC.

== Screenshots ==
1. Configuration Form
2. Sample Output ("My Tags" as title, color gradient from #c0c0c0 to #000000, font gradient from 70%-110%)