populate_roles_300()
云策文档标注
概述
populate_roles_300() 函数用于在 WordPress 3.0 中创建和修改用户角色,特别是为管理员角色添加新权限。
关键要点
- 该函数在 WordPress 3.0.0 版本中引入,用于处理角色初始化。
- 主要操作为管理员角色添加多个新权限,如 update_core、list_users、edit_theme_options 等。
- 函数通过 get_role() 获取角色对象,并使用 add_cap() 方法添加权限。
代码示例
function populate_roles_300() {
$role = get_role( 'administrator' );
if ( ! empty( $role ) ) {
$role->add_cap( 'update_core' );
$role->add_cap( 'list_users' );
$role->add_cap( 'remove_users' );
$role->add_cap( 'promote_users' );
$role->add_cap( 'edit_theme_options' );
$role->add_cap( 'delete_themes' );
$role->add_cap( 'export' );
}
}注意事项
- 此函数是 populate_roles() 的一部分,用于特定版本的角色设置,开发者应避免直接调用,除非在自定义升级逻辑中。
- 权限名称如 update_core 是 WordPress 核心定义的,添加时需确保与系统兼容。
原文内容
Create and modify WordPress roles for WordPress 3.0.
Source
function populate_roles_300() {
$role = get_role( 'administrator' );
if ( ! empty( $role ) ) {
$role->add_cap( 'update_core' );
$role->add_cap( 'list_users' );
$role->add_cap( 'remove_users' );
$role->add_cap( 'promote_users' );
$role->add_cap( 'edit_theme_options' );
$role->add_cap( 'delete_themes' );
$role->add_cap( 'export' );
}
}
Changelog
| Version | Description |
|---|---|
| 3.0.0 | Introduced. |