Tagnetic Poetry 1.0 adds shortcode support

Tagnetic Poetry has been discontinued.

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:

ShortcodeWhat it’ll do
[tagneticpoetry width="300" height="300"]Will display a 300*300px version.
[tagneticpoetry bgcolor="ff0000" trans="false"]Will set the background to bright red, and make sure it’s not transparent.
[tagneticpoetry args="number=5&exclude=1"]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:

AttributeUsed forPossible valuesExample
widthWidth of the tag cloudNumber of pixels (positive integer)width=”300″
heightHeight of the tag cloudNumber of pixels (positive integer)height=”240″
bgcolorTag cloud background colorHEX color value without the ‘#’ prefixbgcolor=”333333″
transBackground transparency“true” or “false”trans=”true”
argsArgments to be passed to the ‘wp_tag_cloud’ function (experimental, use at own risk)URL encoded stringargs=”smallest=10″
modeTag/Category mode“tags”, “cats” or “both”mode=”tags”

A more detailed blog post on how to use shortcodes is here. The original post about Tagnetic Poetry is here.


  1. wow.. very nice..
    i want to try that.. thanks for share..

    Comment by elizer — July 3, 2009 @ 5:59 am

  2. Don’t you feel ashamed to steal the idea for that “WP-cumulas”?
    It’s not original.

    Comment by L — July 3, 2009 @ 3:47 pm

  3. Hi,
    I’m using thsi plugin and I like it very much. I just have the issue that when I click on the tags it doesn’t work. I did check the notes on wordpress and I have my urls the same of my blog, but nothing happens. Can you help me about?
    Thank you


    Comment by sergio — July 7, 2009 @ 9:26 am

  4. after look this tag flash , i like very much , can you mail this file to me ? think you seiven.

    Comment by Seiven — July 13, 2009 @ 3:55 am

  5. it is very nice, but now I am using Bo-blog

    Comment by no-name — July 26, 2009 @ 9:48 am

  6. WOW…what a concept. Never thought a link can be displayed in this way. Can this be used in blogspot as well?

    Comment by subimal — February 18, 2011 @ 10:26 am

    • Subimal, I’m not aware of a Blogger port.

      Comment by Roy — February 18, 2011 @ 11:36 am

  7. I’ve tried this plugin but had a few problems at first. Then I realised I needed to upgrade my version of wordpress

    Comment by Ivor Griffiths — July 3, 2011 @ 5:39 pm

  8. hi

    how are you doing?

    i would like to use 2 (or more) games

    [tagneticpoetry args=”smallest=15&largest=15&number=4&include=1,2,3,4″]

    [tagneticpoetry args=”smallest=15&largest=15&number=4&include=5,6,7,8″]

    so that all the words the same size, which looks like it should be supported

    but the args seems to ignore largest and smallest parameters

    or c/should I change the code to achieve the same sort of effect? or try something different (passing the parameters through xml?)?

    (pointers welcome!)

    btw I dropped a small donation in your beer fund, the other day.


    Comment by philo — August 8, 2011 @ 10:29 am