函数文档

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.

Return

bool[] Filtered array of 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.