Adding Custom Meta Headers To Taxonomy Table Columns in WordPress 3.0

This is part 2 of a series on digging deeper into the new WordPress Custom Taxonomies. In the previous article, “Custom Meta for new Taxonomies in WordPress 3.0“, I walked you through setting up the custom meta tables and the Taxonomy term editor form. In this part of the series I’ll show you how to add your new taxonomy meta fields to the taxonomy listing page.

Background

To bring everyone up to speed on the project I’m developing a simple product management system (e-Commerce) for a client. I wanted to take advantage of the new Custom Post Types and Taxonomies in the WordPress 3.0 system. I setup a new Post Type ‘Products’. As part of Products I’m defining a new Taxonomy ‘Product Packages’. A ‘Package’ is how a product is sold to the user. Think of threadless.com or some product site where you must select options like size or color. In our case each package has a number of extra ‘meta’ fields associated with it. In the case of my product packages some of these meta fields are unit price, shipping price, package active.

The goal of this article is to modify the default columns displayed on the taxonomy listing. These default columns are Name, Description and Slug. While these are sufficient for other taxonomies like post categories or post tags they don’t exactly work for my product package needs. What we will be building is some more like the following which includes meta field from part I. The column headers we will be added are ‘Active’ to show when a Product Package is on or off and the column header ‘Price’ which is the unit Price for a given package. These columns were chosen because the let the administrator visually see the information in the table form without needing to access each package detail.

WordPress Taxonomy meta listing

So lets get started.

Adding Taxonomy Column Headers

We will start with adding the filter to modify the column headers. When I click on the ‘Product Packages’ I noted that URL for the taxonomy listing is

http://local.localsite.com/wp-admin/edit-tags.php?taxonomy=product_packages&post_type=products

After doing some digging I found that the edit-tags.php code calls a number of functions to build out the page structure. One of these function is ‘get_column_headers()’ The get_column_headers function is located in the /wp-admin/includes/template.php file line 674. Inside this function there are various checks to see if we are dealing with a normal build-in screen like for post categories or post tags. If not the logic falls down to line 761 there a filter is executed. The filename key or name is dynamic and is based on the taxonomy name. The filter key is ‘manage_’ . $screen->id . ‘_columns’. The screen->id value is the taxonomy name we used ‘product_packages’. The filter we will be setting up will be ‘manage_product_packages_columns’. So in our code’s init function we to subscribe to this filter and add a function to handle the processing. Below is the code. The init function you may recognize from part I.


<?php
add_action( 'init', 'product_init' );
function product_init()
{
register_taxonomy( 'product_packages', 'products',
array( 'hierarchical' => true,
'label' => __('Product Packages'),
'query_var' => false
)
);
// Added from Part II.
// This filter sets up a call to your function which will handle
// adding (and removing) items from the columns array. This
// filter passes up only one argument. The array of default headers.
add_filter( 'manage_product_packages_columns',
'admin_product_packages_column_headers, 10, 1);
}
// Add this to your code's init function. This filter passes up
// only one argument. The array of default headers.
add_filter( 'manage_product_packages_columns',
'admin_product_packages_column_headers, 10, 1);
// Add this function somewhere else in your plugin or functions file.
function admin_product_packages_column_headers($columns)
{
// We are going to create a new array to hold the headers.
// Below we take the checkbox column and the name column
// and add to the new column array. Removing unwanted columns
// and adding new one is trivial. The below method has
// room form much improvement.
$columns_local = array();
if (isset($columns['cb']))
{
$columns_local['cb'] = $columns['cb'];
unset($columns['cb']);
}
if (isset($columns['name']))
{
$columns_local['name'] = $columns['name'];
unset($columns['name']);
}
// We add the Package Active to the second column
if (!isset($columns_local['product_package_active']))
$columns_local['product_package_active'] = "Active";
if (isset($columns['posts']))
$columns['posts'] = "Used";
$columns_local = array_merge($columns_local, $columns);
if (!isset($columns_local['product_package_unit_price']))
$columns_local['product_package_unit_price'] = "Price";
return array_merge($columns_local, $columns);
}

This should get the new columns added to the display table. You can save your code and verify. The table headers will be displayed. But the row content will be empty.

Adding Taxonomy Column Data

The table row content is added using another filter hook. Again, once of the function called from within edit_tags.php is the core function tag_rows(); This function in turn calls other functions. Eventually, the flow ends up in _tag_row() in template.php line 398. Much like the header logic various checks are made to see if we are dealing with a built-in taxonomy. If not then a dynamic filter hook is executed at line 483. This dynamic filter like the header filter uses the taxonomy to name the filter key unique. The filter key is
‘manage_${taxonomy}_custom_column’. Again placing in our taxonomy key ‘product_packages’ the complete filter key will be ‘manage_product_packages_custom_column’.

So back to our code we add another add_filter command to out init function. Then we add a new function to process the filter request.


<?php
add_action( 'init', 'product_init' );
function product_init()
{
// From Part I
register_taxonomy( 'product_packages', 'products',
array( 'hierarchical' => true,
'label' => __('Product Packages'),
'query_var' => false
)
);
// Added from Part II.
// This filter sets up a call to your function which will handle adding (and removing) items
// from the columns array. This filter passes up only one argument. The array of default headers.
add_filter( 'manage_product_packages_columns', 'admin_product_packages_column_headers, 10, 1);
// This filter sets up a call to display the contents of a Product Package row column.
// The filter passes up 3 argument. We only use the second and third arguments.
add_filter( 'manage_product_packages_custom_column', 'admin_product_packages_column_row', 10, 3 );
}
// This function we check the column name then pull in the row data using get_metadata()
function admin_product_packages_column_row( $row_content, $column_name, $term_id )
{
switch($column_name)
{
case 'product_package_active':
$product_package_active = get_metadata('product_packages', $term_id, 'product_package_active', true);
if (!$product_package_active)
$product_package_active = "yes";
return ucfirst($product_package_active);
break;
case 'product_package_unit_price':
return get_metadata('product_packages', $term_id, 'product_package_unit_price', true);
break;
default:
break;
}
}

And that is it. At this point you should now see your taxonomy custom meta fields display in new column when listing your taxonomy items.