Custom Post Type Snippets to make you smile
So it's friday, I've been coding all day and I thought I'd share some of the cool snippets I've come across and/or developed today. I've mostly been working with Custom Post Types and Taxonomies, so let me share some of that goodness. Let's geek out in a bit, but first let me show you why this is cool, be sure to click the image, so you can see which functionality I've added to the otherwise boring custom posts overview screen:
Add columns to the overview page for a Custom Post Type
So you'll want to add some columns to your post type's overview page, or remove some. Don't forget to replace <CPT> with your own custom post type in all these examples:
// Change the columns for the edit CPT screen
function change_columns( $cols ) {
$cols = array(
'cb' => '<input type="checkbox" />',
'url' => __( 'URL', 'trans' ),
'referrer' => __( 'Referrer', 'trans' ),
'host' => __( 'Host', 'trans' ),
);
return $cols;
}
add_filter( "manage_<CPT>_posts_columns", "change_columns" );Be sure to always leave the cb column in there or your mass edit / delete functionality will not work.
Give these new columns some content
Now let's fill these new columns with some content from the custom post type:
function custom_columns( $column, $post_id ) {
switch ( $column ) {
case "url":
$url = get_post_meta( $post_id, 'url', true);
echo '<a href="' . $url . '">' . $url. '</a>';
break;
case "referrer":
$refer = get_post_meta( $post_id, 'referrer', true);
echo '<a href="' . $refer . '">' . $refer. '</a>';
break;
case "host":
echo get_post_meta( $post_id, 'host', true);
break;
}
}
add_action( "manage_posts_custom_column", "custom_columns", 10, 2 );Make these new columns sortable
Now this extra info is cool, I bet you want to sort by it, that's as simple as this:
// Make these columns sortable
function sortable_columns() {
return array(
'url' => 'url',
'referrer' => 'referrer',
'host' => 'host'
);
}
add_filter( "manage_edit-<CPT>_sortable_columns", "sortable_columns" );Filter Custom Posts by Custom Taxonomy
Ok so far this is all fairly simple. Now let's go a bit more advanced. Let's say you have a custom taxonomy attached to that custom post type and you want to show a filter for that custom taxonomy on the custom post types overview page, just like you have a categories drop down on the posts overview page. This code was taken (though slightly modified) from this thread.
Let's first add that dropdown / select box to the interface:
// Filter the request to just give posts for the given taxonomy, if applicable.
function taxonomy_filter_restrict_manage_posts() {
global $typenow;
// If you only want this to work for your specific post type,
// check for that $type here and then return.
// This function, if unmodified, will add the dropdown for each
// post type / taxonomy combination.
$post_types = get_post_types( array( '_builtin' => false ) );
if ( in_array( $typenow, $post_types ) ) {
$filters = get_object_taxonomies( $typenow );
foreach ( $filters as $tax_slug ) {
$tax_obj = get_taxonomy( $tax_slug );
wp_dropdown_categories( array(
'show_option_all' => __('Show All '.$tax_obj->label ),
'taxonomy' => $tax_slug,
'name' => $tax_obj->name,
'orderby' => 'name',
'selected' => $_GET[$tax_slug],
'hierarchical' => $tax_obj->hierarchical,
'show_count' => false,
'hide_empty' => true
) );
}
}
}
add_action( 'restrict_manage_posts', 'taxonomy_filter_restrict_manage_posts' );And then, we add a filter to the query so the dropdown will actually work:
function taxonomy_filter_post_type_request( $query ) {
global $pagenow, $typenow;
if ( 'edit.php' == $pagenow ) {
$filters = get_object_taxonomies( $typenow );
foreach ( $filters as $tax_slug ) {
$var = &$query->query_vars[$tax_slug];
if ( isset( $var ) ) {
$term = get_term_by( 'id', $var, $tax_slug );
$var = $term->slug;
}
}
}
}
add_filter( 'parse_query', 'taxonomy_filter_post_type_request' );Note that for these last two snippets to work, query_var must have been set to true when registering the custom taxonomy, otherwise this'll never work.
Bonus: Add Custom Post Type to feed
This one came courtesy of Remkus de Vries a while back and was helpful today, adding a custom post type to your site's main feed, don't forget to replace <CPT> with your own custom post type:
// Add a Custom Post Type to a feed
function add_cpt_to_feed( $qv ) {
if ( isset($qv['feed']) && !isset($qv['post_type']) )
$qv['post_type'] = array('post', '<CPT>');
return $qv;
}
add_filter( 'request', 'add_cpt_to_feed' );





