apply_filters( "handle_bulk_actions-{$screen}", string $sendback, string $doaction, array $items )
- Since
- 4.7.0
Fires when a custom bulk action should be handled.
Description
The redirect link should be modified with success or failure feedback from the action to be used to display feedback to the user.
The dynamic portion of the hook name, $screen, refers to the current screen ID.
Compatibility
- WordPress
- since 4.7.0
- 6.7.7
- 6.8.8
- 6.9.7
- 7.0.4
- 7.1.0
Present in every tracked release (6.7.7 to 7.1.0).
Parameters
$sendbackstring- The redirect URL.
$doactionstring- The action being taken.
$itemsarray- The items to take the action on. Accepts an array of IDs of posts, comments, terms, links, plugins, attachments, or users.
Where this hook fires · 7
wp-admin/edit-comments.php:120file scopewp-admin/edit-tags.php:207file scopewp-admin/edit.php:222file scopewp-admin/link-manager.php:38file scopewp-admin/plugins.php:545file scopewp-admin/upload.php:346file scopewp-admin/users.php:592file scope
Source code
* * @param string $sendback The redirect URL. * @param string $doaction The action being taken. * @param array $items The items to take the action on. Accepts an array of IDs of posts, * comments, terms, links, plugins, attachments, or users. */ $sendback = apply_filters( "handle_bulk_actions-{$screen}", $sendback, $doaction, $post_ids ); // phpcs:ignore WordPress.NamingConventions.ValidHookName.UseUnderscores break; } $sendback = remove_query_arg( array( 'action', 'action2', 'tags_input', 'post_author', 'comment_status', 'ping_status', '_status', 'post', 'bulk_edit', 'post_view' ), $sendback ); wp_redirect( $sendback );Changelog
Introduced in 4.7.0. Unchanged from 6.7.7 through 7.1.0.
Signature, return type and hooks compared across 5 parsed releases.
About this page
- Parsed data
- Generated from the wordpress-develop 6.9.7 tag, and regenerated for each WordPress release so it tracks the code rather than a snapshot of it.
- Corrections
- Something wrong on this page? Report it and it gets fixed in the next regeneration.