=== 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 ==

= IMPORTANT NOTES!!! =
> 1. 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.

> 2. This plugin ONLY functions with tags at this point. It doesnŐt support
> categories or anything else. I am planning on adding category support to a
> future version, but as of now, you MUST have tags on your posts (or convert
> your categories to tags) in order for the plugin to function as expected.

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 FAQs 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.2     2008/02/12    Fix: Fixed problem with spaces after tags being underlined if
                               using underline style for links in css.  Thanks to Eduard
                               Roccatello pointing out the fix.

    3.1     2008/02/06 Change: Added support for "Array" format.  Thanks to Tim Einfeldt
                               for request/testing.

    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.
                       Change: Removed "Array" format. I'm not sure it would be of any use
                               running in a widget.
                       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 configuration 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|array    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=18&unit=px&mincolor=#c0c0c0&maxcolor=#000000&showcount=yes'); ?>

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

= Array Example =
    <?php
        $tags = ctc('format=array&smallest=10&largest=18&unit=px&mincolor=#c0c0c0&maxcolor=#000000&showcount=yes');
        
        foreach ($tags as $tag) {
            echo $tag."\n"
        }
    ?>

This would give you the same output as the first example, but output to the page using an array.

== 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)