WordPress: Function Reference/add option:修订间差异

来自站长百科
跳转至: 导航、​ 搜索
无编辑摘要
无编辑摘要
 
第1行: 第1行:
== 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.
安全地将指定的选项/和选项值添加到选项数据库表格中。如果选项已经存在,不执行任何操作。插入声明之前,option_name 参数值与 %%%$wpdb->escape%%%都逸出了
 
安全地将指定的选项/和选项值添加到选项数据库表格中。如果选项已经存在,不执行任何操作。插入声明之前,The data is escaped with %%%$wpdb->escape%%%
 
== Usage for wp 2.3.X or newer ==
 
== wp 2.3.X 或者更新版本的用法 ==
== 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表格中的参数值也取消了。
在最新的WordPress版本(2.3X),参数$description已经取消了,而且wp_options表格中的参数值也取消了。
用法是相同的但是第二个参数没有得到使用。
用法是相同的但是第二个参数没有得到使用。
See bellow for older version of this reference


看看下面关于这个参考的旧版本
看看下面关于这个参考的旧版本
<pre>
<pre>
<?php add_option($name, $value = '', $deprecated = '', $autoload = 'yes'); ?>
<?php add_option($name, $value = '', $deprecated = '', $autoload = 'yes'); ?>
</pre>
</pre>
<pre>
<?php add_option($name, $value = '', $deprecated = '', $autoload = 'yes'); ?>
</pre>
== Example for wp 2.3.X or newer ==


== wp 2.3.X 或者更新版本的例子 ==
== wp 2.3.X 或者更新版本的例子 ==
<pre>
<pre>
<?php add_option("myhack_extraction_length", '255', '', 'yes'); ?>
<?php add_option("myhack_extraction_length", '255', '', 'yes'); ?>
</pre>
</pre>
<pre>
<?php add_option("myhack_extraction_length", '255', '', 'yes'); ?>
</pre>
== Parameters for wp 2.3.X or newer ==


== 来自 wp 2.3.X或者更新版本的参数==
== 来自 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|$name|string|将要添加的选项的名称。使用下划线将单词分开,而且不要使用大写字母—这个名称将会放入数据库。}}
{{Parameter|$value|string|Value for this option name.|optional|''Empty''}}
{{Parameter|$value|string|这个选项名称的参数值。|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|$deprecated|string|Unused.|optional|''Empty''}}
{{Parameter|$autoload|string|这个选项应该由函数 <tt>wp_load_alloptions</tt> 自动地载入吗(将选项放入object cache on each page load)?  有效地参数值: '''yes''' 或者'''no'''.|optional|yes}}
{{Parameter|$autoload|string|这个选项应该由函数 <tt>wp_load_alloptions</tt> 自动地载入吗(将选项放入object cache on each page load)?  有效地参数值: '''yes''' 或者'''no'''.|optional|yes}}
== Usage before $description deprecated ==


== $description取消之前的用法 ==
== $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>
<pre>
第86行: 第32行:
<?php add_option($name, $value = '', $deprecated = '', $autoload = 'yes'); ?>
<?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>
<pre>
<?php add_option("myhack_extraction_length", '255',  
<?php add_option("myhack_extraction_length", '255',  
第105行: 第38行:
</pre>
</pre>


== Parameters before $description deprecated ==
== $description取消之前的参数 ==
== $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|$name|string|将要添加的选项的名称。使用下划线将单词分开,而且不可以使用大写字母—这个名称将会放入数据库中。}}
{{Parameter|$value|string|Value for this option name.|optional|''Empty''}}


{{Parameter|$value|string|关于这个选项名称的参数值。|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|$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}}
{{Parameter|$autoload|string|应该自动地载入这个选项吗?有效的参数值: '''yes''' or '''no'''.|optional|yes}}

2008年7月28日 (一) 11:37的最新版本

描述[ ]

安全地将指定的选项/和选项值添加到选项数据库表格中。如果选项已经存在,不执行任何操作。插入声明之前,option_name 参数值与 %%%$wpdb->escape%%%都逸出了

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

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

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

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

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

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

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

$description取消之前的用法[ ]

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

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

$description取消之前的参数[ ]