Gutenberg 块模式生成器

要解决的问题

WordPress 区块编辑器自带的区块模式（Block Pattern）虽然开箱即用，但默认集合未必契合你的主题布局或业务场景。直接在编辑器里手工拼装「页首 + 图文 + 按钮」这类组合，每次都是重复劳动，样式也容易漂移。另一方面，register_block_pattern() 这类 API 的学习成本不低：模式结构与 theme.json 配合、分类要单独注册、还有依赖检查与注销逻辑，很多开发者卡在「能跑，但不知道怎么组织」的阶段。

核心能力与工作流程

这个技能围绕 WordPress 的 Block Editor API 展开，主要做三件事：

• 注册区块模式：通过 register_block_pattern() 声明自定义模式，把一组 block 的结构和属性固化下来，用户可以在插入器里一键插入。
• 注册模式分类：用 register_block_pattern_category() 创建自己的分类，按「页首」「图文卡片」「行动号召」等主题分组，方便在编辑器中检索。
• 条件化注册与注销：比如先判断 core/paragraph 区块是否已注册，再决定是否注册对应模式；不需要时用 unregister_block_pattern() 注销模式，避免它们出现在用户的插入器里。

典型步骤：

1. 在 functions.php 或独立入口文件中编写注册逻辑；
2. 用 PHP 数组描述模式的 block 组成，必要时结合 theme.json 控制颜色、间距等样式；
3. 处理依赖与生命周期：检查前置区块是否存在、在合适的时机注销模式。

适用边界与注意点

• 面向 Gutenberg / 区块主题 环境，传统经典主题不会渲染区块模式。
• 模式是预置的 block 组合，无法替代完整自定义区块；需要交互逻辑时仍要写 block。
• 注销模式要谨慎，可能影响其他插件或主题依赖的默认模式，建议在子主题或明确场景下操作。
• 官方文档：https://developer.wordpress.org/themes/patterns/registering-patterns/