內容片段範本

注意

現在建議使用內容片段模型 ,以建立您的所有片段。

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,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

    可選

    預設: ""

    提供變化說明的文字(顯 示在片段編輯器的「變 」標籤(左側欄)中)。

本頁內容