云策 WordPress 开发者社区

函数文档

wp_has_ability_category()

查看官方原文 ↗
💡 云策文档标注

概述

wp_has_ability_category() 函数用于检查指定的能力类别是否已注册，适用于条件逻辑和功能检测场景。

关键要点

  • 函数接受一个字符串参数 $slug，表示要检查的能力类别标识符
  • 返回布尔值：true 表示能力类别已注册，false 表示未注册
  • 内部通过 WP_Ability_Categories_Registry::get_instance() 获取注册表实例，并调用 is_registered() 方法进行验证

代码示例

// Displays different UI based on available ability categories.
if ( wp_has_ability_category( 'premium-features' ) ) {
    echo 'Premium Features Available';
} else {
    echo 'Standard Features';
}

注意事项

  • 在尝试检索或使用能力类别之前，建议先调用此函数进行条件检查，以避免潜在错误
  • 相关函数包括 WP_Ability_Categories_Registry::is_registered() 和 wp_get_ability_category()
  • 此函数自 WordPress 6.9.0 版本引入
📄 原文内容

Checks if an ability category is registered.

Description

Use this for conditional logic and feature detection before attempting to retrieve or use an ability category.

Example:

// Displays different UI based on available ability categories.
if ( wp_has_ability_category( 'premium-features' ) ) {
    echo 'Premium Features Available';
} else {
    echo 'Standard Features';
}

See also

Parameters

$slugstringrequired
The slug of the ability category to check.

Return

bool true if the ability category is registered, false otherwise.

Source

function wp_has_ability_category( string $slug ): bool {
	$registry = WP_Ability_Categories_Registry::get_instance();
	if ( null === $registry ) {
		return false;
	}

	return $registry->is_registered( $slug );
}

View all references View on Trac View on GitHub

Uses Description
WP_Ability_Categories_Registry::get_instance()wp-includes/abilities-api/class-wp-ability-categories-registry.php

Utility method to retrieve the main instance of the registry class.
Used by Description
WP_Abilities_Registry::register()wp-includes/abilities-api/class-wp-abilities-registry.php

Registers a new ability.

Changelog

Version Description
6.9.0 Introduced.