Columns
You can now modify
Taxonomy columns using the same methods as you would for a PostType. For example:1
use PostTypes\Taxonomy;
2
3
// Create a taxonomy.
4
$genres = new Taxonomy( 'genre' );
5
6
// Add a column to the taxonomy admin table.
7
$genres->columns()->add( [
8
'popularity' => __( 'Popularity' ),
9
] );
10
11
// Register the taxonomy to WordPress.
12
$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!
Last modified 11d ago