stevegrunwell/wp-admin-tabbed-settings-pages

Trac #51086 的 polyfill,将标签页设置页面引入 WP-Admin。

v0.2.0 2020-08-27 17:20 UTC

This package is auto-updated.

Last update: 2024-08-28 01:50:21 UTC


README

Build Status WordPress Trac #51086

本包包含对 WordPress 核心Trac工单#51086 的 polyfill,其中提出了 WP-Admin 中标签页设置页面的标准。

该提案围绕一个新功能展开,即 设置 API 的一部分:do_tabbed_settings_sections(),它与 do_settings_sections() 相同,但每个部分都在单独的标签中渲染。

A side-by-side comparison of the classic, non-tabbed settings UI and the tabbed version

作为额外的功能,包含的脚本尊重 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 标签页设置页面演示插件