概述

get_editable_roles() 函数用于获取当前用户可编辑的用户角色列表，通过过滤 $wp_roles 对象中的角色，确保插件能根据情境或用户权限移除不合适的角色，防止非管理员用户不当分配管理员权限。

关键要点

• 函数返回一个包含角色信息的数组数组，用于限制用户可分配的角色。
• 通过 editable_roles 过滤器实现角色列表的过滤，允许管理员委托用户管理权限。
• 该函数定义在 wp-admin/includes/user.php 文件中，仅在管理后台部分加载。
• 相关函数包括 wp_roles() 和 apply_filters()，用于获取全局 WP_Roles 实例和应用过滤器。

代码示例

function get_editable_roles() {
    $all_roles = wp_roles()->roles;

    /**
     * Filters the list of editable roles.
     *
     * @since 2.8.0
     *
     * @param array[] $all_roles Array of arrays containing role information.
     */
    $editable_roles = apply_filters( 'editable_roles', $all_roles );

    return $editable_roles;
}