Blog スタッフブログ

WEB制作

【WordPress】カスタム投稿の管理画面にカテゴリー絞り込みを追加する方法

WordPressでカスタム投稿タイプを使用していると、投稿数が増えるにつれて、管理画面から目的の記事を探すのが大変になることがあります。

通常の投稿ではカテゴリーによる絞り込みができますが、カスタム投稿タイプで独自に作成したカテゴリー(カスタムタクソノミー)には、絞り込みメニューが自動的に表示されないことがあります。

今回は、functions.phpにコードを追加して、カスタム投稿の一覧画面にカテゴリーの絞り込み機能を設置する方法をご紹介します。

1. カスタム投稿のカテゴリー絞り込みとは?

例えば、「制作実績」というカスタム投稿タイプを作成し、以下のカテゴリーで記事を管理しているとします。

  • Webサイト制作
  • LP制作
  • システム開発
  • その他

カテゴリーの絞り込みがない場合、管理画面の投稿一覧から目的の記事を探すには、タイトル検索などを利用する必要があります。

そこで、投稿一覧の上部にカテゴリー選択メニューを追加し、選択したカテゴリーに属する記事だけを表示できるようにします。

記事数が多いサイトや、複数の担当者で更新するサイトでは、特に便利な機能です。

2. functions.phpにコードを追加する

今回は、以下のカスタム投稿タイプとタクソノミーを例に説明します。

カスタム投稿タイプworks
カスタムタクソノミーworks_cat
使用しているテーマの functions.php に、以下のコードを追加します。

// カスタム投稿の管理画面にカテゴリー絞り込みを追加
function my_works_category_filter($post_type, $which)
{
  if ($post_type !== 'works' || $which !== 'top') {
    return;
  }

  $taxonomy = 'works_cat';

  if (!taxonomy_exists($taxonomy)) {
    return;
  }

  $selected = isset($_GET['works_cat_filter']) &&
    is_string($_GET['works_cat_filter'])
    ? sanitize_title(wp_unslash($_GET['works_cat_filter']))
    : '0';

  wp_dropdown_categories([
    'show_option_all' => 'すべてのカテゴリー',
    'taxonomy'        => $taxonomy,
    'name'            => 'works_cat_filter',
    'id'              => 'works_cat_filter',
    'orderby'         => 'name',
    'hierarchical'    => true,
    'hide_empty'      => false,
    'value_field'     => 'slug',
    'selected'        => $selected,
  ]);
}
add_action('restrict_manage_posts', 'my_works_category_filter', 10, 2);


// 選択したカテゴリーで投稿一覧を絞り込む
function my_works_category_filter_query($query)
{
  if (!is_admin() || !$query->is_main_query()) {
    return;
  }

  if ($query->get('post_type') !== 'works') {
    return;
  }

  if (
    !isset($_GET['works_cat_filter']) ||
    !is_string($_GET['works_cat_filter'])
  ) {
    return;
  }

  $term = sanitize_title(
    wp_unslash($_GET['works_cat_filter'])
  );

  if ($term === '' || $term === '0') {
    return;
  }

  $tax_query = (array) $query->get('tax_query');

  $tax_query[] = [
    'taxonomy' => 'works_cat',
    'field'    => 'slug',
    'terms'    => $term,
  ];

  $query->set('tax_query', $tax_query);
}
add_action('pre_get_posts', 'my_works_category_filter_query');

3. コードの仕組み

今回のコードでは、主に2つのWordPressのフックを使用しています。

restrict_manage_posts

管理画面の投稿一覧に、カテゴリーを選択するプルダウンメニューを追加するためのフックです。

wp_dropdown_categories() を使用することで、登録済みのカテゴリーを自動的に取得して表示できます。

カテゴリーが増えた場合も、コードを変更する必要はありません。

pre_get_posts

WordPressが投稿を取得する前に、検索条件を変更するためのフックです。

選択されたカテゴリーのスラッグを取得し、tax_query に条件を追加することで、該当するカテゴリーの記事だけを表示します。

また、is_admin() と is_main_query() を使用して、対象を管理画面のメインクエリに限定しています。

そのため、通常のWebサイト側の表示には影響しません。