钩子文档

restrict_manage_users

💡 云策文档标注

概述

restrict_manage_users 是一个 WordPress 动作钩子,在用户列表表格中批量角色更改控件的关闭 div 之前触发,主要用于开发者自定义用户管理界面。

关键要点

  • 触发时机:在用户列表表格的批量角色更改控件关闭 div 之前执行。
  • 参数:$which,字符串类型,指定额外表格导航标记的位置,可选 'top' 或 'bottom'。
  • 相关函数:WP_Users_List_Table::extra_tablenav() 用于输出批量更改用户角色的控件。
  • 版本历史:从 3.5.0 版本引入,4.6.0 版本添加了 $which 参数。

📄 原文内容

Fires just before the closing div containing the bulk role-change controls in the Users list table.

Parameters

$whichstring
The location of the extra table nav markup: 'top' or 'bottom'.

Source

do_action( 'restrict_manage_users', $which );

Changelog

Version Description
4.6.0 The $which parameter was added.
3.5.0 Introduced.