现在,建 议使用内容片段模型创建所有片段。
内容片段模型用于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
的内容会被覆盖(当您应用修补程序或功能包时,很可能会被覆盖)。
建议的配置和其他更改方法是:
在/apps
下重新创建所需项(即,它存在于/libs
中)
在/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 |
必需 |
包含内容片段元素定义的节点。 它是必需的,并且对于Main元素至少需要包含一个子节点,但可以包含[1...n]子节点。 当使用模板时,元素子分支被复制到片段的模型子分支。 第一个元素(如CRXDE Lite所示)自动被视为main元素;节点名称无关,节点本身除以主资产代表外,没有特殊意义;其他元素将作为子资产处理。 |
元素名称
名称 | 类型 | 值 |
---|---|---|
<element-name> |
nt:unstructured |
此节点定义元素。 它是必填的,应具有唯一的名称。 |
jcr:title |
必需 |
元素的标题(显示在片段编辑器的元素选择器中)。 |
defaultContent |
可选 默认: "" |
元素的初始内容;仅在precreateElements = true 时使用 |
initialContentType |
可选 默认: |
元素的初始内容类型;仅当
|
name |
必需 |
元素的内部名称;必须为片段类型唯一。 |
变量
名称 | 类型 | 值 |
---|---|---|
variations |
可选 |
此可选节点包含内容片段初始变量的定义。 |
变体名称
名称 | 类型 | 值 |
---|---|---|
<variation-name> |
变量节点存在时必需 |
定义初始变量。 变体的初始内容将与相应的元素相同(请参阅 |
jcr:title |
必需 |
变量的标题(显示在片段编辑器的变量选项卡(左边栏)中)。 |
jcr:desciption |
可选 默认: "" |
提供变量的描述的文本(显示在片段编辑器的变量选项卡(左边栏)中)。 |