2017 © Pedro Peláez
 

library admin-column-manager

This plugin provides an easy way to add, remove and manage columns from WordPress administration screens for post, users and taxonomy listing.

image

htmlburger/admin-column-manager

This plugin provides an easy way to add, remove and manage columns from WordPress administration screens for post, users and taxonomy listing.

  • Monday, June 27, 2016
  • by htmlburger-git
  • Repository
  • 0 Watchers
  • 0 Stars
  • 2,432 Installations
  • 0 Dependents
  • 0 Suggesters
  • 0 Forks
  • 0 Open issues
  • 2 Versions
  • 24 % Grown

The README.md

Carbon Admin Columns Manager

This plugin provides an easy way to add, remove and manage columns from WordPress administration screens for post, users and taxonomy listing., (*1)


Usage

Modify pages list columns
Remove date and author columns from page listing screen, and add 2 extra columns (color and view count). The values for the extra columns are fetched from certain post meta fields., (*2)

Code:, (*3)

Carbon_Admin_Columns_Manager::modify_columns('post', array('page') )
  ->remove( array('date', 'author') )
  ->add( array(
        Carbon_Admin_Column::create('Color')
           ->set_field('color'),
        Carbon_Admin_Column::create('Views Count')
           ->set_field('views_count'),
     ));

Print column values with callback function
Add an extra column to page listing screen: views. Every page with more than 1000 views is rendered with a special CSS class popular-page., (*4)

This is achieved by using a custom callback function for printing the content of the column for the particular post_id., (*5)

Code:, (*6)

Carbon_Admin_Columns_Manager::modify_columns('post', array('page') )
  ->add( array(
        Carbon_Admin_Column::create('Views Count')
           ->set_callback('crb_admin_render_view_count_col'),
     ));

function crb_admin_render_view_count_col( $post_id ) {
    $views_count = get_post_meta($post_id, 'views_count', 1);
    $views_count = intval($views_count);

    if ($views_count > 1000) {
        $views_count = '<span class="popular-page">' . $views_count . '</span>';
    }

    return $views_count;
}

Modify custom post type columns
Remove date and author columns from the crb_cars custom post type listing screen, and add 2 extra columns (model and price). The values for the extra columns are fetched from certain post meta fields., (*7)

Code:, (*8)

Carbon_Admin_Columns_Manager::modify_columns('post', array('crb_cars') )
  ->remove( array('date', 'author') )
  ->add( array(
        Carbon_Admin_Column::create('Model')
           ->set_field('_crb_car_model'),
        Carbon_Admin_Column::create('Price')
           ->set_field('_crb_car_price'),
     ));

Render featured image in the listing table, (*9)

To show the featured image for the post, page and crb_cars post types, use a custom callback function that accepts the $post_id as a parameter., (*10)

Code:, (*11)

Carbon_Admin_Columns_Manager::modify_columns('post', array('page', 'post', 'crb_cars') )
  ->add( array(
        Carbon_Admin_Column::create('Thumbnail')
           ->set_callback('crb_column_render_post_thumbnail'),
     ));

function crb_column_render_post_thumbnail( $post_id ) {
    if ( has_post_thumbnail( $post_id ) ) {
        $thumbnail = get_the_post_thumbnail( $post_id, 'my_backend_image_size' );
    } else {
        $thumbnail = '';
    }

    return $thumbnail;
}

Modify taxonomy columns, (*12)

Remove slug and count columns from categories and tags listing screens, and add 2 extra columns (image and subtitle). The values for the extra columns are fetched from certain term meta fields. Showing the term image is achieved by using a custom callback function and showing the term subtitle is achieved by using the field meta key., (*13)

Code:, (*14)

Carbon_Admin_Columns_Manager::modify_columns('taxonomy', array('category', 'post_tag') )
  ->remove( array('description', 'posts') )
  ->add( array(
        Carbon_Admin_Column::create('Subtitle')
           ->set_field('crb_term_subtitle'),
        Carbon_Admin_Column::create('Image')
           ->set_callback('crb_column_render_term_image'),
     ));

function crb_column_render_term_image( $term_id ) {
    if ( $term_image_id = carbon_get_term_meta( $term_id, 'crb_term_image' ) ) {
        $term_image = wp_get_attachment_image( $term_image_id, 'my_backend_image_size' );
    } else {
        $term_image = '';
    }

    return $term_image;
}

Modify user columns, (*15)

Remove posts, role and e-mail columns from users listing screen, and add 2 extra columns (is user active and user registration date). The values for the extra columns are fetched from user meta fields. Showing the user status (active / inactive) is achieved by using the field meta key, while showing the user registration date is achieved by using a custom callback function., (*16)

