跳转到正文

管理

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 表格中显示实际记录。

该界面不会将所有记录序列化到初始管理载荷中,而是:

  1. 预先本地化架构元数据
  2. 打开数据库选项卡时按需获取记录
  3. 表格通过 REST API 分页

这样,即使项目的数据集较大,管理界面仍然易于使用。

范围

当前范围有意保持精简:

  • 检查 Blockstudio 注册了哪些内容
  • 从已配置的注册表导入区块
  • 浏览数据库记录

它不会取代现有的设置工作流程,也不会直接编辑区块或页面定义。