选项

概述

这 选项API 是将数据存储在数据库中的一种简单而标准化的方法。API使创建，访问，更新和删除选项变得容易。所有数据都存储在 wp_options表 在给定的自定义名称中。

此页面包含使用选项API所需的技术文档。可以在 选项参考（链接到Codex版本，等待内容迁移到HelpHub）。

请注意_site_函数基本与其对应物相同。WP多站点发生的唯一差异时，当选项应用于网络范围内并且数据存储在 wp_sitemeta 给定的自定义名称下的表。

功能参考

添加/删除选项：

• add_option（）
• delete_option（）
• add_site_option（）
• delete_site_option（）

获取/更新选项：

• get_option（）
• update_option（）
• get_site_option（）
• update_site_option（）

例子

// Create an option to the database
add_option( $option, $value = , $deprecated = , $autoload = 'yes' );

// Removes option by name.
delete_option( $option );

// Fetch a saved option
get_option( $option, $default = false );

// Update the value of an option that was already added.
update_option( $option, $newvalue );

可用的选项按类别

讨论

• blacklist_keys：当评论中包含其内容，名称，URL，电子邮件或IP中的任何一个单词时，它将标记为垃圾邮件。一个单词或IP每行。它将匹配内部单词，因此“按”将与“ WordPress”匹配。
  默认值：null
  数据类型：字符串（可能是多行）
• comment_max_links：如果包含此选项或更多的值，则在队列中保留评论。
  默认值：2
  数据类型：整数
• comment_moderation：在出现评论之前，管理员必须始终批准评论。
  1：是的
  0：错误的（默认）
  数据类型：整数
• comments_notify：当有人发表评论时，请给我发电子邮件。
  1：是的（默认）
  0：不
  数据类型：整数
• default_comment_status：允许评论（可以用单个帖子覆盖）
  打开：允许评论（默认）
  关闭：禁止评论
  数据类型：细绳
• default_ping_status：允许来自其他博客的链接通知（Pingbacks和Trackbacks）。
  打开：允许来自其他博客的pingback和Trackbacks（默认）
  关闭：禁止其他博客中的ping背和反转
  数据类型：细绳
• default_pingback_flag：尝试通知文章中链接的任何博客（放慢帖子）。
  1：是的（默认）
  0：不
  数据类型：整数
• moderation_keys：当评论中包含其内容，名称，URL，电子邮件或IP中的任何一个单词时，它将以适度队列保存。一个单词或IP每行。它将匹配内部单词，因此“按”将与“ WordPress”匹配。
  默认值：null
  数据类型：字符串（可能是多行）
• moderation_notify：在发表评论以进行节制时给我发电子邮件。
  1：是的（默认）
  0：不
  数据类型：整数
• require_name_email：在出现评论之前，评论作者必须填写他/她的姓名和电子邮件。
  1：是的（默认）
  0：不
  数据类型：整数
• thread_comments：启用wp-native螺纹（嵌套）注释。
  1：是的
  0：不（默认）
  数据类型：整数
• thread_comments_depth：设置评论的线程级别的数量。
  1 穿越
  10：级别
  默认值：5
  数据类型：整数
• show_avatars：头像显示
  1： （默认）显示化身
  0：不要显示化身
  数据类型：整数
• avatar_rating：最大评分
  G： （默认）适合所有受众
  pg：可能是令人反感的，通常适用于观众13及以上
  r：针对17岁以上的成人观众
  X：比上面更成熟
  数据类型：细绳
• avatar_default：默认化身
  神秘： （默认）神秘人
  空白的：空白的
  gravatar_default：Gravatar徽标
  碎片：配置（生成）
  wavatar：wavatar（生成）
  monsterid：monsterid（生成）
  复古的：复古（生成）
  数据类型：细绳
• close_comments_for_old_posts：自动关闭对旧文章的评论
  1：是的
  0：不（默认）
  数据类型：整数
• close_comments_days_old：自动关闭对比X天大的文章的评论
  默认值：14
  数据类型：整数
• show_comments_cookies_opt_in：在注释表上显示Cookie选择的复选框，并启用评论cookie
  1：是的（截至4.9.8的默认值）
  0：不
  数据类型：整数
• page_comments：将评论分成页面
  1：是的（默认）
  0：不
  数据类型：整数
• comments_per_page：
  默认值：50
  数据类型：整数
• default_comments_page：
  默认：“最新”
  数据类型：细绳
• comment_order：
  ASC： （默认）
  desc：
  数据类型：细绳
• comment_whitelist：评论作者必须有先前批准的评论
  1：是的（默认）
  0：不
  数据类型：

