do_action( "manage_{$post->post_type}_posts_custom_column", string $column_name, int $post_id )

Fires for each custom column of a specific post type in the Posts list table.


Description Description

The dynamic portion of the hook name, $post->post_type, refers to the post type.


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

This action is called whenever a value for a custom column should be output for a custom post type. Combined with the manage_${post_type}_posts_columns filter, this allows you to add or remove (unset) custom columns to a list of custom post types.

For built-in post types and multiple custom types, use manage_posts_custom_column.

Terms and Taxonomies

When passing this function on terms and taxonomies, a third parameter is added.

$column_name
(string) (required) The name of the column to display.
Default: None

$term_id
(int) (required) The ID of the current term. Can also be taken from the global $current_screen->taxonomy.
Default: None

$null
(null) (required) Unused and won’t pass anything.
Default: None


Top ↑

Source Source

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

View on Trac



Top ↑

Changelog Changelog

Changelog
Version Description
3.1.0 Introduced.

Top ↑

User Contributed Notes User Contributed Notes

  1. Skip to note 1 content
    Contributed by Andrija Naglic
    
    // let's say we have a CPT called 'product'
    function product_custom_column_values( $column, $post_id ) {
    
        switch ( $column ) {
    
    		// in this example, a Product has custom fields called 'product_number' and 'product_name'
            case 'product_number'	:
            case 'product_name' 	:
                echo get_post_meta( $post_id , $column , true );
            break;
    
    		// in this example, $buyer_id is post ID of another CPT called "buyer"
            case 'product_buyer' 	:
                $buyer_id = get_post_meta( $post_id , $column , true );
                if( $buyer_id ){
                    echo get_post_meta( $buyer_id , 'buyer_name' , true );
                } else {
                    echo '<div class="dashicons dashicons-minus"></div>';
                }
            break;
    
        }
    }
    add_action( 'manage_product_posts_custom_column' , 'product_custom_column_values', 10, 2 );
    

    For further management of columns, check:

    https://developer.wordpress.org/reference/hooks/manage_post_type_posts_columns/
    To add/remove/rename columns

    https://developer.wordpress.org/reference/hooks/list_table_primary_column/
    To set the primary (default) column

  2. Skip to note 2 content
    Contributed by stevenlinx

    Suppose you have a ‘book’ custom post type and you want to add the publisher and book author in the edit page but remove the post author.

    add_filter( 'manage_book_posts_columns', 'set_custom_edit_book_columns' );
    add_action( 'manage_book_posts_custom_column' , 'custom_book_column', 10, 2 );
    
    function set_custom_edit_book_columns($columns) {
        unset( $columns['author'] );
        $columns['book_author'] = __( 'Author', 'your_text_domain' );
        $columns['publisher'] = __( 'Publisher', 'your_text_domain' );
    
        return $columns;
    }
    
    function custom_book_column( $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;
        }
    }
    

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