Follow for free plugins, new theme releases and theme news
Plugin 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
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 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 😉
Screenshots
This shows my widget with the default settings on the default wordpress theme.
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.
Maybe a more realistic usage of the widget with spanning colors and capitalized tags.
The settings page of the widget
