WordPress中文开发手册

WordPress插件开发 — 设置API

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()
Tags