內容片段範本

注意

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

注意

現在建議 建立內容片段模型以建立所有片段。

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

required

範本的標題(顯示在建立片段精靈中)。
jcr:description

String

可選

描述模板用途的文本(顯示在建立片段嚮導中)。
initialAssociatedContent

String[]

可選

預設情況下,具有系列路徑的陣列,應與新建立的內容片段相關聯。
precreateElements

Boolean

必要

true,if the subsasets resporting the elements(master element除外)of the content fragment is created;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

可選

預設: ""

提供變化(顯示在片段編輯器的變化標籤中)說明的文本。

本頁內容