apply_filters( "bulk_actions-{$this->screen->id}", string[] $actions )

Filters the list table bulk actions drop-down.


Description Description

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


Top ↑

Parameters Parameters

$actions

(string[]) An array of the available bulk actions.


Top ↑

More Information 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.

Top ↑

Source Source

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

View on Trac



Top ↑

Changelog Changelog

Changelog
Version Description
3.1.0 Introduced.

Top ↑

User Contributed Notes User Contributed Notes

  1. Skip to note 1 content
    Contributed by stevenlinx

    Example migrated from Codex:

    The following example removes an action from the Bulk Actions drop-down on the Users page:

    <?php
        function my_custom_bulk_actions($actions) {
            unset( $actions['delete'] );
            return $actions;
        }
        add_filter('bulk_actions-users','my_custom_bulk_actions');
    ?>
    

    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).

You must log in before being able to contribute a note or feedback.