Ultimate Tag Warrior 1.0

I’m so excited.. Ultimate Tag Warrior 1.0 is now available for download.

– /tags/Tag1+Tag2 syntax is now supported.
– The ultimate_show_post_tags now defaults to the local tag page; and allows specifying a set of external tag places to link to.

There are four functions worth thinking about (the rest is “don’t mind the man behind the curtain” stuff)

ultimate_show_post_tags($separator=” ”, $baseurl=’/tag/’, $notagmessage = “No Tags”, $morelinks=””)
Display a list of tags associated with the current post.
$seperator is the string that seperates tags. It only appears between tags, and not at the beginning or end of the list.
$baseurl is the base URL to link the text of a tag to. The tag link takes the form {baseurl}{tagname}.
$notagmessage is the text to display when a post has no tags.
$morelinks is either a single link as a string, or an array of links. The links are base urls to other systems that support tagging. As with the base url, the final links take the form of {url}{tagname}. Each link is displayed as an » for brevitys sake.
Display a list of the most popular tags. The tags are wrapped in li html tags, and the number of matching posts is also displayed.
$limit is the maximum number of tags to display.
ultimate_tag_archive($limit = 20, $postlimit=20)
The tag version of this plugin
ultimate_tag_cloud($order=’tag’, $direction=’asc’)
A tag cloud viewer that lists the tags using the order and direction. $order can be either “tag” or “count”, $direction can be “asc” or “desc”. The list of tags is just displayed with spaces in-between, linking through to the tag page. CSS classes .taglevel1 -> .taglevel7 control the look of tags based on popularity.

Plugin Administration
Click on “Manage”, then “Tags”. This will display a list of all available tags. Clicking on the “Rename Tag” link will allow renaming the tag. Clicking on the “Delete Tag” link will allow deleting a tag (and the associations to posts).
You can rename a tag to be the same as another one if you really want to – the tag cloud and tag archive will merge the tags, as if by magic; but if a post is tagged with both versions, it will seem to be tagged twice with the same tag. Adding a thing to merge tags properly is on my todo list.


This file contains the full documentation, the plugin file, an installation script, and a basic tag.php template.

It’s Broken!
(I hope not.)

If it is, send me an email… christine at neato dot co dot nz (I.. uh.. still haven’t figured out the problem with comments… they work okay with the default theme, but there’s nothing I can see that’s different around the comment thing. Oh the irony.. I make this genius plugin, and I can’t get my base install to work properly.)

21 thoughts on “Ultimate Tag Warrior 1.0

  1. Great plugin!

    I get a 404 error when I click on a tag from an entry. I’m thinking it has to do with the htaccess file. I just can’t seem to pinpoint it. What should be showing up in the htaccess for this plugin? Maybe I missed a step. I’ll retrack and see what I come up with.

    Also, you should put your URL in the well-written documentation for easier navigation to your website. I’ve never been here before and I downloaded the plugin elsewhere, so had I not had my htaccess problem, I may not have ever found it (via Google). 🙂

  2. Jenna,

    You might have found a bug (:

    This is what I’ve got in my .htaccess file for tags:

    RewriteRule ^^tag/?(.*) //index.php?tag=$1 [QSA] [QSA,L]
    RewriteRule ^^tags/?(.*) //index.php?tag=$1 [QSA] [QSA,L]

    But I think it should probably be this instead.

    RewriteRule ^tag/?(.*) /index.php?tag=$1 [QSA,L]
    RewriteRule ^tags/?(.*) /index.php?tag=$1 [QSA,L]

    To bypass the rewritten urls; go to /index.php?tag={tagname} (And if that doesn’t work; then something strange is going on.)

  3. David,

    You can’t at the moment; but it is something that I’m going to get to sooner or later (:

  4. Hi, quick question. Would it be possible to have something like ‘/blog/tags/’ as the $baseurl? Just want to make sure.

  5. Andrea,

    I think so; but you’ll have to manually change your htdocs. (I’m not 100% sure on the /blog/index.php bit, though – I’m guessing you have wordpress in the blog directory. If this doesn’t work, use /index.php instead)

    RewriteRule ^blog/tag/?(.*) /blog/index.php?tag=$1 [QSA,L]
    RewriteRule ^blog/tags/?(.*) /blog/index.php?tag=$1 [QSA,L]

  6. I just used a different version that Christine emailed me.

    I am not sure why it worked but it does. Are you getting the same error?

  7. Christine,

    I’m having issues. I fixed my .htaccess file, so now I don’t get 404s when trying to go to (url).org/tag/(tagname). However, regardless of the tag, it’s still showing all of my posts. I followed your install instructions exactly, and switched over to the default template while trying to get it to work.

    No idea what’s wrong.

  8. I think I have just found a tiny problem: Your plugin doesn’t seem to delete old tags when I delete a post (if that’s the last post with this tag).


  9. hi,
    after installing your plugin i get the following error when i try to manage the tags in the administration:

    Warning: Invalid argument supplied for foreach() in /home/www/htdocs/stefan-goehring.net/glatzopatzo/wp-content/plugins/ultimate-tag-warrior.php on line 416

    i am using wp and i haven’t changed a thing in this file.
    any ideas why this is happening?

Comments are closed.