- 插件基础知识
- 插件安全
- 钩子
- 隐私
- 管理菜单
- 简码
- 设置
- 元数据
- 自定义帖子类型
- 分类法
- 用户
-
- JavaScript、Ajax 和 jQuery
- 任务调度
- 国际化
- 插件目录
- 开发人员工具
-
设置接口
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() |