说明
这是一种向选项数据库表中添加有名称的选项/值对的安全方法。如果所需选项已存在,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函数自动加载(加载每个页面时将选项放在对象缓存中)?有效值:yes或no。
默认值: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
(字符串)(可选)当前选项是否需要被自动加载?有效值:yes或no。
默认值:yes
分类:中文手册