wp_register_ability_category() — описание функции WordPress на русском

Сигнатура

wp_register_ability_category( string $slug, $args ): WP_Ability_Category|null

Описание

Русский перевод этого описания пока проверяется. Показан оригинал.

Ability categories provide a way to organize and group related abilities for better discoverability and management. Ability categories must be registered before abilities that reference them.

Ability categories must be registered on the wp_abilities_api_categories_init action hook.

Example:

function my_plugin_register_categories() {
    wp_register_ability_category(
        'content-management',
        array(
            'label'       => __( 'Content Management', 'my-plugin' ),
            'description' => __( 'Abilities for managing and organizing content.', 'my-plugin' ),
        )
    );
}
add_action( 'wp_abilities_api_categories_init', 'my_plugin_register_categories' );

Параметры

$slug string обязательный

Уникальный слаг категории способностей. Может содержать только строчные буквенно-цифровые символы и дефисы (например, 'data-export').

Возвращаемое значение

WP_Ability_Category|null

null

Исходный код

wp-includes/abilities-api.php:467

function wp_register_ability_category( string $slug, array $args ): ?WP_Ability_Category {
	if ( ! doing_action( 'wp_abilities_api_categories_init' ) ) {
		_doing_it_wrong(
			__FUNCTION__,
			sprintf(
				/* translators: 1: wp_abilities_api_categories_init, 2: ability category slug. */
				__( 'Ability categories must be registered on the %1$s action. The ability category %2$s was not registered.' ),
				'<code>wp_abilities_api_categories_init</code>',
				'<code>' . esc_html( $slug ) . '</code>'
			),
			'6.9.0'
		);
		return null;
	}

	$registry = WP_Ability_Categories_Registry::get_instance();
	if ( null === $registry ) {
		return null;
	}

	return $registry->register( $slug, $args );
}

История изменений

Версия	Описание
6.9.0	Introduced.