Blog スタッフブログ
【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サイト側の表示には影響しません。