plugin

Ultimate Tag Warrior 2.5

Ultimate tag warrior 2.5 is out! however, UTW now has it’s very own home at http://www.neato.co.nz/ultimate-tag-warrior where the juicy details will be posted for this, and other versions.

[Brief overview: 2.5 has big changes to the admin side of things; allows tag clouds; will render a long-tail graph for your tags; ought to behave in not-in-the-siteroot blogs; will clean up duplicate tags; can turn categories into tags; and anything else that I’ve forgotten]

I’ll continue to make announcements in the main part of my blog, though (:

Ultimate Tag Warrior 2.0

Okay. I’m somewhat happy with UTW2 now. I’m pretty sure it’s not going to steal your lunchmoney, or anything of that nature, at least.

Something to be aware of, is that even if you have installed a previous version of ultimate tag warrior, you’ll need to visit the installation page; because there are a couple of options which get added. Your head will explode if you forget this! (it probably won’t). By default, the plugin will append links to technorati tag pages at the end of your content; you might not need this, but it’s useful-ish as a starting point if you haven’t used UTW before.

Also, there are now what seems to be two plugins: 1.3 legacy and 2.0. 1.3 Legacy contains all of the functions that the 1.1.2 had, so that everything keeps working; and 2.0 is a cleanslate version which only has functions that use the fancy formatting stuff.

You can also specify the base directory for tags, which is pretty awesome (but I think the admin side will implode if it’s not in the root..)

There’s a readme with instructions for installing in the zip file; and there’s a helpfile in there somewhere which lists out the functions and some stuff for simplified formatting (you can say “commalist” is the kind of formatting, and it dutifully formats it like that; rather than having to wrangle formatting bits directly)

Ultimate Tag Warrior 2.0 go crazy with that thang.

2.0.1 alpha

Hokay!

I think I’ve fixed the two bugs that popped up (The thing with a sql error with a limit of -1, and the broken tag administration). Same warnings as 2.0 alpha apply!

Ultimate Tag Warrior 2.0.1 alpha

Ultimate Tag Warrior 2.0 alpha

Alrighty, then.

Are you hardcore?

Then Ultimate Tag Warrior 2.0 alpha might be for you!

This is still somewhat non-shiny; but it appears to be backwards compatible with 1.1.2.

The bundled zip file contains enough information to get you into trouble; but probably not quite enough for you to get it working if you aren’t familiar with existing Ultimate Tag Warrior installs. (In fact, if you’ve never installed Ultimate Tag Warrior before, there’s a pretty good chance that it’s going to steal your lunchmoney.)

Long story short: shiny new code, lives in wp-content/plugins/UltimateTagWarrior (since there are now.. five.. files to it, I think). So once you’ve copied the plugin there, you’ll need to disable UTW1ish, and enable this version. The rest of your install should “all just work the same as it always did”.

If you’re feeling brave, by all means; start using the functions in the core class, and playing with the formatting bits (There are formatting bits! They allow a big bucket of control over the way lists of tags get displayed. All of the lists (I think..) in UTW1ish have been recreated using formatting strings. There’s more about that guff in the help file.)

Oh yuh! Just for Dan, there’s now a lazy-tagging thing that will display a list of all of your tags on the edit screen, and allow you to click on ’em to add them to the list of tags for the post.

And for….Cliff (I think?), tags can have spaces, sortof – if you enter tags with _’s, then most of the time* the formatting stuff will automagically display the tags with spaces (but link to the _’ed name)
* except in strings where you ask it to do something else – the standard %link% things will do the space thing.

Download Ultimate Tag Warrior 2.0 alpha

The answer is…

Tomorrow!

I’ve got most of UTW2 written; however, since it’s UTW2 and not UTW1-and-a-little-bit; I’ve still got a bunch of auxillary stuff to do like documenting the changes which have taken place, and rounding off some of the rough edges.

(Brief overview: there is now a “Core” class which does core tagging stuff; and an “Actions” class, which performs most of the WP action hook behaviour. The main plugin code behaves in the same way, but uses the classes.
I’ve also written a magical thing for formatting! It’s.. scary. Basically, a format is an array of formatting strings, which are used to display lists of tags. A formatting string looks kinda like “<li>%taglink% – %tagcount%</li>” That particular formatting string displays a link to the tag page with the number of occurances (not always applicable), wrapped in li tags. A format, is either a single formatting string; or an array of named formatting strings. More on that tomorrow! I’m getting sleepy (: )

Ultimate Tag Warrior 1.1

I’ve just released Ultimate Tag Warrior 1.1 into the wild! From here on (and indeed since last week), the latest version of Ultimate Tag Warrior is going to live here: http://dev.wp-plugins.org/browser/ultimate-tag-warrior/trunk/. I’ll keep on announcing new versions of it here, though.

Version 1.1 adds ultimate_show_related_tags(), which will display the tags related to the current tag set. If you are viewing /tag/monkey, it will list all of the tags of the posts that match monkey (except for monkey itself.) If you are viewing /tag/monkey+banana it will list all of the tags of the posts that match both monkey and banana (excluding the monkey and banana tags). Clicking the + beside a tag will add it to the tag set.

Dan ~~made me write this~~ suggested this feature.

Ultimate Tag Warrior 1.0

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

Changes
– /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.

Functions
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.
ultimate_show_popular_tags($limit=10): 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.

Download
http://www.neato.co.nz/plugins/ultimate-tag-warrior-1.0.zip

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.)

Ultimate Tag Warrior 0.2

Ultimate Tag Warrior 0.2 has been unleashed!

Changes
– I’ve added a tag cloud function.
– There’s an administration backend that allows editing the name of tags, and removing tags.
– I’ve fixed a couple of bugs, too (;

Functions
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=’http://www.technorati.com/tag/’, $notagmessage = “No Tags”): 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}. The default points to Technorati. The value “/tag/” would link to the local tag page.
$notagmessage is the text to display when a post has no tags.
ultimate_show_popular_tags($limit=10): 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.

Download
http://www.neato.co.nz/plugins/ultimate-tag-warrior-0.2.zip

This file contains the full(ish) documentation (I, uh.. may have neglected to document the admin side), 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.

Ultimate Tag Warrior 0.1

Version 1.0 is here!

This is the first release of my latest and greatest wordpress plugin Ultimate Tag Warrior. It’s a tagging plugin for wordpress with normalised data (Oooh. Aaaah); and three ways of getting tags back out (Tags on a post, popular tags, and an archive a-la my Category Archive plugin).

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

ultimate_show_post_tags($separator=” ”, $baseurl=’http://www.technorati.com/tag/’, $notagmessage = “No Tags”): 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}. The default points to Technorati. The value “/tag/” would link to the local tag page.
$notagmessage is the text to display when a post has no tags.
ultimate_show_popular_tags($limit=10): 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

Category Archive plugin 0.2

Behold, version 0.2 of my category archive plugin!

Changes

Some type checking on the parameters passed in to the functions.
The addition of get_limited_category_archive(), which gets only the categories specified
The inclusion of a $getchildren parameter to the standard archive-getter, which allows excluding the display of child categories

Function Reference

get_category_archive($limit = 10, $parent = 0, $getchildren=true)

$limit is the maximum number of posts to get for a category. 0, -1, or none will get all of the posts.
$parent is the id of the parent category to get.
$getchildren specifies whether the children of the categories should be displayed

get_limited_category_archive($categories, $limit = 10)

$categories is the list of categories to retrieve. This can be either an array of category ids, or it can be a comma seperated list (for example: 1,2,5,7)
$limit is the maximum number of posts to get for each category. 0, -1 or none will get all posts.

Output

css class = categoryarchive

css class = categoryarchivename
{the name of the category}

css class = categoryarchivedesc
{the description of the category, if set}

css class = categoryarchiveposts
{the most recent postings for this category. If there are more postings than the limit specified, a link is included to the category page.}

Download
The plugin lives at http://www.neato.co.nz/plugins/category_archive.txt