如何移除 WooCommerce 后台订单页面的批量操作选项

如果你正在开发或维护一个基于 WooCommerce 的站点，大概率会碰到这样一个需求：希望把后台订单管理页（就是那个 post_type=shop_order 的列表页面）里的批量操作按钮压一压、藏一藏，比如“标记为待处理”“标记为已完成”“标记为已取消”这些默认选项，因为在实际的业务流程里，它们要么多余、要么容易引起误操作。

想法很直接——用 bulk_actions-edit-shop_order 这个过滤器，把 $bulk_actions 数组里那些不需要的键名删掉就行。代码逻辑看起来没有任何问题，但奇怪的地方来了：你明明写了 unset()，error_log 也打印出数组确实被清空了，可页面上的批量操作下拉菜单却纹丝不动，那些选项依然在那里。这不是你的代码写错了，而是钩子的执行时机出了问题。WooCommerce 自己会在订单页面初始化之后的某个阶段（具体来说，是 woocommerce_admin_order_bulk_actions 动作或者内部的注册逻辑）把这些操作项重新塞进数组里去。换句话说，你的过滤器跑得太早了，刚把东西清理干净，后面又给补上了。

所以，正确的解法其实就一句话：给你的过滤器钩子设置一个合适的优先级，确保它是在 WooCommerce 已经把所有操作都注册完毕之后再执行。经验值表明，把优先级设为 40 是一个足够安全的选择——WooCommerce 内部通常是在 10 到 30 这个区间完成注册的，40 能保证你的代码在它之后收尾。

add_filter( 'bulk_actions-edit-shop_order', 'remove_order_bulk_actions', 40, 1 );

function remove_order_bulk_actions( $bulk_actions ) {
    // 移除所有 WooCommerce 默认的状态标记操作
    $wc_status_actions = array(
        'mark_processing',
        'mark_pending',
        'mark_on-hold',
        'mark_completed',
        'mark_cancelled',
        'mark_refunded',
        'mark_failed'
    );

    foreach ( $wc_status_actions as $action ) {
        unset( $bulk_actions[ $action ] );
    }

    // 如果你连“编辑”和“移至回收站”也想清掉（注意：这会影响基础操作），可以解除下面两行的注释
    // unset( $bulk_actions['edit'], $bulk_actions['trash'] );

    return $bulk_actions;
}

这里有几点值得说清楚：

• 优先级 40 是个经验值，不是拍脑门定的。WooCommerce 自身的钩子大多在 10–30 之间完成注册，设到 40 是在它之后收场，刚刚好。如果你的自定义订单状态也跑在这套机制里，不妨把优先级再往高了调一点，比如 50 甚至更高，以确保万无一失。
• 别写 isset() 检查之后再 unset()。直接调用 unset( $bulk_actions['xxx'] ) 就行，PHP 对不存在的数组键名执行 unset() 不会有任何副作用，省一步也是一个好习惯。
• 这个操作只影响 UI 层面的显示，不会阻止后台实际处理的逻辑。如果你需要彻底禁止某种批量操作生效（比如用户提交了某个状态变更但被服务端拒绝），那还得配合 handle_bulk_actions-edit-shop_order 这一类的钩子做更底层的拦截。
• 调试小技巧：如果你不确定究竟是哪个优先级生效了，可以在不同优先级下临时打印一下当前数组的内容。比如这样来一行：error_log( 'Priority: ' . current_filter() . ' -> ' . print_r( $bulk_actions, true ) );，然后刷新页面看日志输出，你能非常直观地看到数组在哪个时机被加了什么、又被删了什么。

把这段代码放到主题的 functions.php 或者一个专属的功能插件里，订单管理页上的冗余批量操作项就会被干净地移除掉。这样一来，后台界面的简洁度和可控性都能提升一个档次，业务人员操作时也不会被那些用不上但又不敢乱点的选项烦着了。