常规信息
Blockstudio Registry 是一款 CLI 工具,用于分发和安装托管在注册表中的 WordPress 区块。
它的工作方式类似于 shadcn/ui,但面向 WordPress 区块。无需安装 npm 软件包。运行命令后,区块源代码会复制到你的项目中,完全由你掌控。
工作原理
- 区块作者在 URL 发布一个
registry.json,列出可用区块。 - 你在主题或插件中添加一个
blocks.json,指向要使用的注册表。 - 运行
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
完整设置方法请参阅 入门指南。