Code:, (*17)

Carbon_Admin_Columns_Manager::modify_columns('user')
  ->remove( array('email', 'role', 'posts') )
  ->add( array(
        Carbon_Admin_Column::create('Is Active')
           ->set_field('crb_user_status'),
        Carbon_Admin_Column::create('Registration Date')
           ->set_callback('crb_column_get_user_registration_date'),
     ));

function crb_column_get_user_registration_date( $user_id ) {
    $user = get_user_by( 'id', $user_id );
    $user_registration_date = $user->data->user_registered;

    $friendly_date_text = date( 'd F, Y', strtotime( $user_registration_date ) );

    return $friendly_date_text;
}

How to deal with the responsive version of the WordPress admin, (*18)

By default WordPress hides all additional columns when the device width is equal or less than 800 pixels. However, the unnecessary columns can be removed or their values can be combined into a single column by using a callback function., (*19)

The example below removes the date, author and comments columns from page listing screen, and adds a single column showing the author, comments, date and thumbnail. In this example we will use the regular post function to retrieve the information. Each column will display the post data that corresponds to the listed entry., (*20)

Code:, (*21)

Carbon_Admin_Columns_Manager::modify_columns('post', array('page') )
    ->remove( array('date', 'author', 'comments') )
    ->add( array(
        Carbon_Admin_Column::create('Page Information')
            ->set_callback('crb_column_page_information'),
    ) );

function crb_column_page_information( $page_id ) {
    ob_start();
    ?>
    <ul>
        <?php if ( has_post_thumbnail() ): ?>
            <li>
                <?php the_post_thumbnail( 'thumbnail' ) ?>
            </li>
        <?php endif ?>
        <li>
            Posted on : <?php the_time('F jS, Y ') ?>
        </li>
        <li>
             <?php printf(__('Posted by : %s', 'crb'), get_the_author()) ?>
        </li>
        <li>
            <?php comments_popup_link( __('No Comments', 'crb'), __('1 Comment', 'crb'), __('% Comments', 'crb') ); ?>
        </li>
    </ul>
    <?php
    $page_information_content = ob_get_clean();

    return $page_information_content;
}

Create a sortable column in the WordPress admin, (*22)

Create a sortable column on page listing screen that sorts the pages by their views count., (*23)

Code:, (*24)

Carbon_Admin_Columns_Manager::modify_columns('post', array('page') )
    ->add( array(
        Carbon_Admin_Column::create('Page Information')
            ->set_sort_field('views_count'), # that value will be accessible as 'orderby' get parameter.
            ->set_callback('crb_column_page_information'),
    ) );

add_action('pre_get_posts', 'crb_sort_pages_by_their_views_count');
function crb_sort_pages_by_their_views_count( $query ) {

    if ( 
        is_admin() 
        && $query->is_main_query() 
        && get_query_var( 'post_type' )==='page'
        && !empty( $_GET['orderby'] )
        && $_GET['orderby']==='orderby_custom_column'
    ) {

        $query->set('orderby', 'meta_value_num');
        $query->set('meta_key', '_crb_page_views');
    }

    return $query;
}

Create a sortable column on user listing screen that sorts the users by their status (active / inactive)., (*25)

Code:, (*26)

Carbon_Admin_Columns_Manager::modify_columns('user')
    ->add( array(
        Carbon_Admin_Column::create('Is User Active')
            ->set_field('_crb_is_user_active')
            ->set_sort_field('orderby_status'),
    ) );

add_action( 'pre_get_users', 'crb_pre_user_query' );
function crb_pre_user_query( $user_query ) {
    global $wpdb;

    if (
        is_admin()
        && !empty($_GET['orderby']) 
        && $_GET['orderby']==='orderby_status'
    ) {
        $user_query->set('meta_key', '_crb_is_user_active');
        $user_query->set('orderby', 'meta_value');
    }
}

Set custom width to a column in the WordPress admin, (*27)

Set different width to Color, Views Count and Status columns for the page listing screen. Color column width is in percents while the View Count column width is in pixels. The width for the Status column is passed as an integer, which will automatically treat it as a pixel value., (*28)

Code:, (*29)

Carbon_Admin_Columns_Manager::modify_columns('post', array('page') )
    ->remove( array('date', 'author') )
    ->add( array(
        Carbon_Admin_Column::create('Color')
            ->set_width( '80%' )
            ->set_field('color'),
        Carbon_Admin_Column::create('Views Count')
            ->set_width( '25px' )
            ->set_field('views_count'),
        Carbon_Admin_Column::create('Status')
            ->set_width( 100 )
            ->set_field('status'),
    ));

