=== 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
    3.0	    2007/12/02 =Change:= Added option to show post count after each
				 tag.  Thanks to Dovydas for the request.
		       =Change:= Ability to use as a regular Wordpress plugin.
			         See below for PHP tag examples.  Requested
				 by too many people to mention here.  Thank you
				 all!
 
    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? =

(New in 3.0) YES!  The function for the most part uses the same format as the
stock Wordpress tag cloud function, with some notable additions.  Listed below
are the arguments and defaults for the ctc function.  The function uses the
standard query string format for arguments.

= ARGUMENT =		= FUNCTION =			= DEFAULT VALUE =
*smallest=#		Smallest font size to use	8
*largest=#		Largest font size to use	22
*unit=pt|em|%|px	Unit for font size		pt
*mincolor=#xxxxxx	Low color for gradient		#000000
*maxcolor=#xxxxxx	High color for gradient		#000000
*format=flat|list	Format for tag cloud		flat
*number=#		Number of tags to show		45
*orderby=name|count	Sort field for tags		name
*order=ASC|DESC		Order of cloud			ASC
*showcount=yes|no	Show post count after tags	no

* EXAMPLE *
<?php ctc('smallest=10&largest=28&unit=px&mincolor=#c0c0c0&maxcolor=#000000&showcount=yes'); ?>

This would show a cloud with font size from 10 to 28 pixels, a color gradient
of #c0c0c0 to #000000, and post counts after each tag.

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