Columns

PostTypes

GitHub Travis CI Packagist

Search…

PostTypes v2.1

Columns

You can now modify Taxonomy columns using the same methods as you would for a PostType. For example:
1
// Create a taxonomy.
2
$genres = new Taxonomy( 'genre' );
3
​
4
// Add a column to the taxonomy admin table.
5
$genres->columns()->add( [
6
    'popularity' => __( 'Popularity' ),
7
] );
8
​
9
// Register the taxonomy to WordPress.
10
$genres->register();
Copied!
Add Columns
To add columns to the admin edit screen pass an array of column slugs and labels to the add() method.
1
// Add columns and set their labels.
2
$genres->columns()->add( [
3
    'popularity' => __( 'Popularity' ),
4
] );
Copied!
Hide Columns
To hide columns pass the column slug to the hide() method. For multiple columns pass an array of column slugs.
1
$genres->columns()->hide( 'description' );
Copied!
Column Order
To rearrange columns pass an array of column slugs and position to the order() method. Only columns you want to reorder need to be set, not all columns. Positions are based on a zero based index.
1
$genres->columns()->order( [
2
    'popularity' => 2,
3
] );
Copied!
Set Columns
To set all columns to display pass an array of the column slugs and labels to the set() method. This overrides any other configuration set by the methods above.
1
$genres->columns()->set( [
2
    'cb'          => '<input type="checkbox" />',
3
    'name'        => __( 'Name' ),
4
    'description' => __( 'Description' ),
5
    'slug'        => __( 'Slug' ),
6
    'popularity'  => __( 'Popularity' ),
7
] );
Copied!
Populate Columns
To populate any column use the populate() method, by passing the column slug and a callback function.
Taxonomy columns work differently to post type columns. The callback receives 3 arguments, the columns content, the column name and the term ID. Also, the hook used is a filter, so the column value must be returned.
1
$genres->columns()->populate( 'popularity', function ( $content, $column, $term_id ) {
2
    return get_term_meta( $term_id, 'popularity', true );
3
} );
Copied!
Sortable Columns
To define which custom columns are sortable use the sortable() method. This method accepts an array of column slugs and an array of sorting options.
The first option is the term meta_key to sort the columns by.
The second option is how the items are ordered, either numerically (true) or alphabetically (false) by default.
1
// Make both the price and rating columns sortable and ordered numerically.
2
$genres->columns()->sortable( [
3
    'popularity'  => [ 'popularity', true ],
4
] );
Copied!

Add to Post Type

Notes

Last modified 1yr ago

Copy link

Contents