一般的

• admin_email：管理员电子邮件
  默认值：“ [email protected]”
  数据类型：细绳
• blogdescription：博客标语
  默认值：‘__（“只是另一个WordPress博客”）’
  数据类型：细绳
• blogname：博客标题
  默认值：‘__（“我的博客”）”
  数据类型：细绳
• comment_registration：必须注册用户并登录以发表评论
  1：是的
  0：不（默认）
  数据类型：整数
• date_format：默认日期格式
  默认值：‘__（’f j，y’）’
  数据类型：细绳
• default_role：在博客中注册的用户的默认角色。
  订户（默认）
  行政人员
  编辑
  作者
  贡献者
  数据类型：细绳
• gmt_offset：博客中的时代应该因这个值而有所不同。
  -6：GMT -6（又名中央时间，美国）
  0：GMT（又名格林威治的平均时间）
  默认： 日期（’Z’） / 3600
  数据类型：整数
• home：博客地址（URL）
  默认： wp_guess_url（）
  数据类型：字符串（URI）
• siteurl：WordPress地址（URL）
  默认wp_guess_url()
  数据类型：字符串（URI）
• start_of_week：一周的开始。
  0：星期日
  1：周一（默认）
  2：周二
  3：周三
  4：周四
  5：星期五
  6：周六
  数据类型：整数
• time_format：默认时间格式
  默认值：‘__（’g：i a’）’
  数据类型：细绳
• timezone_string： 时区
  默认值：null
  数据类型：细绳
• users_can_register：任何人都可以注册
  1：是的
  0：不（默认）
  数据类型：整数

链接

• links_updated_date_format：
  默认__('F j, Y g:i a')
  数据类型：细绳
• links_recently_updated_prepend：
  默认为空
  数据类型： 细绳
• links_recently_updated_append
  默认空的
  数据类型：细绳
• links_recently_updated_time
  默认值：120
  数据类型：整数

媒体

• thumbnail_size_w：
  默认值：150
  数据类型：整数
• thumbnail_size_h：
  默认值：150
  数据类型：整数
• thumbnail_crop：作物缩略图至确切的尺寸（通常是缩略图成比例）
  1：是的（默认）
  0：不
  数据类型：整数
• medium_size_w：
  默认值：300
  数据类型：整数
• medium_size_h
  默认值：300
  数据类型：整数
• large_size_w
  默认值：1024
  数据类型：整数
• large_size_h
  默认值：1024
  数据类型：整数
• embed_autourls：尝试自动嵌入所有纯文本URL
  默认值：1
  数据类型：整数
• embed_size_w
  默认值：null
  数据类型：整数
• embed_size_h
  默认值：600
  数据类型：整数

各种各样的

• hack_file：使用遗产my-hacks.php文件支持
  1：是的
  0：不（默认）
  数据类型：整数
• html_type：博客页面的默认MIME类型（text/html，text/xml+html等）
  默认：“文本/html”
  数据类型：字符串（MIME类型）
• secret：在安装期间与盐的安装期间创建的秘密价值，等等。
  默认值：wp_generate_password（64）
  数据类型：字符串（MD5）
• upload_path：将上传存储在此文件夹中（相对于WordPress根）
  默认值：null
  数据类型：字符串（相对路径）
• upload_url_path：上传文件夹的URL路径（默认情况下为空白 – 在“所有设置”屏幕中可编辑。
  数据类型：字符串（URL路径）
• uploads_use_yearmonth_folders：将上传到一个月和年度文件夹中
  1：是的（默认）
  0：不（默认为安全模式）
  数据类型：整数
• use_linksupdate：跟踪链接的更新时间
  1：是的
  0：不（默认）
  数据类型：整数

永久链接

• permalink_structure：您博客永久链接的所需结构。一些例子：
  /%year%/%monthnum%/%day%/%postname%/：基于日期和名称
  /archives/%post_id%/：数字
  /%postname%/：基于名称的帖子
  默认值：null
  数据类型：细绳
• category_base：博客类别的默认类别基础永久链接。
  默认值：null
  数据类型：细绳
• tag_base：博客标签永久链接的默认标签基础。
  默认值：null
  数据类型：细绳

隐私

• blog_public：
  1：我希望我的博客能对所有人都能看到，包括搜索引擎（例如Google，Sphere，Technorati）和Archivers。（默认）
  0：我想阻止搜索引擎，但允许正常的访问者。
  数据类型：整数

阅读

• blog_charset：编码页面和提要。编码您写博客的字符（建议使用UTF-8）。
  默认：UTF-8
  数据类型：细绳
