=== Ultimate Tag Cloud Widget === Contributors: exz Tags: widget, tags, configurable, tag cloud Requires at least: 3.0 Tested up to: 3.6-beta2 Stable tag: 2.2 Donate link: https://flattr.com/thing/112193/Ultimate-Tag-Cloud-Widget License: GPLv2 or later This plugin aims to be the most configurable tag cloud widget out there, able to suit all your weird tag cloud needs. == Description == This is the highly configurable tag cloud widget, the main features for this plugin is: - All, single author or multiple authors per cloud - Select which taxonomies or post types to show tags for - Rules for which posts to include when fetching tags - Inclusion/exclusion functions - A bunch of ordering, coloring and styling options This plugin is under active development and my goal is to try to help everyone who have issues or suggestions for this plugin. If you find bugs or have feature requests please use [GitHub issues](https://github.com/rickard2/utcw/issues), if you need support please use the [WordPress forums](http://wordpress.org/support/plugin/ultimate-tag-cloud-widget). You're also always welcome to contact me by e-mail or Google Talk; rickard at 0x539.se == 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()` or by using the shortcode `[do_utcw]`. See [Other Notes](http://wordpress.org/extend/plugins/ultimate-tag-cloud-widget/other_notes/#Theme-integration-/-Shortcode) for more information. == Frequently Asked Questions == If you have questions, please post them in the forums. == 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 settings page of the widget == Changelog == = 2.2 = * [#19](https://github.com/rickard2/utcw/issues/19): Support for disabling links in tag cloud output * [#20](https://github.com/rickard2/utcw/issues/20): Support for loading a saved configuration from short code * [#23](https://github.com/rickard2/utcw/issues/23): Multi language support with qTranslate and WPML * [#24](https://github.com/rickard2/utcw/issues/24): Support for selecting a random set of tags = 2.1 = * [#4](https://github.com/rickard2/utcw/issues/4): Support for multiple taxonomies per widget * [#5](https://github.com/rickard2/utcw/issues/5): Improved UI for selecting authors * [#9](https://github.com/rickard2/utcw/issues/9): Support for setting minimum post count to zero * [#10](https://github.com/rickard2/utcw/issues/10): Support for removing configurations * [#12](https://github.com/rickard2/utcw/issues/12): Support for other measurements than pixels * [#15](https://github.com/rickard2/utcw/issues/15): Fixed problem with authors setting not working correctly = 2.0.1 = * Small bug fix in the widget options panel = 2.0 = * New plugin structure * Minor changes to the administration interface The changelog history for the 1.x branch is available on [GitHub](https://github.com/rickard2/utcw/blob/master/CHANGELOG.md) The upgrade notice history for the 1.x branch is available on [GitHub](https://github.com/rickard2/utcw/blob/master/UPGRADE.md) == Upgrade Notice == = 2.2 = * New features, see the plugin page at wordpress.org for full details = 2.1 = * New features, see the plugin page at wordpress.org for full details = 2.0.1 = * Small bug fix in the widget options panel = 2.0 = * New plugin architecture and a big rewrite of the plugin foundation. Watch out for breaking changes, please see http://exz.nu/utcwbreaking for more information. == Feedback == This plugin is under active development and my goal is to try to help everyone who have issues or suggestions for this plugin. If you find bugs or have feature requests please use [GitHub issues](https://github.com/rickard2/utcw/issues), if you need support please use the [WordPress forums](http://wordpress.org/support/plugin/ultimate-tag-cloud-widget). My contact information is * rickard (a) 0x539.se (email, gtalk, msn, you name it) * [twitter.com/rickard2](http://twitter.com/rickard2) If you use this plugin and like it, please consider giving me some [flattr love](https://flattr.com/thing/112193/Ultimate-Tag-Cloud-Widget). == Theme integration / Shortcode == You can 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 `$args` being a array of `key => value` pairs for the options you would like to set. For example if you'd like to change the title of the widget: ` "Most awesome title ever" ); do_utcw( $args );` If you're not able to change your theme you can also use the shortcode `[utcw]` anywhere in your posts or pages. You can pass any of the settings along with the shortcode in the format of `key="value"`, for instance if you'd like to change the widget title: `[utcw title="Most awesome title ever"]` All the configuration options can be found in the [plugin documentation](http://barney.0x539.se/utcw/classes/UTCW_Config.html). The list of properties of `UTCW_Config` can all be used as keys to the function or shortcode. == Breaking changes in version 2.0 == * Tags lists with named tags will not work in version 2.0, only tags lists with IDs. * The configuration option for text case has been renamed from case to text_transform * The styles for links aren't marked as `!important` in the CSS longer, this might change the cloud presentation in some cases * The shortcode and theme integration function call no longer accepts the widget arguments `before_widget`, `after_widget`, `before_title` and `after_title` == 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 * Fabian Reck With your help this list will hopefully grow in the future ;)