函数文档

wp_register_core_ability_categories()

💡 云策文档标注

概述

该文档介绍了 wp_register_core_ability_categories() 函数,用于注册核心能力类别。函数返回 void,包含两个类别:site 和 user。

关键要点

  • 函数 wp_register_core_ability_categories() 注册核心能力类别,无返回值。
  • 使用 wp_register_ability_category() 注册具体类别,如 'site' 和 'user',每个类别包含 label 和 description 参数。
  • 该函数在 WordPress 6.9.0 版本中引入。

代码示例

function wp_register_core_ability_categories(): void {
	wp_register_ability_category(
		'site',
		array(
			'label'       => __( 'Site' ),
			'description' => __( 'Abilities that retrieve or modify site information and settings.' ),
		)
	);

	wp_register_ability_category(
		'user',
		array(
			'label'       => __( 'User' ),
			'description' => __( 'Abilities that retrieve or modify user information and settings.' ),
		)
	);
}

注意事项

  • 函数返回 void,表示不返回任何值。
  • 依赖 wp_register_ability_category() 和 __() 函数,用于注册类别和翻译文本。
  • 相关文件包括 wp-includes/abilities-api.php 和 wp-includes/l10n.php。

📄 原文内容

Registers the core ability categories.

Return

void

Source

function wp_register_core_ability_categories(): void {
	wp_register_ability_category(
		'site',
		array(
			'label'       => __( 'Site' ),
			'description' => __( 'Abilities that retrieve or modify site information and settings.' ),
		)
	);

	wp_register_ability_category(
		'user',
		array(
			'label'       => __( 'User' ),
			'description' => __( 'Abilities that retrieve or modify user information and settings.' ),
		)
	);
}

Changelog

Version Description
6.9.0 Introduced.