Better Tag Cloud
A better tag cloud. Lots of configuration options, a widget and a shortcode to add tag clouds to posts and pages.
Contributors: nkuttler, Nicolas Kuttler (de)
Donate link: https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=11041772
Tags: tag, tags, tag cloud, tagging, admin, plugin, widget, widgets, shortcode, i18n, internationalized, sidebar,
Requires at least: 2.7
Tested up to: 3.0
Stable tag: 0.11.2
Description
I was pretty annoyed with the default tag cloud widget. It does a lot of things wrong, like inconsistent HTML markup and hardcoded font sizes. So I wanted to write my own. Digging through the code I found out that the wordpress wp_tag_cloud()
function is pretty powerful. In fact, it could do almost everyhing I want. So I abandoned my plan to rewrite everything from scratch and added a nice admin interface to my tag cloud widget.
This plugin makes the options for wp_tag_cloud() available to a tag cloud widget and a shortcode. This means that you can easily choose things like font sizes, HTML markup and ordering. See the wp_tag_cloud page for what the settings can do.
Additionally, it is possible to sort tags by count and alphabetically at the same time. It is also possible to add a counter to the tags, so that your visitors can see how many posts are associated with each tag. The plugin also adds a sensible CSS class to every tag.
Usage
The easiest way to use this plugin is to drag the widget into one of your sidebars.
There is as well the shortcode [nktagcloud]. Examples:
- [nktagcloud] This displays the tag cloud as configured on the options page.
- [nktagcloud single=yes] This does the same but shows only the tags of the current post.
- [nktagcloud post_id=1234] Displays the tags of the post identified by post_id.
- [nktagcloud separator="" categories=no] Remove separator and categories.
Using the tag cloud in your theme
You can call the function nktagcloud_shortcode()
from your theme to get the same output as from the shortcode. Example:
if ( function_exists( 'nktagcloud_shortcode' ) ) {
echo nktagcloud_shortcode( null );
}
There's also the nk_wp_tag_cloud()
function. You can use it to generate a tag cloud with a different configuration than the plugin's one. It accepts the same parameters as wp_tag_cloud(). Example:
if ( function_exists( 'nk_wp_tag_cloud' ) ) {
echo nk_wp_tag_cloud( 'single=yes&separator= - &categories=no' );
}
Additonal parameters (all strings):
- single: Only tags of the current post ('Yes', 'No')
- categories: Inlude categories in the cloud ('Yes', 'No')
- replace: Convert blanks to non-breaking spaces ('Yes', 'No')
- post_id: Display only tags of the specified post (post ID)
- mincount: Show only tags that have been used at least so many times
- separator: Tag separator
- inject_count: Add a counter to the tag ('Yes', 'No')
- inject_count_outside: Add the counter outside of the tag hyperlink ('Yes', 'No')
- nofollow: Add the noffow attribute to the tags in the cloud ('Yes', 'No')
Support
Visit the plugin's home page to leave comments, ask questions, etc.
My plugins
Visitor Movies for WordPress: Did you ever want to know what your visitors are really doing on your site? Watch them!
Better tag cloud: I was pretty unhappy with the default WordPress tag cloud widget. This one is more powerful and offers a list HTML markup that is consistent with most other widgets.
Theme switch: I like to tweak my main theme that I use on a variety of blogs. If you have ever done this you know how annoying it can be to break things for visitors of your blog. This plugin allows you to use a different theme than the one used for your visitors when you are logged in.
Zero Conf Mail: Simple mail contact form, the way I like it. No ajax, no bloat. No configuration necessary, but possible.
Custom avatars for comments: Add a personal touch: Your visitors will be able to choose from the avatars you upload to your website for each and every comment they make.
Move WordPress comments: This plugin adds a small form to every comment on your blog. The form is only added for admins and allows you to move comments to a different post/page and to fix comment threading.
Delete Pending Comments: This is a plugin that lets you delete all pending comments at once. Useful for spam victims.
Snow and more: This one lets you see snowflakes, leaves, raindrops, balloons or custom images fall down or float upwards on your blog.
Fireworks: The name says it all, see fireworks on your blog!
Rhyming widget: I wrote a little online rhyming dictionary. This is a widget to search it directly from one of your sidebars.
Installation
Unzip, upload to your plugin directory, enable the plugin. Add the widget in your dashboard's Design section and configure it as you like.
Frequently Asked Questions
Q: How do I remove the link to the plugin homepage?
A: Please read the settings page, you can disable it there.
Screenshots
- The config options.
- The tag cloud with some CSS. Live demo at the plugin's page on my blog.
Changelog
0.11.2 ( 2009-05-22 )
- Make it possible to hide the widget header markup when there is no header text.
0.11.1 ( 2009-05-18 )
- Make it possible to hide the last separator as suggested by Scott.
0.11.0 ( 2009-05-17 )
- Add the nofollow attribute as a configurable option.
- Add dutch translation.
0.10.0.3 ( 2009-05-13 )
- Update the documentation.
0.10.0.2 ( 2009-03-09 )
- Rename function to avoid potential conflicts.
0.10.0.1 ( 2009-02-01 )
- Bugfix for minimum tag count, thanks to Muad for reporting this.
0.10.0 ( 2010-01-19 )
- Modify the shortcode so that it can display a single post's tags.
- Use parameters for all function calls to make them more usable for theme developers.
- Add the possibility to display the tags of a specific post outside the loop. This can be used in the sidebar for example.
0.9.0.1 ( 2010-01-15 )
- I ♡ the wordpress plugin versioning system through plugin.php readme.txt svn tag... I really need to script around that...
0.9.0 ( 2010-01-15 )
- Fix for when WordPress is installed into a subdirectory. Thanks Martin!
- Add belorusian translation sponsored by FatCow, thanks! Update various others.
0.8.13
- Clean up counter and separator markup, thanks Carolin!
0.8.12.2
- Really add the new CSS file, thanks Roman!
- Update italian translation.
0.8.12.1
0.8.12
0.8.11
- Add french translation by Lise, thank you!
- Add a first FAQ entry.
0.8.10
- Add danish translation by Georg S. Adamsen.
- Make widget title translatable.
0.8.9
- Bugfix for missing category links.
0.8.8
- Hopefully fix all invalid HTML markup.
0.8.7
- Add the option to put a separator string between tags.
0.8.6
- Small fixes, optimizations and updates.
0.8.5
- Add minimum count required to show a tag, thanks to Kaspars for the suggestion.
- Add CSS class to every tag in the cloud: class="nktagcloud-$tagsize". $tagsize is something between the configured values for biggest and smallest font size.
- Add icon by famfamfam to the Admin Drop Down Menu.
- Move CSS files.
0.8.4.1
0.8.4
- Fix bug for new installs where parts of the plugin options get deleted. Before, a plugin reset was necessary after the first install.
0.8.3
- Bugfix, put shortcode in the right place on the page
- Add admin styles + info
- Update german translation
- Add italian translation, thanks to Gianni!
0.8.2
- Bugfix, thanks to cornel.
0.8.1.2
- Fix invalid HTML in admin
0.8.1
- I18N
- Add german translation by Nicolas Kuttler
- Sorry for releasing 0.8.0alpha-1, it was intended as a (pretty stable) development version.
- Add a shortcode. It is possible to insert a tag cloud into any page or post.
0.8.0alpha-1
- Major rewrite
- Made code more efficient
- Better code documentation
- Improved admin security
0.7.0
- The categories can be included in the tag cloud.
0.6.4
- Make it possible to have the tag count outside of the tag hyperlink. Requested by Maya.
0.6.3
- Fix URL typo.
- Fix bad upgrade bug that deletes settings.
0.6.2
- Make font sizes text input fields for post decimal positions. This was suggested by Triton Bloom as well.
- Admin CSS update.
0.6.1
- Add include parameter as well.
0.6.0
- Make the exclude parameter work.
- Use new changelog format.
- Fix some typos.
0.5.0
- Rewrote the settings form and added an option to enable/disable tag link underlining.
0.4.0
- Add post count feature. Thanks to Triton Bloom for the suggestion.
- Add sorting by count and name at the same time feature.
- Moved the configuration to a settings page.
0.3.1
0.3.0
- Add regexp for putting multi-word tags on one line, thanks to Augen for suggesting this.
- CSS fix, doc and other minor minor updates.
0.2.3
0.2.2
0.2.1
0.2.0
- Add default CSS style for the list format.
0.1.1
0.1.0
Upgrade Notice
- 0.10.0.2
- Very low priority compatibility fix.
- 0.10.0
- This might break things for you if you're calling the plugin functions directly from your theme. However, everything is now configurable through the function call which is an improvement. For most users there shouldn't be any noticable change.
- 0.9.0.1
- This still is a maintenance release with one big internal (hence the version bump) but no big visible changes.
- 0.9.0
- This is a maintenance release with one big internal (hence the version bump) but no big visible changes.