Please, note that WordPress administration is responsive and you should use a reasonable number of columns, as well as reasonable width for each one of them. For example, having a column width of 600 pixels might cause issues on mobile devices., (*30)

How to set custom column name and to add specific style to it?, (*31)

By default the column names are generated randomly unless custom name is specified., (*32)

Setting up custom name for Image column on page listing screen and setting maximum image width., (*33)

Code:, (*34)

Carbon_Admin_Columns_Manager::modify_columns('post', array('page') )
    ->remove( array('date', 'author') )
    ->add( array(
        Carbon_Admin_Column::create('Color')
            ->set_name( 'crb-column-page-thumbnail' )
            ->set_width( '100px' )
            ->set_field('color'),
     ));

CSS:, (*35)

<style type="text/css">
    /* column heading */
    #carbon-crb-column-page-thumbnail {
        font-weight : bold;
    }

    /* column value */
    .crb-column-page-thumbnail img {
        max-width : 100%;
        height : auto;
    }
</style>

How to reorder the columns on the admin listing screeen?, (*36)

Moving page thumbnail column between the post checkbox and title columns. It's required that you set a column name with set_name() and then to specify the new order with sort(). All columns that are not specified in the array that you pass to the sort() method will be moved to the end, keeping their default order., (*37)

Code:, (*38)

Carbon_Admin_Columns_Manager::modify_columns('post', array('page') )
    ->sort( array('cb', 'crb-thumbnail-column') )
    ->add( array(
        Carbon_Admin_Column::create('Thumbnail')
            ->set_name( 'crb-thumbnail-column' )
            ->set_callback('crb_column_thumbnail'),
     ));

Useful Callback Functions

The functions below are just for reference and are not defined in the plugin., (*39)

Page/Post Thumbnail
Use the following callback function to display the post thumbnail photo., (*40)

Code :, (*41)

function crb_column_thumbnail( $post_id ) {
    if ( has_post_thumbnail( $post_id ) ) {
        return get_the_post_thumbnail( $post_id, 'admin_thumbnails' );
    }
}

Page Template
Use the following callback function to display the page template name., (*42)

Code :, (*43)

function crb_column_page_template( $page_id ) {
    $page_template_name = array_search(
        get_post_meta( $page_id, '_wp_page_template', true ),
        get_page_templates()
    );

    if ( $page_template_name === false ) {
        $page_template_name = 'Default';
    }

    return $page_template_name;
}

Page Sidebar
Use the following callback function to display the sidebar that is selected for each page., (*44)

Code :, (*45)

function crb_column_page_template( $page_id ) {

    $sidebar = get_post_meta( $page_id, 'crb_custom_sidebar', true );

    if ( empty($sidebar) ) {
        $sidebar = 'Default Sidebar';
    }

    return $page_template_name;
}

Package Summary

Columns Manager
There are three types of manager for Posts, Taxonomies and Users listing pages., (*46)

Posts Manager, (*47)

Code :, (*48)

$post_types = array( 'post_type_one', 'post_type_two' );

$columns_to_remove = array( 'column_one', 'column_two' );

$custom_column_order = array( 'column_name_five', 'column_name_four', 'column_name_three' );

$columns_to_add = array( $columns_code_goes_here );

Carbon_Admin_Columns_Manager::modify_columns('post', $post_types )
    ->remove( $columns_to_remove ) # remove unnecessary columns
    ->sort( $custom_column_order ) # set custom column order
    ->add( $columns_to_add ) # add new columns

Taxonomy Manager, (*49)

Code :, (*50)

$taxonomies = array( 'taxonomy_name_one', 'taxonomy_name_two' );

$columns_to_remove = array( 'column_one', 'column_two' );

$custom_column_order = array( 'column_name_five', 'column_name_four', 'column_name_three' );

$columns_to_add = array( $columns_code_goes_here );

Carbon_Admin_Columns_Manager::modify_columns('taxonomy', $taxonomies )
    ->remove( $columns_to_remove ) # remove unnecessary columns
    ->sort( $custom_column_order ) # set custom column order
    ->add( $columns_to_add ) # add new columns

Users Manager, (*51)

Code :, (*52)

$columns_to_remove = array( 'column_one', 'column_two' );

$custom_column_order = array( 'column_name_five', 'column_name_four', 'column_name_three' );

$columns_to_add = array( $columns_code_goes_here );

Carbon_Admin_Columns_Manager::modify_columns('user')
    ->remove( $columns_to_remove ) # remove unnecessary columns
    ->sort( $custom_column_order ) # set custom column order
    ->add( $columns_to_add ) # add new columns

Column, (*53)

