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 );
Skip to note 2 content
orkans
It’s worth mentioning that this hook won’t fire if the old option value is exactly the same as the new one, meaning it won’t change anything in DB.
If you want to fire some additional code on update option event, I suggest using
"pre_update_option_{$option}"hook instead.