函数文档

wp_maybe_grant_resume_extensions_caps()

💡 云策文档标注

概述

wp_maybe_grant_resume_extensions_caps() 是一个 WordPress 过滤器函数,用于根据用户现有能力自动授予 'resume_plugins' 和 'resume_themes' 能力。它检查用户是否拥有 'activate_plugins' 或 'switch_themes' 能力,并相应设置 resume 能力。

关键要点

  • 该函数是一个过滤器,用于修改用户能力数组,添加 'resume_plugins' 和 'resume_themes' 能力。
  • 它基于用户是否拥有 'activate_plugins' 能力来授予 'resume_plugins' 能力,基于 'switch_themes' 能力来授予 'resume_themes' 能力。
  • 适用于多站点环境,确保常规管理员能恢复插件和主题。
  • 函数在 WordPress 5.2.0 版本中引入。

代码示例

function wp_maybe_grant_resume_extensions_caps( $allcaps ) {
    // Even in a multisite, regular administrators should be able to resume plugins.
    if ( ! empty( $allcaps['activate_plugins'] ) ) {
        $allcaps['resume_plugins'] = true;
    }

    // Even in a multisite, regular administrators should be able to resume themes.
    if ( ! empty( $allcaps['switch_themes'] ) ) {
        $allcaps['resume_themes'] = true;
    }

    return $allcaps;
}

📄 原文内容

Filters the user capabilities to grant the ‘resume_plugins’ and ‘resume_themes’ capabilities as necessary.

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_resume_extensions_caps( $allcaps ) {
	// Even in a multisite, regular administrators should be able to resume plugins.
	if ( ! empty( $allcaps['activate_plugins'] ) ) {
		$allcaps['resume_plugins'] = true;
	}

	// Even in a multisite, regular administrators should be able to resume themes.
	if ( ! empty( $allcaps['switch_themes'] ) ) {
		$allcaps['resume_themes'] = true;
	}

	return $allcaps;
}

Changelog

Version Description
5.2.0 Introduced.