Question

add_site_option( string $option,  mixed $value )

Add a new option for the current network.

---

description

Existing options will not be updated. Note that prior to 3.3 this wasn’t the case.

---

参数

$option

(string) (Required) Name of option to add. Expected to not be SQL-escaped.

$value

(mixed) (Required) Option value, can be anything. Expected to not be SQL-escaped.

---

返回值

(bool) False if the option was not added. True if the option was added.

---

源代码

File: wp-includes/option.php

function add_site_option( $option, $value ) {
	return add_network_option( null, $option, $value );
}

---

更新日志

Version	description
4.4.0	Modified into wrapper for add_network_option()
2.8.0	Introduced.

---

相关函数

Uses

• wp-includes/option.php: add_network_option()

---

Used By

• wp-includes/option.php: set_site_transient()
• wp-includes/ms-functions.php: wpmu_validate_user_signup()
• wp-includes/ms-functions.php: wpmu_validate_blog_signup()

---

User Contributed Notes

1. Skip to note content You must log in to vote on the helpfulness of this noteVote results for this note: 0You must log in to vote on the helpfulness of this note Contributed by Codex

   Examples

   Default usage:

   
   add_site_option( 'my_option', 'my_value' );
   

   Behavior if the option already exists:

   
   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' );
   }
   

Parameter $value is listed as optional. It is not optional; it is required.