钩子文档

update_option_{$option}

💡 云策文档标注

概述

update_option_{$option} 是一个 WordPress 动态 Hook,在特定选项值成功更新后触发。它允许开发者在选项变更时执行自定义代码。

关键要点

  • 这是一个动态 Hook,$option 部分指代选项名称,例如 update_option_my_option。
  • 触发时机:仅在选项值实际改变(旧值与新值不同)时触发,不会在值相同时触发。
  • 参数包括 $old_value(旧值)、$value(新值)和 $option(选项名称)。
  • 与 update_option() 函数关联,用于更新已存在的选项。
  • 版本历史:从 2.0.1 引入,4.4.0 添加了 $option 参数。

注意事项

  • 如果旧值和新值完全相同,此 Hook 不会触发,以避免不必要的数据库操作。
  • 若需要在更新选项时始终执行代码,建议使用 pre_update_option_{$option} Hook 作为替代。

📄 原文内容

Fires after the value of a specific option has been successfully updated.

Description

The dynamic portion of the hook name, $option, refers to the option name.

Parameters

$old_valuemixed
The old option value.
$valuemixed
The new option value.
$optionstring
Option name.

Source

do_action( "update_option_{$option}", $old_value, $value, $option );

Changelog

Version Description
4.4.0 The $option parameter was added.
2.0.1 Introduced.

User Contributed Notes