钩子文档

wp_abilities_api_init

💡 云策文档标注

概述

wp_abilities_api_init 是一个 WordPress 动作钩子,在准备能力注册表时触发,用于确保能力仅在需要时加载。

关键要点

  • 此钩子在准备能力注册表时触发,允许开发者在此时创建和注册能力钩子。
  • 建议在此钩子上注册能力,而不是其他钩子,以避免不必要的加载。
  • 钩子参数为 $instance,类型为 WP_Abilities_Registry,表示能力注册表对象。
  • 此钩子从 WordPress 6.9.0 版本开始引入。

代码示例

do_action( 'wp_abilities_api_init', self::$instance );

注意事项

使用 WP_Abilities_Registry::get_instance() 方法可以获取注册表的主要实例。


📄 原文内容

Fires when preparing abilities registry.

Description

Abilities should be created and register their hooks on this action rather than another action to ensure they’re only loaded when needed.

Parameters

$instanceWP_Abilities_Registry
Abilities registry object.

Source

do_action( 'wp_abilities_api_init', self::$instance );

Changelog

Version Description
6.9.0 Introduced.