管理画面の投稿一覧や固定ページ一覧をはじめとする各種一覧ページには、複数の投稿をまとめて編集したり削除する際に便利な「一括操作」が用意されていますが、その部分をカスタマイズしたい場合に使用するフィルターフック名の備忘録です。

WordPress管理画面の各種一覧ページにある「一括操作」部分のイメージ

「一括操作」部分のカスタマイズは下記2種類のフィルターを主に使用し、前者はドロップダウンの項目を、後者は各項目選択時の処理をカスタマイズする際に使用します。

apply_filters( 'bulk_actions-{$this->screen->id}', $actions );
apply_filters( 'handle_bulk_actions-{$screen}', $redirect_url, $doaction, $items );

フィルター名の{$this->screen->id}{$screen}の部分は、いずれもカスタマイズを適用したいスクリーンIDを指定し、それぞれ下記のように指定します。

各種投稿タイプ一覧

各種投稿タイプ一覧の場合は、それぞれ{$screen}部分をedit-{$post_type}と指定します。

// 投稿
bulk_actions-edit-post
handle_bulk_actions-edit-post

// 固定ページ
bulk_actions-edit-page
handle_bulk_actions-edit-page

// カスタム投稿(投稿タイプ名が「news」の場合)
bulk_actions-edit-news
handle_bulk_actions-edit-news

各種タクソノミー一覧

投稿のカテゴリーやタグをはじめとする各種タクソノミー一覧の場合は、それぞれ{$screen}部分をedit-{$taxonomy}と指定します。

// 投稿のカテゴリー
bulk_actions-edit-category
handle_bulk_actions-edit-category

// 投稿のタグ
bulk_actions-edit-post_tag
handle_bulk_actions-edit-post_tag

// カスタムタクソノミー(タクソノミー名が「news_category」の場合)
bulk_actions-edit-news_category
handle_bulk_actions-edit-news_category

メディア

bulk_actions-upload
handle_bulk_actions-upload

リスト表示をしている場合

コメント

bulk_actions-edit-comments
handle_bulk_actions-edit-comments

プラグイン

bulk_actions-plugins
handle_bulk_actions-plugins

ユーザー

bulk_actions-users
handle_bulk_actions-users