【WordPress】カスタムタクソノミーを管理画面に階層付きで表示する方法

WordPressでは、カテゴリのように階層構造を持つタクソノミーを自由に作成できます。しかし、カスタムタクソノミーを管理画面で使う場合、階層がうまく表示されない・扱いにくいといった問題が起こることもあります。本記事では、カスタムタクソノミーを階層付きで表示する方法と、管理画面で見やすく扱うためのポイントを解説します。

カスタムタクソノミーを階層構造で登録する
管理画面の投稿編集画面でツリー表示させる
管理画面のカラムにタクソノミーを追加する
階層がうまく表示されない場合の対処法
まとめ

カスタムタクソノミーを階層構造で登録する

まず、タクソノミーを階層型（親子構造あり）で登録するには、register_taxonomy()関数で'hierarchical' => trueを指定する必要があります。

function register_custom_taxonomy() {
  register_taxonomy('genre', 'post', array(
    'label' => 'ジャンル',
    'hierarchical' => true,
    'public' => true,
    'show_ui' => true,
    'show_admin_column' => true,
    'rewrite' => array('slug' => 'genre'),
  ));
}
add_action('init', 'register_custom_taxonomy');

'hierarchical' => trueを指定することで、カテゴリと同様に親子関係を持たせることができます。

管理画面の投稿編集画面でツリー表示させる

階層型のタクソノミーであれば、投稿編集画面では自動的にカテゴリと同じようなチェックボックスツリーが表示されます。ただし、'show_ui'と'show_in_quick_edit'が有効になっている必要があります。

また、タクソノミーを左側のメニューに独立して表示したい場合は、'show_in_menu' => trueを指定することで管理しやすくなります。

'show_in_menu' => true,
'show_in_quick_edit' => true,

管理画面のカラムにタクソノミーを追加する

投稿一覧にタクソノミーの名称を表示して、フィルタ機能を追加することも可能です。以下のようにフィルターとカラムを追加します。

// カラム追加
function add_genre_column($columns) {
  $columns['genre'] = 'ジャンル';
  return $columns;
}
add_filter('manage_post_posts_columns', 'add_genre_column');

// カラムの値表示
function show_genre_column($column_name, $post_id) {
  if ($column_name === 'genre') {
    $terms = get_the_term_list($post_id, 'genre', '', ', ');
    echo $terms ? $terms : '—';
  }
}
add_action('manage_post_posts_custom_column', 'show_genre_column', 10, 2);