常用函数-add_option()

0条评论

说明

这是一种向选项数据库表中添加有名称的选项/值对的安全方法。如果所需选项已存在,add_option()不添加内容。选项被保存后,可通过get_option()来访问选项,通过update_option()来修改选项,还可以通过delete_option()删除该选项。

在INSERT语句前,add_option的值被$wpdb->escape 跳过。

WP 2.3系列版本或更高版本的用法

WP 2.3系列中,$description参数已经停用,wp_option表中也删除了该参数的值。用法相同,但不再使用第二个参数。

该函数在早期版本中的用法见下文

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

WP 2.3系列版本或更高版本中该函数的示例

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

WP 2.3系列版本或更高版本中该函数的参数

$name

(字符串)(必需)需要添加的选项名称。用下划线隔开单词;不要使用大写字母——参数值会被存入数据库

默认值:None

$value

(字符串)(可选)当前选项名称的值。限制在2到32个字节内

默认值:Empty

$deprecated

(字符串)(可选)不再使用

默认值:Empty

$autoload

(字符串)(可选)当前选项是否需要被wp_load_alloptions函数自动加载(加载每个页面时将选项放在对象缓存中)?有效值:yesno

默认值:yes

$description停用前该函数的用法

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


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

示例

<?php add_option("myhack_extraction_length", '255',   'Max length of extracted text in characters.', 'yes'); ?>  

$description停用前该函数的参数

$name

(字符串)(必需)需要添加的选项名称。用下划线隔开单词;不要使用大写字母——参数值会被存入数据库

默认值:None

$value

(字符串)(可选)当前选项名称的值。

默认值:Empty

$deprecated

(字符串)(可选)当前选项的描述性文字。描述可用在后台标签中。

默认值:Empty

$autoload

(字符串)(可选)当前选项是否需要被自动加载?有效值:yesno

默认值:yes