stevegrunwell / wp-admin-tabbed-settings-pages
Trac #51086 的 polyfill,将标签页设置页面引入 WP-Admin。
Requires (Dev)
This package is auto-updated.
Last update: 2024-08-28 01:50:21 UTC
README
本包包含对 WordPress 核心Trac工单#51086 的 polyfill,其中提出了 WP-Admin 中标签页设置页面的标准。
该提案围绕一个新功能展开,即 设置 API 的一部分:do_tabbed_settings_sections()
,它与 do_settings_sections()
相同,但每个部分都在单独的标签中渲染。
作为额外的功能,包含的脚本尊重 URL 哈希,使得标签页也可以使用浏览器历史记录,并可以直接链接到特定的标签!
最好的是,您无需等待 WordPress 核心接受更改即可开始使用它,因为本包包含相同的代码(并由提交 Trac 工单的人维护)。此版本的代码甚至设计为在将来检测到 WordPress 核心中存在该函数时自动退让!
安装
要将此 polyfill 作为独立 WordPress 插件运行,请下载最新的 zip 文件,然后像安装任何其他 WordPress 插件一样进行安装。
如果您愿意将此作为其他插件的依赖项捆绑在一起,您可以通过 Composer 加载它
$ composer require stevegrunwell/wp-admin-tabbed-settings-pages
值得注意的是,composer.json
不包括插件引导文件在自动加载器中,因此在 WordPress 加载后(例如,当您的插件正在加载时)需要显式要求此文件。
// Please adjust this path as appropriate. require_once __DIR__ . '/vendor/stevegrunwell/wp-admin-tabbed-settings-pages/wp-admin-tabbed-settings-pages.php';
使用方法
只要您在使用 WordPress 设置 API,必要的更改仅是将您的 do_settings_sections($page)
调用替换为 do_tabbed_settings_sections($page)
。
有关示例,请参阅Trac 工单中附加的 WP-Admin 标签页设置页面演示插件。