apply_filters( "bulk_actions-{$this->screen->id}", array $actions )

Filters the items in the bulk actions menu of the list table.

Description

The dynamic portion of the hook name, $this->screen->id, refers to the ID of the current screen.

Parameters

$actions

(array) An array of the available bulk actions.

More Information

  • This hook allows you to remove items from the bulk actions dropdown on any specified admin screen.
  • Bulk actions are a simple associative array.
  • The filter hook follows the format ‘bulk_actions-screenid‘, where screenid is the id of the admin screen that you want to affect.
  • As of version 4.7, custom bulk actions can be added using this filter. You can add functionality to custom bulk actions using ‘handle_bulk_actions-screenid‘, where screenid is the id of the admin screen that you want to affect.

Source

File: wp-admin/includes/class-wp-list-table.php

View on Trac

Changelog

Version Description
5.6.0 A bulk action can now contain an array of options in order to create an optgroup.
3.1.0 Introduced.

© 2003–2021 WordPress Foundation
Licensed under the GNU GPLv2+ License.
https://developer.wordpress.org/reference/hooks/bulk_actions-this-screen-id