Search results

Implementing WordPress 2.3's New Tagging Feature

by Tom Johnson on Oct 7, 2007
categories: blogging technical-writingwordpress

I've been waiting for tags to come out for a while. Now that WordPress 2.3 (Dexter) is here, I'm trying to integrate them into my site to the fullest extent. The following image shows the new Tag field that appears below posts.


Tags vs. Categories

First, to get the concept of tags right, think of tags as index words, and categories more like chapter headings. Lorelle explains,

Tags are like your blog's index. They are keywords that represent the micro-categorization of your blog's content. To work effectively, they need to be words that people search for, called search terms.

For each post you type, index the keywords into the tag field. For an example, see the tags at the bottom of this post in contrast with the post's category.

Tags Are Not Automatic

I thought that after upgrading to WordPress 2.3 and adding some tags in the Tag field, they would automatically appear in my post. Actually, tags only appear after you add the tag call (php the_tags) to your singlepost.php page in your theme editor.

Note: If your theme uses the old loop, tags won't work at all. So if you add the tag template tag to your singlepost.php page and you still don't see tags, check out your loop. See this post from echo about resolving this problem.

Actually many themes and plugins themselves aren't compatible with 2.3. If you encounter a database error, you can either start tweaking your theme by examining the code with the latest Kubrick 2.3 version theme, or just look for themes already compatible with 2.3.

Since I'd already been looking for a new theme, I used this upgrade as an excuse to implement the Limau Orange theme. (Do you like it, by the way?)

Structure Your Tags

Once you start applying tags, you'll soon want to bring more structure and order to the tagging experience. You don't want to repeat the same tags with synonyms or altered word spellings. You want to know what tags you've previously applied so your tagging is consistent.

The Structured Tag Library plugin brings this functionality to WordPress. It shows you all the previous tags you've applied and allows you to apply them to your current post. The following image shows the Advanced Tag Entry functionality this plugin adds.

Tag entry

As you can see, you can select existing tags from a drop-down list. You can also remove tags from your list.

The Tag field represents how the tag is displayed, whereas the Slug field is how WordPress stores the tag's name. Tag names can't have spaces in them, so while a tag may be named "WordPress plugins," the slug will read "wordpress-plugins."

You can manage tags conveniently through the Tag Managing Thing plugin.

Related Posts Based on Tags

Through the Related Posts plugin, you can display related posts based on common tags (thanks Lorelle for pointing out this plugin and the previous). However, if you have 300 plus posts already written, going back through them to add tags can be a gargantuan task. I'm planning to pace myself and do a little each day. Until all posts are tagged, I'll just leave in my WASABI Related Entries plugin.

A Tag Index

I'm not fond of the tag cloud. It looks scattered and cluttered (although intriguing in shape). However, I do value the index-style of words at the back of every book. You can reformat the tag cloud into a straight list and put it on its own page. The Codex explains how to do this.

Creating the tag cloud archive (which you can see on my Tag Index page) requires you create a page template with the wp-tag-cloud call on it. You can then style it by adding the .wp-tag-cloud li class to your stylesheet. The way I've implemented it, I consider it a keyword index for my site. More frequent tags appear larger in size.

I'm not sure if anyone looks at a tag index the way they look at a book's index, but perhaps they will. Overall, I'm hoping tags will provide a way of making my buried content findable. Ninety percent of readers look only at the latest posts on the first page, even if you've written a thousand previous ones. If tags can integrate

About Tom Johnson

Tom Johnson

I'm an API technical writer based in the Seattle area. On this blog, I write about topics related to technical writing and communication — such as software documentation, API documentation, AI, information architecture, content strategy, writing processes, plain language, tech comm careers, and more. Check out my API documentation course if you're looking for more info about documenting APIs. Or see my posts on AI and AI course section for more on the latest in AI and tech comm.

If you're a technical writer and want to keep on top of the latest trends in the tech comm, be sure to subscribe to email updates below. You can also learn more about me or contact me. Finally, note that the opinions I express on my blog are my own points of view, not that of my employer.