wppaste
WordPress

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 scope
  • wp-admin/edit-tags.php:207file scope
  • wp-admin/edit.php:222file scope
  • wp-admin/link-manager.php:38file scope
  • wp-admin/plugins.php:545file scope
  • wp-admin/upload.php:346file scope
  • wp-admin/users.php:597file 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.

  1. 6.7.7
  2. 6.8.8
  3. 6.9.7
  4. 7.0.4
  5. 7.1.0

Signature, return type and hooks compared across 5 parsed releases.

About this page

Parsed data
Generated from the wordpress-develop 7.0.4 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.