內容片段範本

注意

某些內容片段功能需要應用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

可選

預設: ""

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

本頁內容

Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now