跳到内容

升级设计管理器中的嵌套模块

上次更新时间: 二月 12, 2025

除非另有说明,否则适用于以下任何订阅

营销 Hub   Professional , Enterprise
内容 Hub   Professional , Enterprise
旧版 Marketing Hub Basic

在新的设计管理器中,一些 v1 自定义模块可能需要升级到 v2 模块框架,才能用于创建未来的内容。新模块框架功能更强大、更可靠,并能为编辑器带来更好的体验。

虽然您可以在 v2 框架中继续使用大多数 v1 模块,但 不再支持 嵌入模块的 HTML + HubL 标记 中的 模块。 在 v1 自定义模块中,这些嵌套模块会在页面编辑器中显示为额外的可编辑模块。

新的 v2 模块框架包含更强大的模块字段 ,可为模块添加灵活的元素,这些元素可在页面级别上进行编辑。这消除了模块内嵌模块所产生的冗余和兼容性问题,从而带来更好的整体设计体验。 v2 模块框架仍然支持HubL 标记,但前提是它们指向特定的模块字段类型。您可以使用模块编辑器内置的复制片段功能,确保 HubL 格式正确。

识别嵌套模块

如果您的某个模板中存在嵌套模块,您可能会看到以下意外行为:

  • 以前可在内容编辑器中编辑的模块已无法访问。
  • 内容编辑器中出现无法编辑的意外或缺失内容。

在将现有的 v1 自定义模块升级到 v2 之前,您可以查看这些模块,以主动识别代码中的嵌套模块。 嵌套模块可能是使用内联语法或块语法添加到 v1 自定义模块中的。

内联语法

{{ widget.my_awesome_field }}
{% rich_text "my_rich_text_nested_module" label='This is nested inside the custom module, and renders separate ', html='<div>My default content goes here</div>' %}

块语法

{{ widget.my_awesome_field }}
{% widget_block rich_text "my_rich_text_nested_module" %}
{% widget_attribute "html" %}
<div>
My default content goes here
</div>
{% end_widget_attribute "html" %}
{% end_widget_block %}
 

以前,这些示例中的任何一个都会在内容编辑器中呈现一个额外的可编辑富文本模块,该模块可以在左侧边栏中自定义。

在 v2 版模块框架中,嵌套的富文本模块将不会出现在内容编辑器中。

在 v2 模块框架中,模板上的嵌套模块将不再可以编辑。 这些模块需要从头开始重新创建,或者从克隆和编辑过的原始模块版本中重新创建

请注意删除模块中的HubL 标记可能会导致任何已发布的页面、博客文章或电子邮件中引用该模块的内容丢失。 只要原始嵌套模块仍在 v1 框架中且未升级,这些模块中任何已发布的内容将继续按预期呈现。

替换嵌套模块

如果想创建一个新版本的 v1 嵌套模块以用于 v2 模块框架,可以克隆 v1 模块并升级克隆模块。升级后的克隆模块可以进行编辑,以确保模块能在新框架中成功运行。或者,也可以从头开始重新创建模块

克隆您的 v1 模块并升级到 v2:

  • 导航至 "市场营销">"文件和模板">"设计工具",然后在查找器中找到模块。
请注意: 系统可能会提示您立即升级模块,请务必点击取消
  • 右键单击要复制的模块,选择 "克隆"。
  • 同样,系统会提示你将模块升级到新框架。点击选择要使用该模块的模板类型,然后点击升级
  • 更新嵌套 模块的 HTML + HubL 标记,将 HubL 标记实例切换为 字段

在 v2 框架中创建新模块后,您需要克隆和编辑希望与该模块一起使用的任何模板,以创建未来的内容。

  • 在查找器中找到任何使用 v1 模块的模板,并创建该模板的克隆。
  • 在新克隆的模板中,右键单击 v1 模块并选择 "交换 模块"。 然后找到并单击刚刚创建的模块的新 v2 版本
这篇文章有帮助吗?
此表单仅供记载反馈。了解如何获取 HubSpot 帮助