If you encounter any issues, please contact us.
下载版本
- GutenBricks v1.1.26
GutenBricks 介绍
产品简介
GutenBricks 是什么？
GutenBricks 是一款把 Bricks 中的模板与组件能力“带入” Gutenberg 的插件：在 Bricks 里搭建好结构与样式后，直接注册为 Gutenberg 区块，供内容编辑者复用。官方强调其适用于代理商与自由职业者团队的交付与协作场景。
关键能力：
- Variants（变体）： 在一个区块内准备多版式（如左右图文、卡片样式等），编辑时以单选/缩略图/下拉的方式切换，无需复制一堆相似区块。支持为变体绑定同名字段 Value Binding，在切换样式时复用同一份内容。
- InnerBlocks： 在区块中开辟可嵌入其它区块的区域，并可限制允许插入的子块类型，用于可控的“可编辑区”。
- 动态数据： 与 ACF/Meta Box 集成，将字段值渲染到区块中；同时提供内置的 GB:Meta 动态数据源。
- 客户编辑体验： 支持自定义区块预览、内嵌文档说明及“动态数据不可在画布直接编辑”的提示弹窗文案，让非技术编辑者在 Gutenberg 中按规则修改。
- 模板包（Template Bundles）： 按“包”管理哪些 Bricks 模板注册为区块/模式（Pattern），并控制对应文章类型的可见性。
- 第三方生态： 官方提供 ACSS 集成说明，并表示与常见 Bricks 加强插件（如 Advanced Themer、NextBricks、Bricks Extras 等）优先兼容。
依赖与兼容：
GutenBricks 需要已安装并运行的 Bricks Builder；官网亦称会与 Bricks 2.0 保持兼容。Bricks 官方路线图也提到“将于 2025 年探索 Bricks 组件进入 Gutenberg”的方向，GutenBricks 旨在在原生能力之外提供更强的变体、模板与编辑体验增值。
主要功能亮点
- 一键把 Bricks 模板变成 Gutenberg 区块（无代码、所见即所得的搭建体验）。
- 变体（Variants）：同一区块多布局切换；Value Binding 实现跨变体内容共用。
- InnerBlocks 可控嵌套：在指定区域内允许/限制子块。
- 字段驱动的动态数据：原生集成 ACF/Meta Box，并提供 GB:Meta。
- 客户友好：区块预览、内嵌说明、可自定义提示弹窗，降低误操作。
- 模板包管理（Template Bundles）：按包启用为区块或 Pattern，并按文章类型控制可见。
- 生态兼容：提供 ACSS 集成指南；与常见 Bricks 加强插件优先适配。
- 多语言实践：提供 WPML/Polylang 使用要点与设置建议。
适用人群与使用场景
- 代理商/自由职业者团队：用 Bricks 快速产出“可复用的品牌区块库”，交付给客户在 Gutenberg 中自主组合，降低维护成本。
- 内容密集型站点：希望在不牺牲设计一致性的前提下，让编辑能在区块里替换文案/图片并切换版式（Variants）。
- 需要字段驱动内容的业务：如案例、团队、课程、产品卡片等，用 ACF/Meta Box 统一管理字段，区块自动渲染。
- 多语言/多站点维护：结合 WPML/Polylang 的内容保存策略，提高跨语种编辑稳定性。
同类主题对比
| 核心功能项 | GutenBricks | ACF Blocks（Pro） | Genesis Custom Blocks | Lazy Blocks |
|---|---|---|---|---|
| 用 Bricks 无代码可视化搭建区块 | ✅ | ❌ | ❌ | ❌ |
| Variants（同一区块多布局切换） | ✅ | ❌ | ❌ | ❌ |
| Value Binding（跨变体共享内容） | ✅ | ❌ | ❌ | ❌ |
| Template Bundles 模板包管理 | ✅ | ❌ | ❌ | ❌ |
| InnerBlocks（可嵌套子块） | ✅ | ✅ | ✅ | ✅ |
| ACF/Meta Box 动态数据 | ✅ | ✅（ACF） | ❌（自有字段） | ❌（自有字段） |
| ACSS/Bricks 生态集成文档 | ✅ | ❌ | ❌ | ❌ |
| 是否依赖 Bricks Builder | ✅ | ❌ | ❌ | ❌ |
- ACF Blocks（Pro）：基于 PHP 的区块框架，无需深入 React/JS；支持 InnerBlocks、Variations、Styles，适合开发者定制。
- Genesis Custom Blocks：提供后台界面 + 简单模板系统，用 PHP/HTML/CSS 构建自定义区块，含 Inner Blocks Field。
- Lazy Blocks：在 WP 后台用可视化方式定义区块与控制项，支持 InnerBlocks 组件。
补充说明（差异化）：
GutenBricks 的优势在于“直接复用 Bricks 的可视化搭建与组件体系”，并提供 Variants/Value Binding/Template Bundles 等面向编辑与复用的高级工作流；而 ACF/Genesis/Lazy Blocks 更偏向“字段 + 模板”型开发。
用户反馈亮点
- 交付效率提升：用 Bricks 打造的组件能在 Gutenberg 中复用与切换布局，加快上线并保持设计一致。
- 客户编辑更放心：编辑者在区块中直接替换内容，不易“改乱版式”，代理与甲方协作更顺畅。
- 支持积极：开发者与团队对响应速度与迭代态度评价正面。
与其他插件/主题搭配建议
- 字段系统：优先配合 ACF/Meta Box 建立统一字段模型与校验，再由区块渲染输出。
- 样式体系：建议搭配 ACSS；若已有 Bricks 生态（Advanced Themer、NextBricks、Bricks Extras 等），按项目逐步纳入。
- 多语言：采用 WPML/Polylang 时，按文档启用“将区块内容保存到文章中”等选项，确保字符串可译与模板统一加载。
使用与选型提示（重要）
- 安装依赖：GutenBricks 需要 Bricks Builder 正常运行；停用 Bricks/GutenBricks 后已有内容仍在，但布局样式不会加载。
- 关于 Bricks 2.0：Bricks 官方在 2024-09-06 的路线文章中提到 2025 年将探索 Gutenberg 相关方向；GutenBricks 表示将与 2.0 兼容，并在原生能力外提供增值（如变体与模板工作流）。
常见问题（FAQ）
GutenBricks 是什么？解决什么问题？
在 Bricks 中可视化搭建结构与样式，并将模板注册为 Gutenberg 区块/模式，把 Bricks 的组件化能力带入区块编辑器，提升交付与编辑效率。
是否必须安装 Bricks？是否支持 Bricks 2.0？
必须。GutenBricks 需要已安装并运行的 Bricks Builder；官方说明会与 Bricks 2.0 保持兼容。
如何创建第一个区块？
在 Bricks 新建模板，类型设为 “GutenBricks – Block”；（可选）加入某个 Template Bundle；回到 Gutenberg，即可在启用的文章类型中使用。
在编辑器里找不到刚创建的区块怎么办？
确认模板类型为 “GutenBricks – Block”；若分配到某个 Bundle，请启用该 Bundle，并确认已对目标文章类型开放；仍有问题再按“常见排错步骤”检查。
同一个区块能切换不同布局/样式吗？
可以。通过 Variants（变体）为同一区块配置多种布局，编辑时以文本单选、图片单选或下拉的方式切换。
切换变体后，已填内容会丢失吗？
启用 Value Binding 后，不同变体间可共享同名字段的内容，避免重复录入。
区块内可以嵌套其他块吗？能限制可插入的子块？
可以使用 InnerBlock 在指定区域嵌入其他区块，并限制允许的子块类型、设置默认子块等（注意：Gutenberg 规则是每个区块仅能包含一个 InnerBlocks）。
如何接入动态数据（如 ACF / Meta Box）？
支持 ACF / Meta Box 以及内置 GB:Meta。请在 ACF 中设置正确的 Location 规则，使字段在编辑侧栏可见；也可用代码块进行灵活渲染。
多语言站点如何设置（WPML / Polylang）？
两种方式：其一，用字符串翻译；其二，为每种语言分别创建页面与区块。若用字符串翻译，请启用 “Save block content in post”；如模板仅保留一种语言，还可启用 “Load blocks for all languages”。
停用 GutenBricks 或 Bricks 后页面会不会白屏/内容丢失？
启用 “Save block content in post” 后，区块内容会存为回退内容；即使临时停用相关组件，页面仍能显示基础内容（复杂样式/交互可能受影响）。
为什么编辑器里的样式与前台略有差异？如何处理？
编辑器有额外的 wrapper。可启用 Block Wrapper Dynamic Class、为编辑器注入必要的 CSS，或按文档给出的片段优化，使编辑体验更接近前台。
能否让客户在 Gutenberg 里切换整页模板？
可以。创建 “GutenBricks – Page Template”，并在其中使用 Post Content 元素，即可在 Gutenberg 侧选择不同页面模板渲染。
前台不渲染/出现空白时，有哪些排错建议？
在管理工具栏启用 “Render With WordPress”；检查样式是否写在 Bricks 外部代码片段（编辑器无法自动注入）；核对 ACF/Meta Box 的 Location 规则设置是否正确。
与 ACSS、Bricks Extras 等第三方生态是否兼容？
官方提供 ACSS 集成指引及常见样式兼容说明，并在“第三方集成”中列出与 ACSS、Bricks Extras 等生态的兼容状态与注意事项。
