函数文档

populate_roles_160()

💡 云策文档标注

概述

populate_roles_160() 函数用于在 WordPress 2.0 中创建核心用户角色并分配权限。它定义了五个标准角色:Administrator、Editor、Author、Contributor 和 Subscriber,并为每个角色添加相应的能力(capabilities)。

关键要点

  • 函数通过 add_role() 添加五个核心角色,包括 Administrator、Editor、Author、Contributor 和 Subscriber。
  • 使用 get_role() 获取角色对象,并通过 add_cap() 为每个角色分配特定能力,如 Administrator 拥有 switch_themes、edit_themes 等完整权限。
  • 权限分配包括管理主题、插件、用户、选项、评论、分类、链接、文件上传、导入、编辑文章和页面等,以及基于 level_* 的层级权限。
  • 此函数是 WordPress 2.0 引入的,作为角色系统的基础实现,后续版本可能通过 populate_roles() 调用。

代码示例

function populate_roles_160() {
    // Add roles.
    add_role( 'administrator', 'Administrator' );
    add_role( 'editor', 'Editor' );
    add_role( 'author', 'Author' );
    add_role( 'contributor', 'Contributor' );
    add_role( 'subscriber', 'Subscriber' );

    // Add caps for Administrator role.
    $role = get_role( 'administrator' );
    $role->add_cap( 'switch_themes' );
    // ... 更多权限分配代码
}

📄 原文内容

Create the roles for WordPress 2.0

Source

function populate_roles_160() {
	// Add roles.
	add_role( 'administrator', 'Administrator' );
	add_role( 'editor', 'Editor' );
	add_role( 'author', 'Author' );
	add_role( 'contributor', 'Contributor' );
	add_role( 'subscriber', 'Subscriber' );

	// Add caps for Administrator role.
	$role = get_role( 'administrator' );
	$role->add_cap( 'switch_themes' );
	$role->add_cap( 'edit_themes' );
	$role->add_cap( 'activate_plugins' );
	$role->add_cap( 'edit_plugins' );
	$role->add_cap( 'edit_users' );
	$role->add_cap( 'edit_files' );
	$role->add_cap( 'manage_options' );
	$role->add_cap( 'moderate_comments' );
	$role->add_cap( 'manage_categories' );
	$role->add_cap( 'manage_links' );
	$role->add_cap( 'upload_files' );
	$role->add_cap( 'import' );
	$role->add_cap( 'unfiltered_html' );
	$role->add_cap( 'edit_posts' );
	$role->add_cap( 'edit_others_posts' );
	$role->add_cap( 'edit_published_posts' );
	$role->add_cap( 'publish_posts' );
	$role->add_cap( 'edit_pages' );
	$role->add_cap( 'read' );
	$role->add_cap( 'level_10' );
	$role->add_cap( 'level_9' );
	$role->add_cap( 'level_8' );
	$role->add_cap( 'level_7' );
	$role->add_cap( 'level_6' );
	$role->add_cap( 'level_5' );
	$role->add_cap( 'level_4' );
	$role->add_cap( 'level_3' );
	$role->add_cap( 'level_2' );
	$role->add_cap( 'level_1' );
	$role->add_cap( 'level_0' );

	// Add caps for Editor role.
	$role = get_role( 'editor' );
	$role->add_cap( 'moderate_comments' );
	$role->add_cap( 'manage_categories' );
	$role->add_cap( 'manage_links' );
	$role->add_cap( 'upload_files' );
	$role->add_cap( 'unfiltered_html' );
	$role->add_cap( 'edit_posts' );
	$role->add_cap( 'edit_others_posts' );
	$role->add_cap( 'edit_published_posts' );
	$role->add_cap( 'publish_posts' );
	$role->add_cap( 'edit_pages' );
	$role->add_cap( 'read' );
	$role->add_cap( 'level_7' );
	$role->add_cap( 'level_6' );
	$role->add_cap( 'level_5' );
	$role->add_cap( 'level_4' );
	$role->add_cap( 'level_3' );
	$role->add_cap( 'level_2' );
	$role->add_cap( 'level_1' );
	$role->add_cap( 'level_0' );

	// Add caps for Author role.
	$role = get_role( 'author' );
	$role->add_cap( 'upload_files' );
	$role->add_cap( 'edit_posts' );
	$role->add_cap( 'edit_published_posts' );
	$role->add_cap( 'publish_posts' );
	$role->add_cap( 'read' );
	$role->add_cap( 'level_2' );
	$role->add_cap( 'level_1' );
	$role->add_cap( 'level_0' );

	// Add caps for Contributor role.
	$role = get_role( 'contributor' );
	$role->add_cap( 'edit_posts' );
	$role->add_cap( 'read' );
	$role->add_cap( 'level_1' );
	$role->add_cap( 'level_0' );

	// Add caps for Subscriber role.
	$role = get_role( 'subscriber' );
	$role->add_cap( 'read' );
	$role->add_cap( 'level_0' );
}

Changelog

Version Description
2.0.0 Introduced.