Show Menu
主题×

内容片段模板

现在建议使用 “内容片段模型”来创建您的所有片段。
内容片段模型用于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. 在下面重新创建所需的项(即,当它存在 /libs 时) /apps
  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
    required
    模板的标题(在创建片段向 导中显示 )。
    jcr:description
    String
    可选
    描述模板用途的文本(在创建片段向导 中显示 )。
    initialAssociatedContent
    String[]
    可选
    默认情况下,具有与新创建的内容片段关联的集合路径的数组。
    precreateElements
    Boolean
    必需
    true ,如果应在创建内容片段时创建表示内容片段的元素(主元素除外)的子资产; ,如果应“迅速”创建它们。
    注意 : 当前,此参数必须设置为 true
    version
    Long
    必需
    内容结构的版本; 当前支持:
    注意 : 当前,此参数必须设置为 2
  • 元素
    名称 类型
    elements
    nt:unstructured
    必需
    包含内容片段元素定义的节点。 它是必需的,并且需要至少包含一个Main元素 的子节 点,但可以包含[1...n]子节点。
    当使用模板时,元素子分支被复制到片段的模型子分支。
    第一个元素(如CRXDE Lite中所述)自动被视为主 要元 素; 节点名称无关,节点本身除以主资产代表外,没有特殊意义; 其他元素将作为子资产处理。
  • 元素名称
    名称 类型
    < 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
    可选
    默认: ""
    提供变体描述的文本(在片 段编辑器的“变 ”选项卡(左边栏)中显示。