设置接口
WordPress 2.7 中添加的设置 API 允许半自动管理包含设置表单的管理页面。它允许您定义设置页面、这些页面中的部分以及这些部分中的字段。
新的设置页面可以连同其中的部分和字段一起注册。还可以通过在其中注册新的设置部分或字段来添加现有设置页面。
组织字段的注册和验证仍然需要开发人员付出一些努力,但避免了底层选项管理的大量复杂调试。
警报:使用 Settings API 时,表单 POST
wp-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() |
无评论