插件
区块页面搭建
官方 builder 插件(免费)让「页面」可以用区块可视化搭建:首屏横幅、功能介绍、图文、数据亮点、Logo 墙、客户评价、价格方案、常见问题、行动号召、富文本、最新文章、产品列表、联系表单、视频、间距。区块使用 Nuxt UI 的页面组件渲染,自带响应式和深浅色模式。插件随框架一起发布(plugins/builder)。
node node_modules/nuxtcms/scripts/plugin.mjs add builder
pnpm build:cf && pnpm deploy
区块数据保存在插件自己的数据表({前缀}builder_pages、builder_versions),首次使用时自动创建,不需要对站点数据库做迁移。
使用
- 在 后台 → 页面 新建或打开一个页面并保存。
- 编辑页右侧「区块搭建」面板点击 开始搭建,进入可视化编辑器:
- 左侧是区块列表:添加、上下移动;
- 中间是实时预览(按桌面宽度缩放显示),点击区块即可选中;
- 右侧(窄屏时在列表下方)是选中区块的属性:文字、图片(可从媒体库选)、按钮链接、条目列表等,还可以复制、隐藏、删除区块,设置背景色和锚点。
- 可以 从模板开始:产品落地页、关于我们、产品介绍页、联系页(按页面语言生成中文或英文示例内容)。
- 点击 保存 后页面立即更新(公共缓存自动清除);每次保存前的版本都会保留(最近 20 个),可在 历史版本 中恢复。
- 不想再用区块时点击 不用区块,恢复显示正文,页面重新显示原来的正文(区块保留为历史版本)。
使用区块的页面显示区块而不是正文;每种语言的页面是独立的,各自搭建。草稿页面不会公开。
区块说明
- 价格方案:可以手动填写方案,或选择「SaaS 套件的套餐」直接显示 SaaS 套件 的价格表(含购买按钮)。
- 常见问题:同时输出 FAQPage 结构化数据,有助于搜索引擎和 AI 搜索展示。
- 最新文章 / 产品列表:自动显示最新发布的内容。
- 联系表单:与联系页相同的询盘接口、验证码和通知。
- 视频:支持 YouTube、B 站链接或 mp4 文件。
- 插件组件:显示其他插件提供的组件,例如 营销工具 的候补名单、用户反馈与投票、更新日志。插件在
app.config的nuxtcms.builderWidgets中登记组件,未登记的组件不会显示。 - 按钮链接可以写站内路径(如
/contact,自动加语言前缀)、#锚点或完整网址;javascript:等不安全的链接在保存时会被清除。
在站点首页或其他页面使用
站点自己的页面(如首页)可以放入区块页面:
<!-- app/pages/index.vue -->
<template>
<BuilderPage slug="home">
<!-- 没有名为 home 的区块页面时显示原来的首页 -->
<MyHome />
</BuilderPage>
</template>
在后台新建别名为 home 的页面并用区块搭建,首页就会显示它。
测试
pnpm smoke:builder --base http://localhost:3192 针对开发服务器跑完整流程:保存时的清理(未知区块、不安全链接、超大内容)、前台显示与隐藏区块、FAQ 结构化数据、缓存更新、历史版本恢复、恢复正文、权限。