WordPress中的钩子（hooks）是一种机制，允许开发者在特定的时刻插入自己的代码。其中，`additional_capabilities_display`是一种特殊的钩子，用于在用户界面（用户编辑页面）中显示额外的用户能力。
以下是关于`additional_capabilities_display`钩子的详细解释和用法。
1. `additional_capabilities_display`钩子的定义：
/**
* Filters the display of additional capabilities for roles.
*
* @since 3.0.0
*
* @param array $caps {
* Array of the capabilities for the role.
*
* @type string $edit_posts Capability to edit posts.
* @type string $delete_posts Capability to delete posts.
* @type string $read_posts Capability to read posts.
* @type string $edit_others_posts Capability to edit others' posts.
* @type string $publish_posts Capability to publish posts.
* @type string $read_private_posts Capability to read private posts.
* @type string $read Capability to read.
* }
* @param string $role Role name.
*/
apply_filters( 'additional_capabilities_display', $caps, $role );
2. 在何处使用`additional_capabilities_display`钩子：
`additional_capabilities_display`钩子的主要用途是在用户编辑界面中显示额外权限。这些额外的权限可以是任何自定义的用户能力。可以将该钩子添加到`admin_init`钩子中，以便在后台初始化时调用。
3. 如何使用`additional_capabilities_display`钩子：
下面是一个使用`additional_capabilities_display`钩子的示例，用于显示自定义用户能力：
function custom_additional_capabilities_display( $caps, $role ) {
// 添加一个自定义用户能力
$caps['edit_custom_posts'] = true;
return $caps;
}
add_filter( 'additional_capabilities_display', 'custom_additional_capabilities_display', 10, 2 );
在上面的代码中，我们添加了一个名为`edit_custom_posts`的自定义用户能力，并将其设置为`true`。这将在用户编辑页面的附加能力部分显示一个新的选项。
4. 注意事项：
- 在使用`additional_capabilities_display`钩子时，注意将其添加到正确的位置。最好将其添加到主题的`functions.php`文件中。
- 在添加自定义用户能力时，请确保为其分配适当的权限和访问级别。
- 可以使用其他钩子（如`user_has_cap`）来控制自定义用户能力的实际权限。
- 始终测试和验证你的代码，以确保它按预期工作。
