bulk_actions-{$this->screen->id} WordPress Action Hook
The bulk_actions-{$this->screen->id} hook is used to modify the bulk actions menu for a specific screen. This hook is typically used to add or remove bulk actions for a custom post type or taxonomy.
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
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. |