内容片段模板 content-fragment-templates

Last update: Thu May 04 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

主题：
Developing

创建对象：

Developer

CAUTION

AEM 6.4已结束扩展支持，本文档将不再更新。有关更多详细信息，请参阅技术支助期. 查找支持的版本此处.

CAUTION

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

CAUTION

内容片段模型现在建议您创建所有片段。

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

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

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

/libs/settings/dam/cfm/templates

您可以在下面为内容片段创建特定于站点的模板：

/apps/settings/dam/cfm/templates

覆盖现成模板或提供客户特定的应用程序范围模板的位置，这些模板在运行时不会扩展/更改。
/conf/global/settings/dam/cfm/templates

在运行时需要更改的实例范围特定于客户的模板的位置。

优先级顺序为（降序） /conf, /apps, /libs.

CAUTION

您必须不会更改 /libs 路径。

这是因为 /libs 在下次升级实例时被覆盖（当您应用修补程序或功能包时，可能会被覆盖）。

配置和其他更改的推荐方法是：

重新创建所需项目(即， /libs)下 /apps
在 /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

必需

包含内容片段元素定义的节点。它是强制性的，并且需要包含主要元素，但可以包含[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

可选

默认: ""

提供变体描述的文本 (在片段编辑器的变量选项卡（左边栏）。

recommendation-more-help

2315f3f5-cb4a-4530-9999-30c8319c520e