wp_maybe_grant_install_languages_cap()
云策文档标注
概述
wp_maybe_grant_install_languages_cap() 是一个 WordPress 过滤器函数,用于根据用户现有能力动态授予 'install_languages' 能力。它检查用户是否具备更新核心、安装插件或安装主题中的至少一项能力,以决定是否授予语言安装权限。
关键要点
- 函数 wp_maybe_grant_install_languages_cap() 过滤用户能力数组,自动添加 'install_languages' 能力。
- 授予条件:用户必须至少拥有 'update_core'、'install_plugins' 或 'install_themes' 中的一项能力。
- 参数 $allcaps 是必需的用户能力数组,返回过滤后的能力数组。
- 该函数自 WordPress 4.9.0 版本引入。
代码示例
function wp_maybe_grant_install_languages_cap( $allcaps ) {
if ( ! empty( $allcaps['update_core'] ) || ! empty( $allcaps['install_plugins'] ) || ! empty( $allcaps['install_themes'] ) ) {
$allcaps['install_languages'] = true;
}
return $allcaps;
}
原文内容
Filters the user capabilities to grant the ‘install_languages’ capability as necessary.
Description
A user must have at least one out of the ‘update_core’, ‘install_plugins’, and ‘install_themes’ capabilities to qualify for ‘install_languages’.
Parameters
$allcapsbool[]required-
An array of all the user’s capabilities.
Source
function wp_maybe_grant_install_languages_cap( $allcaps ) {
if ( ! empty( $allcaps['update_core'] ) || ! empty( $allcaps['install_plugins'] ) || ! empty( $allcaps['install_themes'] ) ) {
$allcaps['install_languages'] = true;
}
return $allcaps;
}
Changelog
| Version | Description |
|---|---|
| 4.9.0 | Introduced. |