编辑“WordPress:Function Reference/add option”

== Description ==

== 描述==

A safe way of adding a named option/value pair to the options database table. It does nothing if the option already exists. The data is escaped with %%%$wpdb->escape%%% before the INSERT statement.

安全地将指定的选项/和选项值添加到选项数据库表格中。如果选项已经存在，不执行任何操作。插入声明之前，The data is escaped with %%%$wpdb->escape%%%。

== Usage for wp 2.3.X or newer ==

== wp 2.3.X 或者更新版本的用法 ==


In the lasts versions of wordpress (2.3.X) the parameter $description is deprecated and remove the values from the wp_options table.
The usage its the same but the seccond parameter its unused.

在最新的WordPress版本（2.3X），参数$description已经取消了，而且wp_options表格中的参数值也取消了。
用法是相同的但是第二个参数没有得到使用。

See bellow for older version of this reference

看看下面关于这个参考的旧版本

<pre>
<?php add_option($name, $value = '', $deprecated = '', $autoload = 'yes'); ?>
</pre>

<pre>
<?php add_option($name, $value = '', $deprecated = '', $autoload = 'yes'); ?>
</pre>

== Example for wp 2.3.X or newer ==

== wp 2.3.X 或者更新版本的例子 ==


<pre>
<?php add_option("myhack_extraction_length", '255', '', 'yes'); ?>
</pre>

<pre>
<?php add_option("myhack_extraction_length", '255', '', 'yes'); ?>
</pre>

== Parameters for wp 2.3.X or newer ==

== 来自 wp 2.3.X或者更新版本的参数==


{{Parameter|$name|string|Name of the option to be added. Use underscores to separate words, and do not use uppercase—this is going to be placed into the database.}}

{{Parameter|$name|string|将要添加的选项的名称。使用下划线将单词分开，而且不要使用大写字母—这个名称将会放入数据库。}}


{{Parameter|$value|string|Value for this option name.|optional|''Empty''}}


{{Parameter|$value|string|这个选项名称的参数值。|optional|''Empty''}}

{{Parameter|$deprecated|string|Unused.|optional|''Empty''}}
{{Parameter|$autoload|string|Should this option be automatically loaded by the function <tt>wp_load_alloptions</tt> (puts options into object cache on each page load)?  Valid values: '''yes''' or '''no'''.|optional|yes}}



{{Parameter|$deprecated|string|Unused.|optional|''Empty''}}
{{Parameter|$autoload|string|这个选项应该由函数 <tt>wp_load_alloptions</tt> 自动地载入吗(将选项放入object cache on each page load)?  有效地参数值: '''yes''' 或者'''no'''.|optional|yes}}


== Usage before $description deprecated ==

== $description取消之前的用法 ==



<pre>
In the last versions of wordpress (2.3.X) the parameter $description is deprecated and remove the values from the wp_options table.
The usage its the same but the seccond parameter its unused.
WP 2.3.X or newer 
<?php add_option($name, $value = '', $deprecated = '', $autoload = 'yes'); ?>


<pre>
在wordpress最新的版本I (2.3.X) 参数$description 已经被取消，而且从the wp_options 表格中取消了参数值。
用法是相同的但是没有使用第二个参数。
WP 2.3.X 或者更新的版本
<?php add_option($name, $value = '', $deprecated = '', $autoload = 'yes'); ?>


<?php add_option($name, $value = '', $description = '', $autoload = 'yes'); ?>
</pre>

<?php add_option($name, $value = '', $description = '', $autoload = 'yes'); ?>
</pre>

== Example ==
== 例子 ==
<pre>
<?php add_option("myhack_extraction_length", '255', 
'Max length of extracted text in characters.', 'yes'); ?>
</pre>

<pre>
<?php add_option("myhack_extraction_length", '255', 
'字符中提取的文章的最长长度。', 'yes'); ?>
</pre>

== Parameters before $description deprecated ==
== $description取消之前的参数 ==
{{Parameter|$name|string|Name of the option to be added. Use underscores to separate words, and do not use uppercase—this is going to be placed into the database.}}

{{Parameter|$name|string|将要添加的选项的名称。使用下划线将单词分开，而且不可以使用大写字母—这个名称将会放入数据库中。}}


{{Parameter|$value|string|Value for this option name.|optional|''Empty''}}


{{Parameter|$value|string|关于这个选项名称的参数值。|optional|''Empty''}}

{{Parameter|$description|string|Descriptive text for the option. The description can be used in backend labels.|optional|''Empty''}}


{{Parameter|$description|string|关于选项的描述性文本。可以在backend标签中使用这个描述。|optional|''Empty''}}


{{Parameter|$autoload|string|Should this option be automatically loaded? Valid values: '''yes''' or '''no'''.|optional|yes}}

{{Parameter|$autoload|string|应该自动地载入这个选项吗?有效的参数值: '''yes''' or '''no'''.|optional|yes}}