跳转到正文

常规信息

Blockstudio Registry 是一款 CLI 工具,用于分发和安装托管在注册表中的 WordPress 区块。

它的工作方式类似于 shadcn/ui,但面向 WordPress 区块。无需安装 npm 软件包。运行命令后,区块源代码会复制到你的项目中,完全由你掌控。

工作原理

  1. 区块作者在 URL 发布一个 registry.json,列出可用区块。
  2. 你在主题或插件中添加一个 blocks.json,指向要使用的注册表。
  3. 运行 npx blockstudio add ui/tabs,区块文件夹就会放入你的项目中。

就是这样。CLI 会下载文件、解析依赖项并写入磁盘,不会转换任何内容。WordPress 区块文件夹在任何地方都相同。

支持的内容

注册表不限定区块类型,只负责复制文件夹。任何位于目录中的区块都适用:

  • Blockstudio 区块:block.json + PHP/Twig/Blade 模板 + 可选资源
  • @wordpress/create-block 区块:完整的 JS 构建输出,包含 edit.js、save.js 等
  • 纯 PHP 区块:通过 register_block_type() 注册的任意区块
  • 静态区块:只有 block.json、没有服务器端渲染的区块

CLI 不关心文件夹中包含什么。它会读取注册表中的文件清单,并且只下载清单中列出的文件。

WordPress 管理界面

如果当前主题配置了注册表 blocks.json,这些注册表也会显示在 wp-admin 中的 工具 > Blockstudio > Registry 里。

该管理界面可让你查看可用区块并导入它们,无需修改 CLI。配置格式保持不变,blocks.json 仍是唯一可信来源。

快速开始

命令行
npx blockstudio init
npx blockstudio add ui/tabs

完整设置方法请参阅 入门指南。