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
- Multiple strategies for selecting terms with the option to create your own. Built in strategies for most popular, random, recently added, from current list of posts
- Short code and API for developers
The development of this plugin has stopped. I will make sure that the basic features still work with upcoming WordPress versions, but no new features or changes will be made.
The code is available on github and if you’re in need of new features, you’re welcome to submit a pull request for it.
Quick links:
- Short code information: https://wordpress.org/plugins/ultimate-tag-cloud-widget/other_notes/#Theme-integration-/-Shortcode
- Short code configuration options: https://github.com/rickard2/utcw/blob/master/CONFIG.md
- Playground which shows some configuration options: https://0x539.se/wordpress/tag-cloud-playground/
- Custom selection strategy documentation: https://github.com/rickard2/utcw/blob/master/STRATEGY.md
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, if you need support please use the WordPress forums.
My contact information is
- rickard (a) 0x539.se (email, hangouts, you name it)
- twitter.com/rickard2
If you use this plugin and like it, please consider leaving a donation.
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
<?php do_utcw($args); ?>
…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:
<?php
$args = array( "title" => "Most awesome title ever" );
do_utcw( $args );
To use multiple configuration options just separate them with a comma:
<?php
$args = array( "title" => "Most awesome title ever", "max" => 10 );
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"]
The plugin also uses a couple of filters for you to be able to alter the output. These are documented in the filters documentation at GitHub.
As of version 2.6 you can create custom selection strategies, more information can be found in the strategy documentation at GitHub
Configuration
All the configuration options can be found in the configuration documentation at GitHub.
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
andafter_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 😉
Screenshots
Installation
This is the same procedure as with all ordinary plugins.
- Download the zip file, unzip it
- Upload it to your /wp-content/plugins/ folder
- Activate the plugin through the ‘Plugins’ menu in WordPress
- 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 for more information.
FAQ
If you have questions, please post them in the forums.
- Installation Instructions
-
This is the same procedure as with all ordinary plugins.
- Download the zip file, unzip it
- Upload it to your /wp-content/plugins/ folder
- Activate the plugin through the ‘Plugins’ menu in WordPress
- 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 for more information.
Reviews
Contributors & Developers
“Ultimate Tag Cloud Widget” is open source software. The following people have contributed to this plugin.
ContributorsTranslate “Ultimate Tag Cloud Widget” into your language.
Interested in development?
Browse the code, check out the SVN repository, or subscribe to the development log by RSS.
Change log
2.7.2
- #69: Fix issues selection strategies
2.7.1
- #66: Fix issues with theme customizer in 3.9
2.7
- #60: Add css classes to target individual terms
- #61: Adds missing translation
- #62: Fix formatting issue in settings page
- #63: Support shortcodes in prefix and suffix
- #65: Fix issue with WPML displaying no (or too few) terms
2.6.1
- BUGFIX: Fixed issue with widget markup when using avoid theme styling option
2.6
- #46: Bring back styling behavior of <= v2.2 with a configuration option
- #48: Support for custom selection strategies to enable clouds with custom data sources. Detailed documentation for defining your own strategy.
- #50: Added translation files
- #51: Try to prevent line breaks in terms with multiple words
- #54: Support for attachment as custom post type
2.5
- #14: Updated UI for selecting authors
- #22: Option to fetch terms based on the current list of posts and term creation time
- #35: Updated UI for selecting post terms
- #41: New option to add filtering to tag cloud links
- #42: Added scope attribute to style tag
2.4
- Fixed issue with WPML and custom taxonomies
- #32: Added filters to enable developers to hook into the plugin
- #33: Updated JS code to support newer versions of jQuery
- #36: #38: Added options for changing the value of the title attribute
- #37: Fixed UI issue with the show title option always being checked
- #39: Added option to add post count to the term name
2.3.1
- Security fix for sensitive data exposed when using the debug option
2.3
- #27: Added filtering feature to generate a cloud of posts which have a common term/terms
- #28: Added more styling options (center, right align, justify, display as list)
- #29: Changed CSS classes to match the WordPress tag cloud
- #25: #26, #31: Internal / code quality
2.2.3
- Fixed naming collision issue with other plugins
2.2.2
- Fixed widget initialization issue
2.2.1
- Fixed issue with older PHP versions which doesn’t support namespaces
2.2
- #19: Support for disabling links in tag cloud output
- #20: Support for loading a saved configuration from short code
- #23: Multi language support with qTranslate and WPML
- #24: Support for selecting a random set of tags
2.1
- #4: Support for multiple taxonomies per widget
- #5: Improved UI for selecting authors
- #9: Support for setting minimum post count to zero
- #10: Support for removing configurations
- #12: Support for other measurements than pixels
- #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
The upgrade notice history for the 1.x branch is available on GitHub