by Micah on 17 June, 2011 at 16:11
This is essential for plugin developers to learn. I have implemented columns and filters on my Promotion Slider plugin, but never really got around to making the columns sortable. Thanks again for a great post!
by Nicusor Dumbrava on 23 June, 2011 at 21:26
If you use any Joost's code do not forget to give him some credits :)
Micah Wood, just kidding :)
by Micah on 24 June, 2011 at 01:51
Ha ha :) You do have to be careful though, Joost's code is so well written, that if you look to see how he did something, you can't help but be tempted just to copy it! But hey, I have no problem giving credit where credit is due...
by Nicusor Dumbrava on 24 June, 2011 at 21:12
Yes Micah, especially since these credits add value to your plugin. I am not a programmer, but I peek the code of plugins that I use and I like it when I see mentions with credits given to reputable developers ... gives me confidence in the product overall ;)
by Jµ on 17 June, 2011 at 16:29
That's not a snippet... It's a tutorial ! Thanks for sharing !
by Dan on 17 June, 2011 at 16:41
This is a tutorial with great snippets. Joost just knows that most of us just end up copy and pasting anyway.
by Josh on 17 June, 2011 at 21:46
Great article! I've been toying around with custom post types a lot lately, adding / sorting columns isn't something I've considered before - thanks!
by Craig on 19 June, 2011 at 22:31
Man, awesome info you put out on your site, I put "Quix" in my tool bar two days ago, mind boggling what you can do with that tool. Installed Robots Meta on 3 sites we run, 1st site saw a 1000% increase in long tail keywords in the first month, second site saw a 200% increase, 3rd site 100% increase. Consider me a huge fan of your work :) Commenting so I can subscribe to your newsletter.
by Lars Koudal on 20 June, 2011 at 00:58
I agree with the others, great work as always.
You actually just given me a great idea, thanks :-)
by Nicusor Dumbrava on 24 June, 2011 at 21:15
If you intend to build a plugin .... let us know :)
by Rev. Voodoo on 20 June, 2011 at 17:57
Good stuff here, I'd done some custom column stuff for my CPTs before, but this is icing on the cake so to speak!
by Serge on 21 June, 2011 at 18:10
Really helpfull, but some remarks :
first snippet : use
manage_edit-CPT_columnssecond snippet : use
manage_CPT_posts_custom_columnor
global $post;etc..if ($post->post_type == "CPT") :
switch (
by serge on 21 June, 2011 at 18:17
Another tip to add our CPT in the right now widget on the dashboard
function cpt_in_right_now() {
$num_cpt = wp_count_posts( 'CPT' );
echo '';
$num = number_format_i18n( $num_cpt->publish );
$text = _n( 'CPT-NAME-SINGULAR', 'CPT-NAME-PLURAL', $num_cpt->publish );
if ( current_user_can( 'edit_post' ) ) { // or edit_CPT if defined
$num = "$num";
$text = "$text";
};
echo '' . $num . '';
echo '' . $text . '';
echo '';
}
add_action('right_now_content_table_end','cpt_in_right_now');
enjoy
by Sander on 23 June, 2011 at 17:03
Thanks Joost, this is stuff I can actually use on some projects I'm working on right now.. Thanks for sharing!
Sander
by Bryan Carter on 23 June, 2011 at 18:30
Excellent information, thanks for the snippet/tutorial!
by Marcus on 23 June, 2011 at 20:11
nice find, great snippets, bookmarked for future reference :)
by Dan on 24 June, 2011 at 18:59
Where is the Order field in Custom Post Types? Is this something that has to be added when registering the CPT?
by Dan on 24 June, 2011 at 19:15
Just answered my own question. Added the Page Attributes to the Supports argument when I Register Post Types.
by Danny G Smith on 2 July, 2011 at 23:18
This is a wonderful tutorial, I am using it on a site that I am working on now. One thing that is not intuitive to me is why you can only fire the functions to "Filter Custom Posts by Custom Taxonomy" once, even if you create more than one custom post type. If they run more than once, none of them work. Oh, well, great stuff.
by teebee on 15 July, 2011 at 14:46
One thing that is confusing me is where these snippets go. Are they all in the functions.php file or in multiple files? If in multiple files maybe you can update your post to tell which file each snippet goes into. Thanks!