Column that lists meta value by a given meta key, (*54)

Code :, (*55)

$column_name = __('My Column Name', 'crb');

$meta_key = '_crb_meta_key';

Carbon_Admin_Column::create( $column_name )
    ->set_field( $meta_key ),

Column that prints its value through callback function, (*56)

Code :, (*57)

$column_name = __('My Column Name', 'crb');

$callback_function_name = 'crb_callback_function';

Carbon_Admin_Column::create( $column_name )
    ->set_callback( $callback_function_name ),

/**
 * Callback Function
 *
 * @param $object_id Post ID, Term ID or User Id according to the Manager
 */
function crb_callback_function( $object_id ) {
    # posts
    return get_post_meta( $object_id, '_crb_meta_key', true );

    # terms
    return carbon_get_term_meta( $object_id, '_crb_meta_key' );

    # users
    return get_user_meta( $object_id, '_crb_meta_key', true );
}

Available Column Functions, (*58)

  • ::create( $param ), string, column label
  • set_field( $param ), string, meta key, cannot be used along with set_callback()
  • set_callback( $param ), string, callback function name, cannot be used along with set_field()
  • set_name( $param ), string, unque column name that can be used for column sorting or styling. by default the column name is generated randomly
  • set_sort_field( $param ), string, $_GET['orderby'] value

Code :, (*59)

Carbon_Admin_Column::create( $column_label )
    ->set_field( $meta_key )
    ->set_callback( $callback_function_name )
    ->set_name( $column_name )
    ->set_sort_field( $crb_sorting_value )

FAQ

Трябва ли да включа библиотеката, за я ползвам?
За всички нови проекти тази библиотека ще бъде част от lib папката. За по-стари проекти ще можете да я ползвате след изпълнение на drone upgrade-lib в проекта си, като ще трябва ръчно да добавите файла за колоните в /options и да го include-нете във functions.php., (*60)

Има ли особеност при използване на библиотеката в плъгини или в други теми?
Желателно е при вмъкването на библиотеката да проверявате дали вече не се вмъква от плъгин или от темата с проверка за вече вмъкната библиотека с class_exists., (*61)

Code :, (*62)

if ( !class_exists(Carbon_Admin_Columns_Manager) ) {
    include_once( PATH_TO_LIBRARY . 'carbon-admin-columns-manager.php');
}

Има ли ограничение в броят на колоните?
Ограничение от страна на кода няма, разбира се, не е хубаво да се злоупотребява и винаги трябва да се проверява как се държат при по-ниски резолюции., (*63)

Мога ли да задам определена ширина на колоната?
Възможно е задаване на ширини в пиксели и в проценти. Описано е в пример по-горе., (*64)

Как мога да стилвам съдържанието на колоната?
Необходимо е да се зададе уникално име на колоната след, което е възможно нейното стилване по име. Описано е в пример по-горе., (*65)

Мога ли да променям стойността на вече съществуваща колона?
За момента не е възможно, тъй като post/taxonomy колоните принтират стойността и без 'хакане' не може да стане по хубав начин., (*66)

Защо колоната връща стойността над таблицата?
Този проблем възниква само при потребителските колони, когато стойността на callback функцията се принтира echo. Необходимо е стойността да се връща return., (*67)

Мога ли да променям стойността на вече съществуваща колона?
За момента не е възможно, тъй като post/taxonomy колоните принтират стойността и без 'хакане' не може да стане по хубав начин., (*68)

Искам да премахна определена колона, но не и знам името. Откъде мога да го видя?
Обикновено то е ID-то колоната. Може да се провери с browser dev tool-а., (*69)

Мога ли да използвам библиотеката на мултиезичен сайт?
Разбира се., (*70)

Има ли определена структура при инициализиране на колоните?
Определена структура няма. По авторско мнение би било желателно да се следва следния модел:, (*71)

Code :, (*72)

if ( !class_exists('Carbon_Admin_Columns_Manager') ) {
    return;
}

add_action( 'init', 'crb_admin_columns' );
function crb_admin_columns(){

    // columns code goes here

}

Мога ли да сортирам колоните в определен ред?
Възможно е пренареждане на колоните като колоните, които не са зададени в масива от колони ще бъдат последни. Примерът е описан по-горе., (*73)

The Versions

27/06 2016

dev-master

9999999-dev

This plugin provides an easy way to add, remove and manage columns from WordPress administration screens for post, users and taxonomy listing.

  Sources   Download

GPL-2.0

27/06 2016

v1.0.0

1.0.0.0

This plugin provides an easy way to add, remove and manage columns from WordPress administration screens for post, users and taxonomy listing.

  Sources   Download

GPL-2.0