WordPress用戶角色與用戶能力-權限

wordpress用戶角色(user roles)是 WP 或者其它插件增加的,可以讓網站管理員(網站管理員也是一種角色)來方便的管理用戶的權限/能力(Capabilities,一般情況下,一種角色不止有一種能力,所以用復數),使用免費的插件,可以方便的管理每種角色的能力,簡單的理解是:角色具有某些能力,是某些能力的代稱。WordPress 用戶角色與用戶能力/權限(Roles and Capabilities)系統是自 WordPress2.0 起被逐步完善的。

WORDPRESS 自身的用戶角色

僅指 WordPress 安裝時就有的幾種用戶角色(所列為角色名稱):

• Subscriber:訂閱者
• Contributor :投稿者
• Author :作者
• Editor :編輯
• Administrator :管理員

此外,如果啟用了 WordPress 多站,將會多出一種用戶角色:Super Admin(超級管理員)。

WORDPRESS 自身的用戶能力/權限,WordPress 在安裝完畢之后,會為各個用戶角色分配默認的用戶能力/權限,各個用戶能力/權限的名稱(ID)以及其含義此不贅述。

WORDPRESS 自身的用戶能力/權限的用途

廣泛,可以限定用戶權限,這是明擺的事情,例如:用在插件或者主題的設置后臺,以限制可看到菜單項并進行某些操作的用戶組;限制可以發表/修改/刪除自己的文章(如果有權限發表的話)/別人的文章等等。有時候在輸出某些內容或者存儲某些內容之前,有必要檢查下當前已登錄用戶的權限,這時候就需要進行權限檢查了:

1. if ( current_user_can( $capability ) ) {

2. //為有權限的用戶做些什么

3. }

還可以在循環中檢查當前用戶是否有對某個對象的操作能力:

1. current_user_can( 'edit_post', $post_id );

還可以對文章(廣義上的文章,泛指各種文章類型的文章)的作者的權限進行檢查:

1. if ( author_can( $post, $capability ) ) {

2. // 如果作者有相應權限,怎么著

3. }

比如,有某種權限了,就直接發表,否則就置為草稿或者待審狀態等。

以用戶為對象的角色、能力/權限操作

在 WordPress 中,只要角色之間的能力互不沖突(一般情況下不會發生這種事情),同一個用戶可以同時有多種角色。在獲取用戶對象之后,可以 為某個用戶添加一種角色:

1. $user->add_role( $role_name );

如果想限定某用戶只有一種角色,可以用:

1. $user->set_role( $role_name );

移除用戶的某個角色:

1. $user->remove_role( $role_name );

用戶的能力/權限操作

1. // 檢查給定用戶是否有某種能力/權限或者角色

2. if ( $user->has_cap( $cap_name ) ) {

3. // 做點兒啥

4. }

5. // 為給定用戶添加一種能力/權限

6. $user->add_cap( $cap_name );

7. // 為給定用戶移除一種能力/權限

8. $user->remove_cap( $cap_name );

9. // 為給定用戶移除全部能力

10. $user->remove_all_caps();

以網站為對象的角色、能力/權限操作

注意:進行這些操作的時候,最后聲明下全局變量 global $wp_roles;,然后以$wp_roles->add_role();、 $wp_roles->remove_role();的方式進行操作,特別是在插件中使用時。
添加用戶角色

1. /*

2. $role_name:相當于角色的ID;

3. $display_name:角色的顯示名稱,支持本地化字符;

4. $capabilities:該角色應具有的能力組成的數組(能力ID/名稱為ID,值為值組成的數組)

5. */

6. add_role( $role_name, $display_name, $capabilities );

示例:

1. add_role( 'pama', '銀牌會員', array('read'=>true,'level_0'=>true) );

刪除用戶角色

1. remove_role( $role_name );

示例:

1. remove_role( 'pama' );

獲取用戶角色對象

1. get_role( $role );

添加自定義的用戶能力/權限

1. // 獲取 "pama" 角色對象

2. $role = get_role( 'author' );

3. // 為該角色對象添加 "sleep" 能力

4. $role->add_cap( 'sleep' );