apply_filters( "bulk_actions-{$this->screen->id}", array $actions )
Filters the items in the bulk actions menu of the list table.
Contents
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 all references
$this->_actions = apply_filters( "bulk_actions-{$this->screen->id}", $this->_actions ); // phpcs:ignore WordPress.NamingConventions.ValidHookName.UseUnderscores
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. |
User Contributed Notes
You must log in before being able to contribute a note or feedback.
Example migrated from Codex:
The following example removes an action from the Bulk Actions drop-down on the Users page:
Pay attention to the actual option values, not just the text displayed in the dropdown, on the page you wish to modify. For example, the delete option on the Plugins list page is “delete-selected” (as of 4.2.2).