WordPress.org

1. Upload custom-taxonomies to the /wp-content/plugins/ directory
2. Activate the plugin through the 'Plugins' menu in WordPress
3. Use the Taxonomies page in Settings to create and manage taxonomies
4. After creating a taxonomy, go to the Widgets page in Appearance to add a list of terms into your site's sidebar
5. Use the examples below to use taxonomies in your themes:

Example Use

• There are two widget types for each taxonomy you create: a category-style list, and a tag-style cloud. You can assign these after creating a taxonomy via Appearance->Widgets.

• To display a comma-seperated list of a post or page's taxonomy 'thing' in the format "Things: Thing 1, Thing 2" use <?php if(function_exists('custax_the_terms')) custax_the_terms('thing', 'Things: ', ', ', '<br />'); ?>

Additionally, we have provided these functions to make using taxonomies in code/themes easier:

• To display a list of all terms for the taxonomy 'thing' use <?php if(function_exists('custax_list_terms')) custax_list_terms('thing'); ?> or add the 'Things' widget

• To display a tag cloud of terms for the taxonomy 'thing' use <?php if(function_exists('custax_term_cloud')) custax_term_cloud('thing'); ?> or add the 'Thing Cloud' widget

Advanced Use

If you'd like to use these taxonomies in a more advanced way, please see the following documentation (note that most of it has yet to be written, I will be contributing heavily to this shortly):

• get_term
• get_term_by
• get_term_children
• get_terms
• is_term
• wp_get_object_terms