概述

bulk_actions-{$this->screen->id} 是一个动态过滤器钩子，用于修改 WordPress 后台列表表格中的批量操作菜单项。它允许开发者根据当前屏幕 ID 添加、移除或修改批量操作。

关键要点

• 钩子名称格式为 bulk_actions-{screenid}，其中 screenid 是目标管理屏幕的 ID。
• 参数 $actions 是一个关联数组，表示可用的批量操作。
• 从 WordPress 4.7 开始，可通过此过滤器添加自定义批量操作，并使用 handle_bulk_actions-{screenid} 钩子处理功能。
• WordPress 5.6.0 支持在批量操作中使用选项数组以创建 optgroup。

代码示例

// 示例：从用户页面移除批量操作
add_filter( 'bulk_actions-users', 'my_custom_bulk_actions' );
function my_custom_bulk_actions( $actions ) {
    unset( $actions['delete'] ); // 移除删除操作
    return $actions;
}

注意事项

• 修改时需注意实际选项值，而非仅下拉菜单中显示的文本，例如插件列表页的删除选项值为 "delete-selected"。
• 钩子名称使用连字符而非下划线，需遵循 WordPress 命名约定。