Tumblr Tag Clouds

This is a tag cloud generator for Tumblr. It uses the Tumblr API's JSON output and jQuery to generate a tag cloud each time your site is accessed.

<!-- Start Tumblr Tag Cloud --> <script type="text/javascript" src="http://tumblrtags.rivers.pro/jquery.js"></script><script type="text/javascript" src="http://tumblrtags.rivers.pro/widget.js?css=default&minsize=120&maxsize=280"></script> <!-- End Tumblr Tag Cloud -->

How to use

Copy the code above and paste it into … well, anywhere you want it to appear. You can probably paste it into your site description (Customize → Info → Description), but depending on your theme, you might have to paste it somewhere in your Custom HTML (Customize → Theme → Use Custom HTML). You can also choose to add it to a post.

This is generated dynamically – meaning each time your site is accessed, the script reloads all your tags, so it is always up to date and you never have to reconfigure it.

Contact

My name is Heather. If you're really having trouble with something, you can get in touch here: heather@rivers.pro

Preview

Enter your Tumblr URL to preview your tag cloud:

http://

Customization

The code to the left can take these optional parameters:

1. css=default (or flickr, custom)
2. minsize=120 (or any integer)
3. maxsize=280 (or any integer)
4. limit=none (or any integer)
5. order=none (or frequency, alphabetical)
6. math=log (or linear)

The defaults in bold can be changed to customize your tag cloud. The first option can be set to:

• default: includes minimal styling, leaving most of it to your theme's CSS (example)
• flickr: styles the cloud like Flickr's tag clouds (because they are pretty)
• custom: no styles whatsoever will be applied and you'll have to provide your own, either in custom CSS or your theme. (If you're writing your own CSS, the cloud's wrapper div id is tag_cloud and that of the unordered list of tags is tag_list.)

The next two parameters are the minimum and maximum font sizes (by percent) which are applied to your links. If you want all your tags to be the same size, just make these numbers the same … or you could go nuts.

And by popular demand, you can now specify the limit and order of your tags. For example, if you want to show your top 10 tags in descending order of frequency, add &limit=10&order=frequency to your code. You can also use &order=alphabetical.

The default tag size calculation is now logarithmic, rather than linear. This results in a more balanced cloud. To keep linear calculation, add &math=linear to your parameters.