跳转到主要内容

设置接口

WordPress 2.7 中添加的设置 API 允许半自动管理包含设置表单的管理页面。它允许您定义设置页面、这些页面中的部分以及这些部分中的字段。

新的设置页面可以连同其中的部分和字段一起注册。还可以通过在其中注册新的设置部分或字段来添加现有设置页面。

组织字段的注册和验证仍然需要开发人员付出一些努力,但避免了底层选项管理的大量复杂调试。

警报:使用 Settings API 时,表单 POSTwp-admin/options.php提供相当严格的功能检查。用户需要具备manage_options提交表单的能力(在多站点中必须是超级管理员)。

为什么要使用设置 API?

开发人员可以忽略此 API,并在没有它的情况下编写自己的设置页面。这就引出了一个问题,这个 API 给桌面带来了什么好处?以下是一些好处的简要概述。

视觉一致性

使用 API 生成界面元素可确保您的设置页面看起来与其他管理内容相似。您的界面将遵循相同的样式指南,并且看起来像它所属的,并且感谢才华横溢的 WordPress 设计师团队,它看起来会很棒!

稳健性(面向未来!)

由于 API 是 WordPress 核心的一部分,任何更新都会自动考虑您插件的设置页面。如果您在不使用设置 API 的情况下创建自己的界面,WordPress 核心更新更有可能破坏您的自定义设置。还有更广泛的受众测试和维护该 API 代码,因此它往往会更加稳定。

减少工作量!

当然,最直接的好处是 WordPress API 在幕后为您做了很多工作。除了应用美观的集成设计之外,这里还有一些设置 API 的功能示例。

  • 处理表单提交 –让 WordPress 处理检索和存储您的 $_POST 提交。
  • 包括安全措施 –您免费获得额外的安全措施,例如随机数等。
  • 清理数据 –您可以使用 WordPress 其余部分使用的相同方法来确保字符串可以安全使用。

功能参考

设置注册/取消注册 添加字段/部分
注册设置()
取消注册设置()
add_settings_section()
add_settings_field()
选项表单渲染 错误
设置字段()
do_settings_sections()
do_settings_fields()
add_settings_error()
get_settings_errors()
settings_errors()