manage_posts_columns – Hook | Developer.WordPress.org

Filters the columns displayed in the Posts list table.

Parameters

$posts_columnsstring[]: An associative array of column headings.
$post_typestring: The post type slug.

More Information

manage_posts_columns is a filter applied to the columns shown on the manage posts screen. It’s applied to posts of all types except pages. To add a custom column for pages, hook the manage_pages_columns filter. To add a custom column for specific custom post types, hook the manage_{$post_type}_posts_columns filter.
Built-in Column Types
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.

Source

$posts_columns = apply_filters( 'manage_posts_columns', $posts_columns, $post_type );

View all references View on Trac View on GitHub

Used by	Description
WP_Posts_List_Table::get_columns()`wp-admin/includes/class-wp-posts-list-table.php`

Changelog

Version	Description
1.5.0	Introduced.

User Contributed Notes

Skip to note 9 content

pixeline 3 years ago

You must log in to vote on the helpfulness of this noteVote results for this note: 1You must log in to vote on the helpfulness of this note

If you only want to modify the table view of your Posts, you can use the hooks: manage_post_posts_columns and manage_post_posts_custom_column

Log in to add feedback

Ryan McCue 6 years ago

To add a custom column, hook into this filter, and add an item to the $post_columns array. The key should be a string ID, and the value should be the human-readable text to display in the column’s header.

<?php
namespace DemoPlugin;

const COLUMN_ID = 'publisher';

/**
 * Register the custom column.
 *
 * @param array $columns Existing columns.
 * @return array Columns with custom column added.
 */
function register_column( array $columns ) : array {
	$columns[ COLUMN_ID ] = __( 'Publisher', 'demo-plugin' );
	return $columns;
}
add_action( 'manage_posts_columns', __NAMESPACE__ . '\\register_column' );

// You will likely also want to hook into 'manage_posts_custom_column' to
// output the column's value.
function render_column( string $column_id ) {
	if ( $column_id !== COLUMN_ID ) {
		return;
	}

	$post = get_post();
	echo esc_html( get_post_meta( $post->ID, '_demo_publisher', true ) );
}
add_action( 'manage_posts_custom_column',  __NAMESPACE__ . '\\render_column' );

Keramot UL Islam 6 years ago

If the new custom column is only for the default post type, then it needs to check the post type.

function my_add_new_columns($columns) {
    $post_type = get_post_type();
    if ( $post_type == 'post' ) {
        $new_columns = array(
            'my_featured' => esc_html__( 'Featured', 'text_domain' ),
        );
        return array_merge($columns, $new_columns);
    }
}
add_filter( 'manage_posts_columns',  'my_add_new_columns' );

Note: If you are using “@Keramot UL Islam” solution, make sure to return a default $columns otherwise it will mess up other post type’s columns. I.E.

 function wpdocs_my_add_new_columns( $columns ) {      $post_type = get_post_type();      if ( 'post' === $post_type ) {          $new_columns = array(              'my_featured' =&amp;gt; esc_html__( 'Featured', 'text_domain' ),          );          return array_merge( $columns, $new_columns );      }       // must return default $column value      return $columns;  }  add_filter( 'manage_posts_columns',  'wpdocs_my_add_new_columns' );

merlinthewarlock 5 years ago

codegearthemes 5 years ago

Example: To add custom featured image thumbnail column in the post.

function wpdocs_posts_thumb_columns( $columns ) {
    $post_new_columns = array(
       'post_thumbs' => esc_html__( 'Thumbs', 'text_domain' ),
    );
    return array_merge( $columns, $post_new_columns );
}
add_filter( 'manage_posts_columns', 'wpdocs_posts_thumb_columns', 5 );

function wpdocs_posts_custom_columns( $column_name, $id ) {
    if ( 'post_thumbs' === $column_name ) {
        the_post_thumbnail( 'thumbnail' );
    }
}
add_action( 'manage_posts_custom_column', 'wpdocs_posts_custom_columns', 5, 2 );

Skip to note 13 content

Steven Lin 5 years ago

You must log in to vote on the helpfulness of this noteVote results for this note: 0You must log in to vote on the helpfulness of this note
Example migrated from Codex:

To add a column showing whether a post is sticky or not:
```
function add_sticky_column( $columns ) {
	$columns['sticky'] = __('Sticky');
        return $columns;
}
add_filter( 'manage_posts_columns' , 'add_sticky_column' );
```
To actually display whether or not a post is sticky, hook the manage_posts_custom_column action.
Log in to add feedback

Shorifpatwary 3 years ago

To add and remove columns from backand posts > all post .

if ( ! function_exists( 'wpdocs_manage_custom_posts_column' ) ) {
    function wpdocs_manage_custom_posts_column( $columns ) {
	// delete some columns from dashboard post page . 

        unset( $columns['categories'] );
        unset( $columns['tags'] );
		
	// add a customs column in dashboard post page .  
	$post_type = get_post_type();
	if ( $post_type == 'post' ) {
		$new_columns = array(
			'my_featured' => esc_html__( 'Featured', 'aquila' ),
			'my_column' => esc_html__( 'My Column ', 'aquila' ),
		);
		$custom_columns = array_merge($columns, $new_columns);
	}

	// return final custom columns variable . 
        return $custom_columns;
    }
    add_filter( 'manage_posts_columns', 'wpdocs_manage_custom_posts_column' );
}

Shorifpatwary 3 years ago

To add and remove columns from backand posts > all post .

if ( ! function_exists( 'custom_manage_posts_column' ) ) {
    function manage_custom_posts_column( $columns ) {
		// delete some columns from dashboard post page . 
        unset( $columns['categories'] );
        unset( $columns['tags'] );		
		// add a customs column in dashboard post page .  
		$post_type = get_post_type();
		if ( $post_type == 'post' ) {
			$new_columns = array(
				'my_featured' => esc_html__( 'Featured', 'text_domain' ),
				'my_column'   => esc_html__( 'My Column', 'text_domain' ),
			);
			$custom_columns = array_merge($columns, $new_columns);
		}
	// return final custom columns variable . 
        return $custom_columns;
    }
}
    add_filter( 'manage_posts_columns', 'manage_custom_posts_column' );

Imran Sayed 8 years ago

-1

Example: This will remove the author, categories, tags and comment columns from backend Posts > All Posts section.

if ( ! function_exists( 'custom_manage_posts_column' ) ) {
	function custom_manage_posts_column( $columns ) {
		unset( $columns['author'] );
		unset( $columns['categories'] );
		unset( $columns['tags'] );
		unset( $columns['comments'] );
		return $columns;
	}
}
if ( has_filter( 'manage_posts_columns' ) ) {
	add_filter( 'manage_posts_columns', 'custom_manage_posts_column' );
}

apply_filters( ‘manage_posts_columns’, string[] $posts_columns, string $post_type )

In this article

Parameters

More Information

Source

Changelog

User Contributed Notes

apply_filters( ‘manage_posts_columns’, string[] $posts_columns, string $post_type )

In this article

Parameters

More Information

Source

Related

Changelog

User Contributed Notes