内容片段模板

注意

某些内容片段功能需要应用AEM 6.4 Service Pack 2(6.4.2.0)

注意

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

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

创建内容片段时会选择模板。 它们为新片段提供了基本结构、元素和变量。 用于内容片段的模板受Granite配置管理器的约束。

现成模板保留在以下位置:

  • /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

可选

默认: ""

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

在此页面上