内容片段模板

注意

现在,建 议使用内容片段模型创建所有片段。

内容片段模型用于We.Retail中的所有示例。

创建内容片段时,将选择模板。 它们为新片段提供了基本结构、元素和变异。 用于内容片段的模板受Granite Configuration Manager约束。

现成的模板位于:

  • /libs/settings/dam/cfm/templates

您可以在以下位置为内容片段创建站点特定的模板:

  • /apps/settings/dam/cfm/templates
    用于覆盖现成模板或提供客户特定、应用程序范围的模板的位置,这些模板在运行时不打算扩展/更改。

  • /conf/global/settings/dam/cfm/templates
    需要在运行时更改的实例范围客户特定模板的位置。

优先顺序为(降序)/conf/apps/libs

注意

您​必须​不要更改/libs路径中的任何内容。

这是因为下次升级实例时,/libs的内容会被覆盖(当您应用修补程序或功能包时,很可能会被覆盖)。

建议的配置和其他更改方法是:

  1. /apps下重新创建所需项(即,它存在于/libs中)

  2. /apps中进行任何更改

模板的基本结构如下:

conf
  global
    settings
      dam
        cfm
          templates
            <template-name>
              ...

具体结构为:

+ <template-name>
    - jcr:primaryType
    - jcr:title
    - jcr:description
    - initialAssociatedContent
    - precreateElements
    - version
    + elements
        - jcr:primaryType
        + <element-name>
            - jcr:primaryType
            - jcr:title
            - defaultContent
            - initialContentType
            - name
        ... + other element definitions
    + variations
        - jcr:primaryType
        + <variation-name>
            - jcr:primaryType
            - jcr:title
            - jcr:description
            - name
        ... + other variation definitions

有关节点及其属性的更多详细信息:

  • 模板

    名称 类型
    <template-name> nt:unstructured 此节点是每个模板的根节点。 它是必填的,应具有唯一的名称。
    jcr:title

    String

    必需

    模板的标题(显示在创建片段向导中)。
    jcr:description

    String

    可选

    描述模板用途的文本(显示在创建片段向导中)。
    initialAssociatedContent

    String[]

    可选

    默认情况下,具有与新创建的内容片段关联的集合路径的数组。
    precreateElements

    Boolean

    必需

    true,如果应在创建内容片段时创建表示内容片段的元素(主控元素除外)的子资产;false如果应“动态”创建它们。

    注意:当前,此参数必须设置为 true

    version

    Long

    必需

    内容结构的版本;当前支持:

    注意:当前,此参数必须设置为 2

  • 元素

    名称 类型
    elements

    nt:unstructured

    必需

    包含内容片段元素定义的节点。 它是必需的,并且对于Main元素至少需要包含一个子节点,但可以包含[1...n]子节点。

    当使用模板时,元素子分支被复制到片段的模型子分支。

    第一个元素(如CRXDE Lite所示)自动被视为main元素;节点名称无关,节点本身除以主资产代表外,没有特殊意义;其他元素将作为子资产处理。

  • 元素名称

    名称 类型
    <element-name> nt:unstructured 此节点定义元素。 它是必填的,应具有唯一的名称。
    jcr:title

    String

    必需

    元素的标题(显示在片段编辑器的元素选择器中)。
    defaultContent

    String

    可选

    默认: ""

    元素的初始内容;仅在precreateElements = true时使用
    initialContentType

    String

    可选

    默认: text/html

    元素的初始内容类型;仅当precreateElements = true时使用;当前支持:

    • text/html
    • text/plain
    • text/x-markdown
    name

    String

    必需

    元素的内部名称;必须为片段类型唯一。
  • 变量

    名称 类型
    variations

    nt:unstructured

    可选

    此可选节点包含内容片段初始变量的定义。
  • 变体名称

    名称 类型
    <variation-name>

    nt:unstructured

    变量节点存在时必需

    定义初始变量。
    默认情况下,变体会添加到内容片段的所有元素。

    变体的初始内容将与相应的元素相同(请参阅defaultContent/ initialContentType

    jcr:title

    String

    必需

    变量的标题(显示在片段编辑器的变量选项卡(左边栏)中)。
    jcr:desciption

    String

    可选

    默认: ""

    提供变量的描述的文本(显示在片段编辑器的变量选项卡(左边栏)中)。

On this page

Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now