钩子文档

unregister_setting

💡 云策文档标注

概述

unregister_setting 是一个 WordPress 钩子,在设置被注销前触发,用于在移除过滤器后执行自定义操作。

关键要点

  • 这是一个动作钩子,通过 do_action 调用,允许开发者在设置注销前添加自定义代码。
  • 钩子接收两个参数:$option_group(设置组)和 $option_name(设置名称),用于标识要注销的具体设置。
  • 与 unregister_setting() 函数相关,用于注销设置,此钩子在其执行过程中触发。

注意事项

  • 此钩子从 WordPress 5.5.0 版本开始引入,使用时需确保版本兼容性。
  • 钩子触发时机在设置注销前且过滤器已移除后,适合执行清理或日志记录等操作。

📄 原文内容

Fires immediately before the setting is unregistered and after its filters have been removed.

Parameters

$option_groupstring
Setting group.
$option_namestring
Setting name.

Source

do_action( 'unregister_setting', $option_group, $option_name );

Changelog

Version Description
5.5.0 Introduced.