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
  1. /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中所述)會自動被視為主 要元 素;節點名稱無關,節點本身除了以主資產表示外,沒有特殊意義;其他元素則視為子資產處理。
  • 元素名稱
    名稱 類型
    < 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
    必要
    變數的標題(顯示在片段編輯器的「變數」( Variation )頁籤中(左側邊欄))。
    jcr:desciption
    String
    可選
    預設: ""
    提供變化說明的文字(顯 示在片段編輯器的「變 」標籤(左側欄)中)。