钩子文档

add_site_option_{$option}

💡 云策文档标注

概述

add_site_option_{$option} 是一个 WordPress 动态 Hook,在成功添加特定网络选项后触发。它允许开发者在网络选项添加时执行自定义操作。

关键要点

  • 这是一个动态 Hook,$option 部分对应选项名称,用于针对特定选项触发。
  • Hook 参数包括选项名称、选项值和网络 ID,便于开发者访问相关数据。
  • 从 WordPress 4.7.0 版本开始,新增了 $network_id 参数,支持多网络环境。
  • 与 add_network_option() 函数关联,用于添加网络选项时触发此 Hook。

注意事项

  • Hook 名称是动态的,使用时需替换 $option 为具体选项名,例如 add_site_option_my_option。
  • 确保在添加网络选项后使用此 Hook,以避免逻辑错误。

📄 原文内容

Fires after a specific network option has been successfully added.

Description

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

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}", $option, $value, $network_id );

Changelog

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