插件

区块页面搭建

官方 builder 插件(免费)让「页面」可以用区块可视化搭建:首屏横幅、功能介绍、图文、数据亮点、Logo 墙、客户评价、价格方案、常见问题、行动号召、富文本、最新文章、产品列表、联系表单、视频、间距。区块使用 Nuxt UI 的页面组件渲染,自带响应式和深浅色模式。插件随框架一起发布(plugins/builder)。

node node_modules/nuxtcms/scripts/plugin.mjs add builder
pnpm build:cf && pnpm deploy

区块数据保存在插件自己的数据表({前缀}builder_pages、builder_versions),首次使用时自动创建,不需要对站点数据库做迁移。

使用

  1. 在 后台 → 页面 新建或打开一个页面并保存。
  2. 编辑页右侧「区块搭建」面板点击 开始搭建,进入可视化编辑器:
    • 左侧是区块列表:添加、上下移动;
    • 中间是实时预览(按桌面宽度缩放显示),点击区块即可选中;
    • 右侧(窄屏时在列表下方)是选中区块的属性:文字、图片(可从媒体库选)、按钮链接、条目列表等,还可以复制、隐藏、删除区块,设置背景色和锚点。
  3. 可以 从模板开始:产品落地页、关于我们、产品介绍页、联系页(按页面语言生成中文或英文示例内容)。
  4. 点击 保存 后页面立即更新(公共缓存自动清除);每次保存前的版本都会保留(最近 20 个),可在 历史版本 中恢复。
  5. 不想再用区块时点击 不用区块,恢复显示正文,页面重新显示原来的正文(区块保留为历史版本)。

使用区块的页面显示区块而不是正文;每种语言的页面是独立的,各自搭建。草稿页面不会公开。

区块说明

  • 价格方案:可以手动填写方案,或选择「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 结构化数据、缓存更新、历史版本恢复、恢复正文、权限。