某些內容片段功能需要應用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
的內容(而當您套用Hotfix或Feature Pack時,很可能會覆寫)。
設定和其他變更的建議方法為:
在/apps
下重新建立所需項(即/libs
中存在的項)
在/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 |
必要 |
範本的標題(顯示在建立片段精靈中)。 |
jcr:description |
可選 |
說明範本用途的文字(顯示在建立片段精靈中)。 |
initialAssociatedContent |
可選 |
依預設,具有系列路徑的陣列應與新建立的內容片段相關聯。 |
precreateElements |
必填 |
注意:目前此參數必須設為 |
version |
必填 |
內容結構的版本;目前支援: 注意:目前此參數必須設為 |
名稱 | 類型 | 值 |
---|---|---|
elements |
必填 |
包含內容片段元素定義的節點。 它是強制項,並且需要為Main元素包含至少一個子節點,但可以包含[1.n]子節點。 使用模板時,元素子分支將被複製到片段的模型子分支。 第一個元素(如CRXDE Lite中所檢視)會自動被視為main元素;節點名稱無關,節點本身除以主要資產表示外,沒有特殊意義;其他元素會以子資產的形式處理。 |
名稱 | 類型 | 值 |
---|---|---|
<element-name> |
nt:unstructured |
此節點定義元素。 此為必要項目,且名稱應是唯一的。 |
jcr:title |
必填 |
元素的標題(顯示在片段編輯器的元素選取器中)。 |
defaultContent |
可選 預設: "" |
元素的初始內容;僅在precreateElements = true 時使用 |
initialContentType |
可選 預設: |
元素的初始內容類型;僅在
|
name |
必填 |
元素的內部名稱;片段類型必須是唯一的。 |
名稱 | 類型 | 值 |
---|---|---|
variations |
可選 |
此選用節點包含內容片段初始變異的定義。 |
名稱 | 類型 | 值 |
---|---|---|
<variation-name> |
若變異節點存在,則此為必要項目 |
定義初始變數。 變異的初始內容將與個別元素相同(請參閱 |
jcr:title |
必填 |
變異的標題(顯示在片段編輯器的 Variation標籤中(左側欄))。 |
jcr:desciption |
可選 預設: "" |
提供變異的說明的文字(顯示在片段編輯器的Variation標籤中(左側欄))。 |