WordPress 2.7中添加的设置API允许包含设置表单的管理页面被半自动管理。 它允许您定义设置页面,这些页面中的部分和部分中的字段。
新设置页面可以与其中的部分和字段一起注册。 现有设置页面也可以通过在其中注册新的设置部分或字段来添加。
组织领域的注册和验证仍然需要开发人员的一些努力,但是避免了基础选项管理的大量复杂调试。
警报:使用设置API时,POST到wp-admin/options.php的表单提供相当严格的功能检查。 用户将需要manage_options功能(并且在多个站点必须是超级管理员)才能提交表单。
为什么要使用设置API?
开发人员可以忽略这个API,而不用编写自己的设置页面。 这就提出了这个问题,这个API带来了什么好处? 以下是一些快速的破坏一些好处。
视觉一致性
使用API生成界面元素可以保证您的设置页面看起来像其他的管理内容。 你有没有看过一个看起来像是5岁的插件设计页面? 你可以打赌开发者没有使用API。 所以,一个强有力的论据是你的界面看起来就像它所属的,并且由于有天赋的WordPress设计师团队,它会看起来很棒!
鲁棒性(未来证明!)
由于API是WordPress Core的一部分,任何更新都将自动考虑您的插件的设置页面。 如果您离开预订并制作自己的界面,WordPress核心更新更有可能会破坏您的自定义。 还有更广泛的受众测试和维护API代码,所以它往往会更加稳定。
减少工作
当然最直接的好处是WordPress API为您提供了大量的工作。 以下是“设置”API的一些示例,除了应用一个非常棒的集成设计。
- 处理表单提交 - 让WordPress处理检索和存储您的
$ _POST
提交。 - 包括安全措施 - 您可以免费获得额外的安全措施,例如过滤器等。
- 消毒数据 - 您可以访问与WordPress其余部分相同的方法,以确保字符串安全使用。
功能参考
- Setting Register/Unregister Add Field/Section
- register_setting()
- unregister_setting() add_settings_section()
- add_settings_field()
- Options Form Rendering Errors
- settings_fields()
- do_settings_sections()
- do_settings_fields() add_settings_error()
- get_settings_errors()
- settings_errors()