如何使用 add_cap 函數為 WordPress 角色添加額外的能力

在 WordPress 中，使用者角色（role）決定了用戶在網站上可以執行哪些操作。每個角色都有預設的能力（capabilities），例如編輯文章、發布文章等。有時，您可能需要為某個角色添加更多的能力，以滿足特定的需求。這可以通過 add_cap 函數來實現。

能力（Capabilities）：定義了使用者在網站上能夠執行的具體操作，例如發布文章、編輯頁面、審核評論等。
角色（Roles）：由多個能力組成，每個角色具有一組預定義的能力。例如，管理員（Administrator）擁有最廣泛的能力，而訂閱者（Subscriber）則只能管理自己的個人資料。

要為特定的角色添加新的能力，您可以使用 get_role 函數來取得角色的物件，然後使用 add_cap 函數來設置新的能力。

操作說明：
1. 打開您自定義的外掛 PHP 文件或主題的 functions.php 文件。
2. 添加以下代碼來為特定角色添加新的能力。
範例代碼：
```
// 為特定角色添加額外的能力
function add_custom_capabilities() {
    // 取得角色物件
    $role = get_role('manager');
    
    // 添加新的能力
    if ($role) {
        $role->add_cap('Acapacity'); // 添加能力 A
        $role->add_cap('Bcapacity'); // 添加能力 B
        $role->add_cap('Ccapacity'); // 添加能力 C
    }
}
add_action('init', 'add_custom_capabilities');
```
代碼解釋：
- $role = get_role('manager');：這行代碼通過 get_role 函數取得角色物件，manager 是角色的系統名稱。此角色必須已存在於系統中。
- $role->add_cap('Acapacity');：這行代碼為角色添加名為 Acapacity 的新能力。可以重複使用 add_cap 函數來添加多個能力。
- add_action('init', 'add_custom_capabilities');：這行代碼將 add_custom_capabilities 函數綁定到 WordPress 的 init 鉤子上，確保在系統初始化時添加這些能力。

除了基本的讀寫和管理能力，您還可以為角色添加更高級的操作能力。例如：

針對文章的能力：
- edit_posts：允許編輯自己的文章。
- edit_others_posts：允許編輯其他使用者的文章。
- publish_posts：允許發布文章。
針對頁面的能力：
- edit_pages：允許編輯頁面。
- publish_pages：允許發布頁面。
針對使用者的能力：
- list_users：允許查看使用者列表。
- create_users：允許創建新使用者。
針對插件和主題的能力：
- activate_plugins：允許啟用或停用插件。
- install_themes：允許安裝主題。
其他能力：
- manage_options：允許更改網站選項。
- moderate_comments：允許審核評論。

完成上述代碼編寫後，請保存文件並登錄到 WordPress 後台檢查結果。您應該會發現該角色的使用者已經擁有了新的能力，並且可以執行之前無法執行的操作。