内容片段模型 建议用于创建所有新的内容片段。
内容片段模型用于WKND中的所有示例。
在AEM 6.3之前,内容片段是基于模板而不是模型创建的。
内容片段模板现已弃用。 它们仍可用于创建片段,但建议改用内容片段模型。 片段模板中不会添加任何新功能,将来版本中将删除这些功能。
创建内容片段时选择模板。 它们为新片段提供基本结构、元素和变量。 用于内容片段的模板受Granite Configuration Manager约束。
现成的模板保存在下:
/libs/settings/dam/cfm/templates
您可以在以下位置为内容片段创建特定于站点的模板:
/apps/settings/dam/cfm/templates
用于覆盖现成模板或提供特定于客户的应用程序范围的模板的位置,这些模板在运行时不会进行扩展/更改。
/conf/global/settings/dam/cfm/templates
运行时需要更改的全实例客户特定模板的位置。
优先顺序为(降序) /conf
, /apps
, /libs
.
您 必须 不更改 /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 |
必需 |
模板的标题(显示在 创建片段 向导)。 |
jcr:description |
可选 |
描述模板用途的文本(显示在 创建片段 向导)。 |
initialAssociatedContent |
可选 |
一个数组,其中包含集合的路径,默认情况下,这些路径应该关联到新创建的内容片段。 |
precreateElements |
必需 |
注释:此参数当前必须设置为 |
version |
必需 |
内容结构的版本;当前支持: 注释:此参数当前必须设置为 |
元素
名称 | 类型 | 价值 |
---|---|---|
elements |
必需 |
包含内容片段元素定义的节点。 它是强制性的,并且需要为至少包含一个子节点 主要 元素,但可以包含[1..n]个子节点。 使用模板时,元素子分支复制到片段的模型子分支。 第一个元素(在CRXDE Lite中查看)自动视为 主要 元素;节点名称是无关的,并且节点本身不具有特殊重要性,除了它由主资产表示这一事实;其他元素作为子资产处理。 |
元素名称
名称 | 类型 | 价值 |
---|---|---|
<element-name> |
nt:unstructured |
此节点定义一个元素。 它是必填项,应具有唯一名称。 |
jcr:title |
必需 |
元素的标题(显示在片段编辑器的元素选择器中)。 |
defaultContent |
可选 默认: "" |
元素的初始内容;仅在 precreateElements = true |
initialContentType |
可选 默认: |
元素的初始内容类型;仅在
|
name |
必需 |
元素的内部名称;对于片段类型必须是唯一的。 |
变体
名称 | 类型 | 价值 |
---|---|---|
variations |
可选 |
此可选节点包含内容片段的初始变体的定义。 |
变量名称
名称 | 类型 | 价值 |
---|---|---|
<variation-name> |
如果存在变体节点,则此为必填项 |
定义初始变量。 变体将具有与相应元素相同的初始内容(请参阅 |
jcr:title |
必需 |
变体的标题(显示在片段编辑器的 变量 选项卡(左边栏)。 |
jcr:desciption |
可选 默认: "" |
提供变体说明的文本 (显示在片段编辑器的 变量 选项卡(左边栏)。 |