本篇定位:Bricks 2.x 用户从零建站的完整操作手册。原文素材整理自 Bricks 社区公开教程,本站按 2026 年 8 月 Bricks 2.4 版本逐项核验、补全了截图缺失的步骤,并标注了已过时的设置项。如果你用的是 2.0 以下旧版,请先升级再按本文操作。
这篇解决什么问题
Bricks 官方文档和视频教程都存在,但新手真正卡住的是三件事:
- 不知道哪些设置该动、哪些千万别动——默认值里藏着坑(比如自定义图片尺寸,开了就多生成 5 个缩略图)
- 模板体系搞不清——Header/Footer 怎么全站生效?归档页怎么按分类输出?条件(Conditions)到底怎么配?
- 教程里的截图和步骤对不上自己版本——2024 年的教程在 2.x 界面里已经变了
本篇把这三件事一次讲完。读完你会得到一个可以上线的 Bricks 站点骨架,之后要加什么功能都是在这个骨架上添砖。
安装与激活(含子主题决策)
第一步:装主题,不是装插件
Bricks 是一个主题(Theme),不是插件。新手最常见的第一个错误就是在“插件”里找它。
操作路径:外观 → 主题 → 添加新主题 → 上传,上传 bricks.zip 并启用。然后同样方式上传并激活 Bricks 子主题(Child Theme)。
子主题要不要装? 这是被问烂的问题,结论很明确:
| 场景 | 用子主题? |
|---|---|
| 你只打算用 Bricks 界面搭建,不写代码 | 不需要 |
| 你要加自定义 PHP / CSS / JS(代码元素、hooks) | 必须装,代码写子主题里,父主题升级不丢 |
| 给客户做站,客户可能自己改代码 | 必须装 |
本站结论:凡是给客户做的站,一律上子主题。自己折腾的站,先裸奔也行,等要写代码了再补,不迟。
第二步:激活授权
Bricks → License,粘贴授权密钥。没有这一步,模板库和部分功能不可用——很多新手以为是自己装坏了,其实是没激活。
Bricks 基础设置(逐项讲透)
进入 Bricks → Settings,按下面顺序过一遍。每项都标注了「为什么」——不理解的就保持默认,理解后按需改。
1. General(常规)
| 设置 | 建议 | 为什么 |
|---|---|---|
| Post types | 保持 Pages 默认 | Posts/Products 这类内容用 WP 编辑器维护更轻,不需要 Bricks 视觉编辑 |
| Allow SVG upload | 不开(推荐) | SVG 有 XSS 风险。真要放 SVG,先用 SVGOMG 清理后粘贴到代码元素,而不是开放上传 |
| SEO meta tags | 用了 SEO 插件(SEOPress/Rank Math/Yoast)就关闭 Bricks 自带的 | 双份 meta 会冲突,Google 可能忽略你的 title/description 自定义 |
| Custom image sizes | 不要开 | 每个图片多生成 5 个尺寸版本,纯属浪费存储和带宽 |
| Query Bricks data in search results | 开 | 否则 WP 搜索搜不到 Bricks 建的页面内容 |
| Query filters | 2.x 已稳定可用 | 原文(1.9.7.1 时代)标注为“实验性不推荐”,该结论已过时——2.x 里 Query Filters 已可用于生产站,但复杂场景仍建议 WP Grid Builder 这类专用插件 |
2. Builder access(构建器访问权限)
给客户做站时,把客户角色设为 Editor 或 Author,并开启该角色的 Edit Content 权限。别给 Administrator——客户误删模板你都不知道。
3. Builder(构建器)
| 设置 | 建议 | 为什么 |
|---|---|---|
| Autosave | 关 | 开着的话底部老弹“恢复自动保存?“的提示,烦 |
| Toolbar logo link | Dashboard + 新标签页打开 | 点 Logo 回后台,不覆盖当前编辑现场 |
| Canvas → Disable element spacing | 开 | 不关的话,误触会给元素加出奇怪的 padding/margin,后期排查累死 |
| Structure panel | 四项全开 | 调试结构时的救命功能 |
| Dynamic data | 五项全开 | 动态数据是 Bricks 的灵魂,全开才能用 |
4. Performance(性能)
这是上线前必须过的一关,直接决定 PageSpeed 分数:
| 设置 | 建议 | 为什么 |
|---|---|---|
| Disable emojis | 开 | WP 自带 emoji 脚本 20KB+,几乎没人用 |
| Disable Google Fonts | 开 | 谷歌字体国内访问慢且被墙。要自托管字体,走 Bricks → Custom Fonts |
| Disable jQuery migrate | 开 | 兼容老插件的遗留脚本,现代站点用不上 |
| Disable class chaining | 开 | 减少无用 CSS 类输出 |
| CSS loading method | Inline(默认) | 内联比外链少一次请求 |
验证方法:改完去 PageSpeed Insights 测一次,移动端应该到 80+;如果连 70 都不到,检查是不是有插件在捣乱(常见元凶:Elementor 残留、未清理的页面构建器历史、图片没压缩)。
5. API Keys(API 密钥)
至少填一个 Unsplash 密钥——Bricks 内置 Unsplash 集成,编辑器里能直接搜图插入,做演示站和初稿时效率翻倍。申请免费。
6. Custom Code(自定义代码)
开 Enable code execution for admins。不开的话,代码元素里的 PHP 不执行,新手排查半天以为代码写错了。
7. WooCommerce(如果有)
| 设置 | 建议 |
|---|---|
| Product Badge “Sale” | Text(文本模式,样式可控) |
| Product Badge “New” | 30(天) |
WordPress 侧的准备
- 建两个页面:Home、Blog(只建页面,内容留空,模板会负责渲染)
设置 → 阅读:首页选 Home,文章页选 Blog- 建好站的其他页面(关于、联系等)
外观 → 菜单:创建主菜单,把页面加进去——Bricks 的 Nav Menu 元素引用的是 WP 菜单,不是 Bricks 里配的
模板体系搭建:页眉/页脚/页面/归档
Bricks 模板体系的核心认知:模板(Templates)决定“哪些内容长什么样”,条件是决定“哪些页面用哪个模板”的开关。
页眉(Header)
Bricks → Templates → 新建,类型选 Header,命名 “Header”。
关键认知:Header/Footer 类型的模板自动全站生效,不需要配条件——这是和 Oxygen 最大的不同(Oxygen 没有全站兜底模板概念)。
搭建步骤:
- 先建主题样式:设置(齿轮)→ THEME STYLES → + → 命名
Global- COLORS:你的品牌色板
- ELEMENT – SECTION → Padding 上下 75px、左右 20px(这是区块默认呼吸感)
- 添加 Section → 自动带 Container
- Container 里加 Logo + Nav Menu 两个元素
- 选中 Container 设置对齐:Direction=Horizontal、Main axis=Space between、Cross axis=Center——Logo 和菜单就分居两端了
- 保存(Ctrl/Cmd + S)——新手最容易忘的一步,改了半天没存
- 把 Section 的上下 padding 从 75 改到 30——页眉不需要那么大的呼吸感
页脚(Footer)
同路径建类型 Footer 的模板,命名 “Footer”。也是自动全站生效。
编辑器里快捷操作:按
Ctrl/Cmd + Shift + L不用退回后台就能新建/切换模板。
页面(Page)
- 建类型 Single 的模板,命名 “Page”,条件设为应用到所有页面
- 在 Settings → TEMPLATE SETTINGS → POPULATE CONTENT 选一个有内容的现有页面预览——没这一步你编辑时看不到真实内容,等于盲画
- 页面模板的骨架:一个 Hero 区(标题 + 描述)+ 正文区(Container 内放一个区块元素承载 WP 编辑器内容)
为什么页面模板重要:它决定了站内所有普通页面的统一外观。改一次,全站生效。
博客文章列表页(Blog Index)
- 用 Bricks 编辑之前建的 “Blog” 页面
- Section 的 Container 里加 Posts 元素
- 选中 Posts:NAVIGATION → Show Posts Navigation → 开,就有分页了
- 想要更精细的分页控制,用独立的 Pagination 元素替代
分类归档(Category Archive)
场景:example.com/category/nature 和 example.com/category/business 都用同一个模板渲染。
- 新建类型 Archive 的模板,命名 “Category Archive”
- 设置(齿轮)→ TEMPLATE SETTINGS → CONDITIONS → 添加条件,选 Post type = Post(或你想要的类型)
- Container 里加 Block 元素,启用查询循环(Query Loop)
- 查询参数保持默认,不要动——归档模板的查询会自动跟着当前分类走,动了反而错
- 循环里加 Post Title 元素:标签 H3、开 Link to post
自定义分类法归档(Taxonomy Term Archive)
场景:CPT=Project,分类法=Project Type(Business/Nature),URL 形如 example.com/project-type/business/。
- 新建类型 Archive 的模板
- CONDITIONS 条件:选对应的自定义分类法
- 加带 H1 的 Section,文本用动态标签
{term_name}——自动显示当前分类项名 - Container 里加 Posts 元素,查询保持默认
为什么用 {term_name}:一个模板服务 N 个分类项,标题必须动态。硬写“Business”就是写死,换个分类项就露馅。
作者归档(Author Archive)
- 新建类型 Archive 的模板
- CONDITIONS 选作者归档(Author)
- Section 里加 Heading(H1,文本
Author: {author_name})+ Posts 元素 - Posts 查询不要改——和上面同理,自动跟当前作者走
上线前检查清单
按这个清单过一遍,能挡掉 80% 的上线翻车:
- License 已激活,编辑器右上角无红字提示
- Performance 四项(emoji/字体/jQuery/class chaining)已关
- SEO 插件已接管 meta(Bricks 自带 meta 已关)
- 子主题已装(要写代码的话)
- Header/Footer 模板已存,刷新前台能看到
- 归档模板配了条件,访问
/category/xxx实测正常 - 移动端预览过一遍(汉堡菜单能开能关)
- PageSpeed 移动端 ≥ 80
- 表单/询盘链路实测提交成功(不是只测“能打开”)
常见坑与规避
| 坑 | 症状 | 规避 |
|---|---|---|
| 当插件装 Bricks | 插件列表找不到 | 记住:它是主题,走 外观 → 主题 |
| 忘了激活 License | 模板库打不开 | 先 Bricks → License 激活 |
| 开 Custom image sizes | 磁盘暴涨 | 保持默认,别手贱 |
| 归档模板改了查询 | 分类页显示全部文章 | 归档模板查询保持默认,让系统自动带 |
| 没 POPULATE CONTENT 就编辑模板 | 编辑画面空白/假数据 | 先选真实页面预览再动手 |
| Header 存了但前台没变化 | 页面没变 | 检查是否点了保存(Ctrl+S),以及有没有被页面级条件覆盖 |
| 用了 SEO 插件但 Bricks meta 没关 | Search Console 里 title 混乱 | 二选一,别同时开 |
延伸阅读:本站的《Bricks 查询循环入门》《Bricks 条件输出教程》《Bricks 性能优化》三篇与本篇配套,覆盖建站后的进阶场景。