Administration: Standardise the docblocks for the `handle_bulk_actions-*` filters.

Props ericlewis, Veraxus
Fixes #16031

Built from https://develop.svn.wordpress.org/trunk@38958


git-svn-id: http://core.svn.wordpress.org/trunk@38901 1a063a9b-81f0-0310-95a4-ce76da25c4cd

wp-admin/edit-comments.php

@@ -91,9 +91,9 @@ if ( $doaction ) {
 		 *
 		 * @since 4.7.0
 		 *
-		 * @param string $redirect_to The redirect URL.
+		 * @param string $redirect_url The redirect URL.
-		 * @param string $doaction    The action being taken.
+		 * @param string $doaction     The action being taken.
-		 * @param array  $comment_ids The comments to take the action on.
+		 * @param array  $items        The items to take the action on.
 		 */
 		$redirect_to = apply_filters( 'handle_bulk_actions-' . get_current_screen()->id, $redirect_to, $doaction, $comment_ids );
 	}

wp-admin/edit-tags.php

@@ -174,18 +174,7 @@ default:
 	}
 	check_admin_referer( 'bulk-tags' );
 	$tags = (array) $_REQUEST['delete_tags'];
-	/**
+	/** This action is documented in wp-admin/edit-comments.php */
-	 * Fires when a custom bulk action should be handled.
-	 *
-	 * The sendback link should be modified with success or failure feedback
-	 * from the action to be used to display feedback to the user.
-	 *
-	 * @since 4.7.0
-	 *
-	 * @param string $location The redirect URL.
-	 * @param string $action   The action being taken.
-	 * @param array  $tags     The tag IDs to take the action on.
-	 */
 	$location = apply_filters( 'handle_bulk_actions-' . get_current_screen()->id, $location, $wp_list_table->current_action(), $tags );
 	break;
 }

wp-admin/edit.php

@@ -163,18 +163,7 @@ if ( $doaction ) {
 			}
 			break;
 		default:
-			/**
+			/** This action is documented in wp-admin/edit-comments.php */
-			 * Fires when a custom bulk action should be handled.
-			 *
-			 * The sendback link should be modified with success or failure feedback
-			 * from the action to be used to display feedback to the user.
-			 *
-			 * @since 4.7.0
-			 *
-			 * @param string $sendback The redirect URL.
-			 * @param string $doaction The action being taken.
-			 * @param array  $post_ids The post IDs to take the action on.
-			 */
 			$sendback = apply_filters( 'handle_bulk_actions-' . get_current_screen()->id, $sendback, $doaction, $post_ids );
 			break;
 	}

wp-admin/link-manager.php

@@ -31,18 +31,7 @@ if ( $doaction && isset( $_REQUEST['linkcheck'] ) ) {
 
 		$redirect_to = add_query_arg( 'deleted', count( $bulklinks ), $redirect_to );
 	} else {
-		/**
+		/** This action is documented in wp-admin/edit-comments.php */
-		 * Fires when a custom bulk action should be handled.
-		 *
-		 * The redirect link should be modified with success or failure feedback
-		 * from the action to be used to display feedback to the user.
-		 *
-		 * @since 4.7.0
-		 *
-		 * @param string $redirect_to The redirect URL.
-		 * @param string $doaction    The action being taken.
-		 * @param array  $bulklinks   The links to take the action on.
-		 */
 		$redirect_to = apply_filters( 'handle_bulk_actions-' . get_current_screen()->id, $redirect_to, $doaction, $bulklinks );
 	}
 	wp_redirect( $redirect_to );

wp-admin/plugins.php

@@ -363,20 +363,8 @@ if ( $action ) {
 				$plugins = isset( $_POST['checked'] ) ? (array) $_POST['checked'] : array();
 				$sendback = wp_get_referer();
 
-				/**
+				/** This action is documented in wp-admin/edit-comments.php */
-				 * Fires when a custom bulk action should be handled.
-				 *
-				 * The sendback link should be modified with success or failure feedback
-				 * from the action to be used to display feedback to the user.
-				 *
-				 * @since 4.7.0
-				 *
-				 * @param string $sendback The redirect URL.
-				 * @param string $action   The action being taken.
-				 * @param array  $plugins  The plugins to take the action on.
-				 */
 				$sendback = apply_filters( 'handle_bulk_actions-' . get_current_screen()->id, $sendback, $action, $plugins );
-
 				wp_safe_redirect( $sendback );
 				exit;
 			}

wp-admin/upload.php

@@ -164,18 +164,7 @@ if ( $doaction ) {
 			$location = add_query_arg( 'deleted', count( $post_ids ), $location );
 			break;
 		default:
-			/**
+			/** This action is documented in wp-admin/edit-comments.php */
-			 * Fires when a custom bulk action should be handled.
-			 *
-			 * The redirect link should be modified with success or failure feedback
-			 * from the action to be used to display feedback to the user.
-			 *
-			 * @since 4.7.0
-			 *
-			 * @param string $location The redirect URL.
-			 * @param string $doaction The action being taken.
-			 * @param array  $post_ids The posts to take the action on.
-			 */
 			$location = apply_filters( 'handle_bulk_actions-' . get_current_screen()->id, $location, $doaction, $post_ids );
 	}
 

wp-admin/users.php

@@ -414,18 +414,7 @@ default:
 		$userids = $_REQUEST['users'];
 		$sendback = wp_get_referer();
 
-		/**
+		/** This action is documented in wp-admin/edit-comments.php */
-		 * Fires when a custom bulk action should be handled.
-		 *
-		 * The sendback link should be modified with success or failure feedback
-		 * from the action to be used to display feedback to the user.
-		 *
-		 * @since 4.7.0
-		 *
-		 * @param string $sendback The redirect URL.
-		 * @param string $action   The action being taken.
-		 * @param array  $userids  The users to take the action on.
-		 */
 		$sendback = apply_filters( 'handle_bulk_actions-' . get_current_screen()->id, $sendback, $wp_list_table->current_action(), $userids );
 
 		wp_safe_redirect( $sendback );

wp-includes/version.php

@@ -4,7 +4,7 @@
  *
  * @global string $wp_version
  */
-$wp_version = '4.7-alpha-38957';
+$wp_version = '4.7-alpha-38958';
 
 /**
  * Holds the WordPress DB revision, increments when changes are made to the WordPress DB schema.