do_action( 'manage_posts_custom_column', string $column_name, int $post_id )

Fires in each custom column in the Posts list table.


Description Description

This hook only fires if the current post type is non-hierarchical, such as posts.


Top ↑

Parameters Parameters

$column_name

(string) The name of the column to display.

$post_id

(int) The current post ID.


Top ↑

More Information More Information

Combined with the manage_{$post_type}_posts_columns filter, this allows you to add or remove (unset) custom columns to the list post/page/custom post type pages (which automatically appear in Screen Options). The action described in here works both for built in post types as well as custom post types. manage_{$post->$post_type}_posts_custom_column can be used in WP 3.1 and later for specific custom post types. Note that if the custom post type has 'hierarchical' => true, then the correct action hook to use is manage_pages_custom_column.

Predefined Column Names:

The following column filters are already defined and used by WordPress. These can be redefined within a custom filter switch statement.

cb‘: checkbox for selecting post items for bulk actions
title‘: displays the post title as well as post action links (edit, quick edit, trash, view) based on user permissions
author‘: displays the username of the post author as a link to filter post by author
categories‘: displays the post categories as links to filter post by category
tags‘: displays the post tags as links to filter post by tags
comments‘: displays a comment icon with the number of comments as a permalink to manage the comments for that post
date‘: displays the date and status of the post


Top ↑

Source Source

File: wp-admin/includes/class-wp-posts-list-table.php

View on Trac



Top ↑

Changelog Changelog

Changelog
Version Description
1.5.0 Introduced.

Top ↑

User Contributed Notes User Contributed Notes

  1. Skip to note 1 content
    Contributed by stevenlinx

    Example Migrated from Codex:

    Display Custom Post Type:

    Suppose you have a ‘books’ custom post type and you want the “publisher” and “book author” to show up in the browse page.

    function custom_columns( $column, $post_id ) {
    	switch ( $column ) {
    		case 'book_author':
    			$terms = get_the_term_list( $post_id, 'book_author', '', ',', '' );
    			if ( is_string( $terms ) ) {
    				echo $terms;
    			} else {
    				_e( 'Unable to get author(s)', 'your_text_domain' );
    			}
    			break;
    
    		case 'publisher':
    			echo get_post_meta( $post_id, 'publisher', true ); 
    			break;
    	}
    }
    add_action( 'manage_posts_custom_column' , 'custom_columns', 10, 2 );
    
  2. Skip to note 2 content
    Contributed by stevenlinx

    Example Migrated from Codex:

    Sticky Posts:

    Built-in posts can be made sticky. manage_posts_custom_column can be used to show this in the post list.

    /* Display custom column stickiness */
    function display_posts_stickiness( $column, $post_id ) {
        if ($column == 'sticky'){
            echo '<input type="checkbox" disabled', ( is_sticky( $post_id ) ? ' checked' : ''), '/>';
        }
    }
    add_action( 'manage_posts_custom_column' , 'display_posts_stickiness', 10, 2 );
    
    /* Add custom column to post list */
    function add_sticky_column( $columns ) {
        return array_merge( $columns, 
            array( 'sticky' => __( 'Sticky', 'your_text_domain' ) ) );
    }
    add_filter( 'manage_posts_columns' , 'add_sticky_column' );
    

You must log in before being able to contribute a note or feedback.