钩子文档

update_site_option_{$option}

💡 云策文档标注

概述

update_site_option_{$option} 是一个 WordPress 网络选项更新后触发的动态 Hook,用于在特定网络选项值成功更新后执行自定义代码。

关键要点

  • 这是一个动态 Hook,$option 部分对应网络选项的名称。
  • Hook 参数包括选项名称、当前值、旧值和网络 ID。
  • 主要用于 update_network_option() 函数更新网络选项后。
  • 从 WordPress 4.7.0 版本开始添加了 $network_id 参数。

注意事项

  • Hook 名称是动态的,使用时需替换 $option 为具体选项名。
  • 确保在 update_network_option() 调用后使用此 Hook。

📄 原文内容

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

Description

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

Parameters

$optionstring
Name of the network option.
$valuemixed
Current value of the network option.
$old_valuemixed
Old value of the network option.
$network_idint
ID of the network.

Source

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

Changelog

Version Description
4.7.0 The $network_id parameter was added.
3.0.0
2.9.0 Introduced.