函数文档

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.