I guess it was about time I updated my Tagnetic Poetry plugin. WP-Cumulus’ lesser known brother now has shortcode support, as well as several other improvements. It’s not as mature as Cumulus, but it’s definitely stable enough to deserve a 1.0 version number.
The Flash movie now has support for the ‘xmlpath’ flashvar that WP-Cumulus has supported for a while now. This affects you only if you’re attempting to use it outside of the context of WordPress, but is very handy if you do. Putting more than one instance of the plugin on a page should also no longer cause issues, and several other little issues were fixed.
Using shortcodes allows you to place TP all over your blog. The parameters allow you to control the way it looks per instance, as opposed to the one set of options the plugin used to have. Those will still be used as defaults, but you can override them if you like by adding attributes to the [tagneticpoetry] shortcode. Here are some examples of how that works:
|Shortcode||What it’ll do|
|Will display a 300*300px version.|
|Will set the background to bright red, and make sure it’s not transparent.|
|Will display up to five tags, and exclude the one with the ID 5.|
The new shortcode is all lowercase, but the older [TAGNETICPOETRY] tag is still supported for backwards compatibility. You could in fact add lowercase attributes to it if you’re using WordPress 2.5 or higher, but if you’re going to be editing the page anyway I guess it makes sense to use the lowercase code instead.
Currently, Tagnetic Poetry supports these attributes:
|Attribute||Used for||Possible values||Example|
|width||Width of the tag cloud||Number of pixels (positive integer)||width=”300″|
|height||Height of the tag cloud||Number of pixels (positive integer)||height=”240″|
|bgcolor||Tag cloud background color||HEX color value without the ‘#’ prefix||bgcolor=”333333″|
|trans||Background transparency||“true” or “false”||trans=”true”|
|args||Argments to be passed to the ‘wp_tag_cloud’ function (experimental, use at own risk)||URL encoded string||args=”smallest=10″|
|mode||Tag/Category mode||“tags”, “cats” or “both”||mode=”tags”|