Plugin API/Filter Reference/manage edit-post type columns

1 Description
2 Built-in Column Types
3 Examples
4 Related
- 4.1 Actions
- 4.2 Filters

Description

Applied to the list of columns to print on the manage posts screen for a custom post type. Filter function argument/return value is an associative array where the element key is the name of the column, and the value is the header text for that column.

In WP 3.1, manage_edit-{$post_type}_columns has been supplanted by manage_{$post_type}_posts_columns.

See also the action manage_posts_custom_column, which alters the column information for each post in the edit table.

Built-in Column Types

Note: Listed in order of appearance. By default, all columns supported by the post type are shown.

cb

Checkbox for bulk actions.

title

Post title.

Includes "edit", "quick edit", "trash" and "view" links. If $mode (set from $_REQUEST['mode']) is 'excerpt', a post excerpt is included between the title and links.

author

Post author.

categories

Categories the post belongs to.

tags

Tags for the post.

comments

Number of pending comments.

date

The date and publish status of the post.

Examples

Add Columns

Suppose you have a 'books' custom post type and you want to add the publisher and book author to the list of columns.

function book_cpt_columns($columns) {

	$new_columns = array(
		'publisher' => __('Publisher', 'ThemeName'),
		'book_author' => __('Book Author', 'ThemeName'),
	);
    return array_merge($columns, $new_columns);
}
add_filter('manage_books_posts_columns' , 'book_cpt_columns');

Replace Columns

Here's another example that with removing and replacing some of the columns.

function book_cpt_columns($columns) {
	
	unset(
		$columns['author'],
		$columns['comments']
	);
	$new_columns = array(
		'publisher' => __('Publisher', 'ThemeName'),
		'book_author' => __('Book Author', 'ThemeName'),
	);
    return array_merge($columns, $new_columns);
}
add_filter('manage_books_posts_columns' , 'book_cpt_columns');

Note that unlike an array data type the unset PHP function accepts arguments in which the last argument should NOT end with a comma.

Hide Columns

Here is an example of how to remove or (hide) columns from Pages / Posts and Custom Post Types without adding any.

You can also add the name of the custom-post type and filter them out in there too… But if you have 5 custom post types you will need five different filters.


function my_columns_filter( $columns ) {
   unset($columns['author']);
   unset($columns['categories']);
   unset($columns['tags']);
   unset($columns['comments']);
   return $columns;
   }
       
    // Filter pages
    add_filter( 'manage_edit-page_columns', 'my_columns_filter',10, 1 );	

    // Filter Posts
    add_filter( 'manage_edit-post_columns', 'my_columns_filter',10, 1 );

    // Custom Post Type
    add_filter( 'manage_edit-CUSTOMPOSTTYPE_columns', 'my_columns_filter',10, 1 );

Note: Replace CUSTOMPOSTTYPE with the name of your post type.

WordPress.org

Codex