=== Ultimate Tag Cloud Widget === Contributors: exz Tags: widget, tags, configurable, tag cloud Requires at least: 2.8 Tested up to: 3.1.1 Stable tag: 1.3.2 Donate link: https://flattr.com/thing/112193/Ultimate-Tag-Cloud-Widget This plugin aims to be the most configurable tag cloud widget out there, able to suit all your wierd tag cloud needs. == Description == This is a highly configurable tag cloud widget which you can use within your own blog. Current version supports the following preferences: * Multiple instances * Choose which authors tags should be shown * Ordering of the tags * Exclude tags you don't want to show * Minimum amount of posts for tags to be included * Title * Size and color customization * Max amount of tags in your cloud * Spacing between letters and words * Transform tags into lowercase, uppercase or Capitalize them * Can also show categories * Fully internationalized and translated into two languages This plugin is under active development and my goal is to try to help everyone who have issues or suggestions for this plugin, so if you're not completely happy with this plugin, don't hesitate to contact me. == Installation == This is the same procedure as with all ordinary plugins. 1. Download the zip file, unzip it 2. Upload it to your /wp-content/plugins/ folder 3. Activate the plugin through the 'Plugins' menu in WordPress 4. Use the widgets settings page under 'Appearance' to add it to your page All the configuration options is set individually in every instance. Some default values are set if you're unsure on how to configure it. If your theme doesn't use widgets, you can still use it in your theme by calling the function do_utcw(). See "Other Notes" for more information. == Frequently Asked Questions == This is a new plugin, haven't had any questions yet. If you have any, be sure to send them to me. == Screenshots == 1. This shows my widget with the default settings on the default wordpress theme. 2. This is a more colorful example with random colors and all tags in uppercase. I'd like to actually see someone use it like this. 3. Maybe a more realistic usage of the widget with spanning colors and capitalized tags. 4. The data part of the widget settings 5. The appearance part of the widget settings == Changelog == = 1.3.2 = * Fixed bug in the SQL query making the plugin also count posts that isn't published * Added a new option to set the minimum amount of posts a tag should have to be included = 1.3.1 = * Added Swedish translation * Minor internationalization changes = 1.3 = * As requested, support for calling a function to display the widget was added. Se other notes for information on how to use it. * Javascript changes in order to fix problems with the options page in WP 3.1 beta 1 = 1.2 = * Removed all the PHP short tags * Can now sort by name, slug, id or color (!) case sensitive or case insensitive * Exclude now takes either tag name or id = 1.1 = * Fixed bug with options page * Improved link generation to create correct tag links = 1.0 = * Initial release == Upgrade Notice == = 1.3.2 = * Small bug fix in the SQL-query and a new option added = 1.3.1 = * Added Swedish translateion = 1.3 = * Support for integrating the widget within your theme added. * New javascript fixing problem with options page in WP 3.1 beta 1 = 1.1 and 1.2 = * Just bug fixes, should be safe to upgrade. = 1.0 = * Initial release == Feedback == This is my very first WordPress widget and I'd love to hear your feedback. Since this widget aims to be the most configurable tag cloud there is, you are welcome to send your suggestions and improvements to me and I'll to my best to fulfil your your tag cloud wishes. If you use this plugin and like it, please consider giving me some [flattr love](https://flattr.com/thing/112193/Ultimate-Tag-Cloud-Widget). My contact information is * rickard (a) 0x539.se * [twitter.com/rickard2](http://twitter.com/rickard2) == Theme integration == Upon a request in the forums, you can now integrate the widget within your own theme even if you're not using standard wordpress widgets. Just install and load the plugin as described and use the function `` ...with the following options in the array $args: * before_widget (string) * after_widget (string) * before_title (string) * after_title (string) * title (string) * size_from (integer) * size_to (integer) * max (integer) * reverse (boolean) * authors (array of user IDs, integers) * exclude (array of taxonomies, IDs or names) * minimum (integer) * color_set (array of hex colors, like #fff or #ffffff) * letter_spacing (integer) * word_spacing (integer) * color_span_from (hex color, like #fff or #ffffff) * color_span_to (hex color, dito) * case_sensitive (boolean) * order (string, valid values: 'random', 'name', 'slug', 'id', 'color', 'count') * taxonomy (string, valid values: 'post_tag', 'category') * color (string, valid values: 'none', 'random', 'set', 'span') * case (string, valid values: 'lowercase', 'uppercase', 'capitalize', 'off') All options are optional, default values can be found in the widget php file. Allowed values for order, taxonomy, color and case can be found in the arrays $utcw_allowed_orders, taxonomys, colors and cases respectively. The final PHP-code might look something like this: ` '
', 'after_widget' => '
', 'title' => 'Look at all these cool tagz!', 'size_from' => 19, 'size_to' => 52, 'color' => 'random', 'order' => 'name', 'reverse' => true ); do_utcw($args); ?>` Good luck and remember to give me feedback if you run into any problems! == Thanks == The power of the open source community is being able to help out and submitting patches when bugs are found. I would like to thank the following contributors for submitting patches and helping out with the development: * Andreas Bogavcic With your help this list will hopefully grow in the future ;)