WordPress 2.3 Taxonomy Schema
WordPress 2.3 introduces our new taxonomy schema. This new schema replaces the categories, post2cat, and link2cat tables with three new tables that are more flexible. The first table is the terms table. It holds the basic information about a term.
term_id bigint(20) NOT NULL auto_increment, name varchar(55) NOT NULL default '', slug varchar(200) NOT NULL default '', term_group bigint(10) NOT NULL default 0, PRIMARY KEY (term_id), UNIQUE KEY slug (slug)
“name” is simply the name of the term. “slug” is the name reduced to a URL friendly form. “term_group” is a means of grouping together similar terms. “term_id” is a unique ID for the term.
A term is not a category or tag on its own. It must be given context via the term_taxonomy table.
term_taxonomy_id bigint(20) NOT NULL auto_increment, term_id bigint(20) NOT NULL default 0, taxonomy varchar(32) NOT NULL default '', description longtext NOT NULL, parent bigint(20) NOT NULL default 0, count bigint(20) NOT NULL default 0, PRIMARY KEY (term_taxonomy_id), UNIQUE KEY term_id_taxonomy (term_id,taxonomy)
The term_taxonomy table places a term within a taxonomy. This is what makes a term a category or tag (or both). “term_id” is the ID of a term in the terms table. “taxonomy” designates the taxonomy in which the term resides. The default taxonomies are “category”, “link_category”, and “post_tag”. “term_taxonomy_id” is a unique ID for the term+taxonomy pair. The rest of the fields provide information about the term in the context of the taxonomy. The “parent” field keeps track of hierarchical relationships between terms in the taxonomy. “description” provides a taxonomy specific description of the term. “count” tracks how many objects are associated with the term+taxonomy pair. Given a taxonomy of “category”, “count” tracks how many posts are in the category.
The final table, term_relationships, relates objects such as posts or links to a term_taxonomy_id from the term_taxonomy table.
object_id bigint(20) NOT NULL default 0, term_taxonomy_id bigint(20) NOT NULL default 0, PRIMARY KEY (object_id,term_taxonomy_id), KEY term_taxonomy_id (term_taxonomy_id)
“object_id” is the ID of a post or link. “term_taxonomy_id” is an ID from the term_taxonomy table designating a particular term+taxonomy pair.
The flexibility of the schema and API means plugins can add new taxonomies and object types quite easily. One of the Summer of Code projects does just that. The flexibility also allows us to easily retrieve all objects associated with a given term regardless of taxonomy, retrieve all terms from all taxonomies for a given object, and convert all categories to tags with one query.
The taxonomy schema is hidden behind a fairly comprehensive taxonomy API. The category API remains as a backward compatibility layer on top of the taxonomy API. Plugins that use the category API should not require any changes when upgrading to 2.3. Plugins that perform direct SQL queries on the categories, link2cat, or post2cat tables will break, unfortunately.
And that’s the new schema. It will break a few plugins in the short term, but in the long term it will allow us to add any new taxonomies that come along without needing to change the schema again.
Will there be an importer for UTW? UTW is an incredible plugin but I’d rather use the core instead of a plugin.
A UTW importer is bundled with WP 2.3.
Hooray!
I’ve only recently switched to the “Simple Tagging” plugin because I’d had problems with UTW, I don’t suppose there will be an importer for that too?
I guess if I need to I can just import from my UTW tags and then update the tags for the new posts I’ve created since switching.
Other than that, the taxnomy schema looks pretty good I look forward to playing around with it.
Baris, if you download the current trunk version of WP you can try the importer out now; just go to Manage > Import > Ultimate Tag Warrior. I tried it out today on the Tarski site and it worked perfectly.
I am using Simple Tag for my blog, will WordPress 2.3 include an importer for it too? Because I would hate to have to re-tag everything again
Awesome, I’m so glad it imports from UTW. I’ll be grabbing the public beta tomorrow for some bug squashing.
Will this new schema break a lot (most) of the plugins out there?
@Jonathan Dingman: Yes because the wp-admin got restructure. Personally I make use of wp-admin/upgrade-functions.php (WP 2.1+) but in WP 2.3 it is now wp-admin/includes/upgrade.php
Convert my tag system to WP 2.3 will be a big trouble, but I’ll take it too.
Any importer included for the simple-tagging plugin? as opposed to utw…
I am using simple tag in my blog. Will there be an import in WordPress 2.3 to handle simple tag too?
What does UTW stand for?
Someone submitted a Simple Tagging importer but we haven’t done anything with it yet. If anyone wants to try it out and give feedback, we can work it into 2.3.
@Ryan: I have tested the Simple Tagging Importer with a nightly build of WordPress 2.3 and it works very well.
@GO, UTW stands for Ultimate Tag Warrior; a popular WordPress plugin made by a great kiwi coder.
http://neato.co.nz/ultimate-tag-warrior
Will classic UTW ( Go: UTW = UltimateTagWarior, a classic monster plugin) functionality like tagclouds and lists of related posts still require plugins or be part of the WordPress core?
Looks like I’ll have to be holding back from the 2.3 upgrade for a while then as a lot of my sites are plugin dependent
I’m not clear about the purpose of term_group. Isn’t that just a way to categorize the term? If so, doesn’t that belong in the taxonomy table?
Hi. Will this new schema break a lot of the plugins out there? Thanks !
Crow: term_group is used for aliasing. If you want to make two terms equivalent, then they go into the same group. This allows you to make two different tags that work together. Like I could create a tag for “coke” and “coca-cola” and when I pulled posts for either tag, I’d get both of them back.
How can i see in plugin code when they have a call to post2cat or link2cat?