管理
Blockstudio 在 工具 > Blockstudio 下提供了一个管理界面。它是一个项目级检查界面,用于查看 Blockstudio 从文件系统注册了哪些内容,还可浏览注册表和数据库记录。
这里有意不做成设置页面。目标是提供可见性:当前有哪些区块、扩展、字段、页面、架构、注册表和数据库记录。
访问
同时满足以下两个条件时,管理页面才可用:
- 当前用户具有
manage_options权限 - 已通过
blockstudio/admin/enabled启用该页面
可通过以下方式完全禁用:
PHP
add_filter('blockstudio/admin/enabled', '__return_false');
视图
概览
概览是 Blockstudio 注册项的只读清单,其中包括以下专用选项卡:
- 区块:已注册的区块类型、渲染模式、API 版本、属性数量
- 扩展:目标、优先级、渲染模式、属性数量
- 字段:可复用的
field.json定义 - 页面:基于文件的页面,包含文章类型、状态、引擎和同步状态
- 架构:已注册的
db.php架构,包含存储和字段数量
这些表格采用原生 WordPress DataViews,使界面与 wp-admin 保持一致,而不另行设计一套界面。
注册表
如果项目配置了带注册表的 blocks.json,管理页面会显示 注册表 视图。它会从这些注册表获取可用区块,并允许你将其直接导入已配置的区块目录。
blocks.json 配置同时为 CLI 和管理界面中的浏览器提供支持:
JSON
{
"$schema": "https://blockstudio.dev/schema/blocks.json",
"directory": "blockstudio",
"registries": {
"ui": "https://blocks.example.com/registry.json"
}
}
通过带有 headers 和 ${ENV_VAR} 插值的对象格式支持经过身份验证的注册表。完整配置格式请参阅注册表文档。
数据库
如果项目注册了任何 db.php 架构,管理页面会显示 数据库 视图。每个架构都有自己的选项卡,并在 DataViews 表格中显示实际记录。
该界面不会将所有记录序列化到初始管理载荷中,而是:
- 预先本地化架构元数据
- 打开数据库选项卡时按需获取记录
- 表格通过 REST API 分页
这样,即使项目的数据集较大,管理界面仍然易于使用。
范围
当前范围有意保持精简:
- 检查 Blockstudio 注册了哪些内容
- 从已配置的注册表导入区块
- 浏览数据库记录
它不会取代现有的设置工作流程,也不会直接编辑区块或页面定义。