设置接口

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

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

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

警报:
使用设置 API 时,POST 表单wp-admin/options.php提供了相当严格的功能检查。用户将需要manage_options提交表单的能力(在 Multisite 中必须是超级管理员)。

为什么使用设置 API?

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

视觉一致性

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

鲁棒性(面向未来!)

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

减少工作!

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

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

功能参考

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