钩子文档

add_site_option

💡 云策文档标注

概述

add_site_option 是一个 WordPress Hook,在网络选项成功添加后触发。它允许开发者在网络级别选项被添加时执行自定义代码。

关键要点

  • 这是一个动作 Hook,用于在网络选项添加后执行操作。
  • Hook 接受三个参数:$option(选项名称)、$value(选项值)和 $network_id(网络 ID)。
  • 与 add_network_option() 函数相关,用于添加网络选项。
  • 自 WordPress 4.7.0 版本起,添加了 $network_id 参数。

代码示例

do_action( 'add_site_option', $option, $value, $network_id );

注意事项

  • 此 Hook 仅在网络选项成功添加后触发,确保操作基于有效数据。
  • 参数 $network_id 在 4.7.0 版本中引入,用于多站点环境中的网络标识。

📄 原文内容

Fires after a network option has been successfully added.

Parameters

$optionstring
Name of the network option.
$valuemixed
Value of the network option.
$network_idint
ID of the network.

Source

do_action( 'add_site_option', $option, $value, $network_id );

Changelog

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