内容片段模板

注意

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

内容片段模型用于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

    可选

    默认: ""

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

在此页面上

Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free