WordPress功能函数add_site_option()

WordPress功能函数add_site_option()，为当前网络添加一个新的选项。

用法：

add_site_option( string $option, mixed $value )

描述：

现有的选项将不会更新。注意，在3.3之前并非如此。

参见also

add_network_option ()

参数

$option

(string) (必需) 要添加的选项的名称。预计不会被sql转义。

$value

(mixed) (必需) 期权价值，可以是任何东西。预计不会被sql转义。

返回

(bool)添加该选项时为True，否则为false。

更多信息

这个函数本质上与add_option()相同，但在使用WP Multisite时在网络范围内工作。

唯一的主要区别是，在多站点站点范围的选项不会自动加载和在单一站点的选项将自动加载。与在单个站点上使用add_option()不同，该特性不能被覆盖。

来源：

文件: wp-includes/option.php

function add_site_option( $option, $value ) {

return add_network_option( null, $option, $value );

}

更新日志：

用户贡献的笔记

（MakeWebBetter贡献- 10个月前）

安装默认选项

if ( 1 == $wpmu ) {

if ( ! get_site_option( ‘wporg_lead_options’ ) ) {

add_site_option( ‘wporg_lead_options’, $wporg_lead_options_defaults, ”, ‘yes’ );

}

} else {

if ( ! get_option( ‘wporg_lead_options’ ) ) {

add_option( ‘wporg_lead_options’, $wporg_lead_options_defaults, ”, ‘yes’ );

}

}

（由Codex – 5年前贡献）

例子

默认的用法:

add_site_option( ‘my_option’, ‘my_value’ );

如果选项已经存在，则行为:

echo get_site_option( ‘i_exist_already’ );

// Output: ‘some_value’

if ( add_site_option( ‘i_exist_already’, ‘new_value’ ) ) {

echo get_site_option( ‘i_exist_already’ );

} else {

echo __( ‘Already exists’, ‘textdo**in’ );

}

（由PaulC53 – 6年前贡献）

参数$value是可选的。它不是可选的;它是必需的。