钩子文档

updated_option

💡 云策文档标注

概述

updated_option 是一个 WordPress 钩子,在选项值成功更新后触发,用于执行后续操作。

关键要点

  • 触发时机:选项值更新成功后立即执行
  • 参数:$option(选项名称)、$old_value(旧值)、$value(新值)
  • 相关函数:与 update_option() 配合使用,用于处理已存在选项的更新

代码示例

do_action( 'updated_option', $option, $old_value, $value );

注意事项

  • 此钩子自 WordPress 2.9.0 版本引入
  • 适用于需要响应选项变更的场景,如缓存清理或数据同步

📄 原文内容

Fires after the value of an option has been successfully updated.

Parameters

$optionstring
Name of the updated option.
$old_valuemixed
The old option value.
$valuemixed
The new option value.

Source

do_action( 'updated_option', $option, $old_value, $value );

Changelog

Version Description
2.9.0 Introduced.