WordPress功能函數(shù)add_site_option()
WordPress功能函數(shù)add_site_option(),為當(dāng)前網(wǎng)絡(luò)添加一個(gè)新的選項(xiàng)。
用法:
add_site_option( string $option, mixed $value )
描述:
現(xiàn)有的選項(xiàng)將不會(huì)更新。注意,在3.3之前并非如此。
參見also
add_network_option ()
參數(shù)
$option
(string) (必需) 要添加的選項(xiàng)的名稱。預(yù)計(jì)不會(huì)被sql轉(zhuǎn)義。
$value
(mixed) (必需) 期權(quán)價(jià)值,可以是任何東西。預(yù)計(jì)不會(huì)被sql轉(zhuǎn)義。
返回
(bool)添加該選項(xiàng)時(shí)為True,否則為false。
更多信息
這個(gè)函數(shù)本質(zhì)上與add_option()相同,但在使用WP Multisite時(shí)在網(wǎng)絡(luò)范圍內(nèi)工作。
唯一的主要區(qū)別是,在多站點(diǎn)站點(diǎn)范圍的選項(xiàng)不會(huì)自動(dòng)加載和在單一站點(diǎn)的選項(xiàng)將自動(dòng)加載。與在單個(gè)站點(diǎn)上使用add_option()不同,該特性不能被覆蓋。
來源:
文件: wp-includes/option.php
function add_site_option( $option, $value ) {
return add_network_option( null, $option, $value );
}
更新日志:

用戶貢獻(xiàn)的筆記
(MakeWebBetter貢獻(xiàn)- 10個(gè)月前)
安裝默認(rèn)選項(xiàng)
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年前貢獻(xiàn))
例子
默認(rèn)的用法:
add_site_option( 'my_option', 'my_value' );
如果選項(xiàng)已經(jīng)存在,則行為:
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', 'textdomain' );
}
(由PaulC53 - 6年前貢獻(xiàn))
參數(shù)$value是可選的。它不是可選的;它是必需的。