• gzipcompression：如果浏览器要求它们，WordPress应压缩文章（使用GZIP）。
  1：是的
  0：不（默认）
  数据类型：整数
• page_on_front：应显示在首页上的页面ID。需要show_on_front的价值 页。
  数据类型：整数
• page_for_posts：显示帖子的页面ID。很有用show_on_front的价值是 页。
  数据类型：整数
• posts_per_page：最多显示 X 博客页面上的许多帖子。
  默认值：10
  数据类型：整数
• posts_per_rss：最多显示 X RSS提要中的许多帖子。
  默认值：10
  数据类型：整数
• rss_language：用于RSS feed的语言（仅元数据目的）
  默认：en
  数据类型：字符串（ISO两个字母的语言代码）
• rss_use_excerpt：显示摘录，而不是RSS feed中帖子的全文
  1：是的
  0：不（默认）
  数据类型：整数
• show_on_front：在首页上显示什么
  帖子：您的最新帖子（默认）
  页：静态页面（请参阅第_on_front）
  数据类型：细绳

主题

• template：当前激活的主题的sl（路径如何访问它，ex。/wp-content/themes/my-theme（（my-theme将是此选项的价值）。
  默认：“默认”
  数据类型：细绳
• stylesheet：当前激活的样式表（style.css）（路径如何访问）的sl。/wp-content/themes/my-style（我的风格将是此选项的价值）
  默认：“默认”
  数据类型：细绳

写作

• default_category：默认情况下将发布帖子的类别的ID
  默认值：1
  数据类型：整数
• default_email_category：通过电子邮件编写时默认情况下帖子的类别ID
  默认值：1
  数据类型：整数
• default_link_category：默认情况下链接的类别的ID
  默认值：2
  数据类型：整数
• default_post_edit_rows：邮政信箱的尺寸（在线）
  默认值：10
  数据类型：整数
• mailserver_login：邮件服务器用户名，用于通过电子邮件发布到WordPress
  默认：“ [email protected]”
  数据类型：细绳
• mailserver_pass：邮件服务器密码以通过电子邮件发布到WordPress
  默认：“密码”
  数据类型：细绳
• mailserver_port：邮件服务器端口，用于通过电子邮件发布到WordPress
  默认值：110
  数据类型：整数
• mailserver_url：邮件服务器以通过电子邮件发布到WordPress
  默认值：“ mail.example.com”
  数据类型：细绳
• ping_sites：当您发布新帖子时，WordPress会自动通知以下网站更新服务。有关此的更多信息，请参阅 更新服务。单独的多个服务URL具有线路断路。需要blog_public有一个价值 1。
  默认： ‘ http://rpc.pingomatic.com/’
  数据类型：字符串（可能是多行）
• use_balanceTags：自动正确添加无效的XHTML
  1：是的
  0：不（默认）
  数据类型：整数
• use_smilies：转换表情符号:-)和:P显示时图形
  1：是的（默认）
  0：不
  数据类型：整数
• use_trackback：启用发送和接收反应
  1：是的
  0：不（默认）
• enable_app：启用原子出版协议
  1：是的
  0：不（默认）
  数据类型：整数
• enable_xmlrpc：启用WordPress，可移动类型，Metaweblog和Blogger XML-RPC发布协议
  1：是的
  0：不（默认）
  数据类型：整数

未分类

• active_plugins：返回一系列包含路径的字符串主要的插件的PHP文件。该路径相对于插件文件夹。数组中的路径的一个示例：/mainpage.php。
  默认值：array（）
  数据类型：大批
• advanced_edit：
  默认值：0
  数据类型：整数
• recently_edited：
  默认值：null
  数据类型：
• image_default_link_type：
  默认值：“文件”
  数据类型：“文件”，“无”
• image_default_size：
  默认值：null
  数据类型：“缩略图”，“中等”，“大”或“自定义尺寸”
• image_default_align：
  默认值：null
  数据类型：“左”，“右”，“中心”，“无”
• sidebars_widgets：返回侧边栏状态数组（活动窗口小部件的列表）。
  默认：
  数据类型：大批
• sticky_posts：
  默认值：array（）
  数据类型：
• widget_categories：
  默认值：array（）
  数据类型：
• widget_text：
  默认值：array（）
  数据类型：
• widget_rss：
  默认值：array（）
  数据类型：

所有设置屏幕

WordPress 3.0 删除设置>其他屏幕，无法达到某些选项（例如，upload_url_path）。您可以使用所有设置屏幕查看和更改上面列出的几乎所有选项。可以通过访问来访问/wp-admin/options.php