某些內容片段功能需要應用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
的內容(套用修補程式或功能套件時,很可能會覆寫)。
配置和其他更改的建議方法為:
在/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 |
required |
範本的標題(顯示在建立片段精靈中)。 |
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 |
必要 |
變數的標題(顯示在片段編輯器的變數標籤中(左側欄))。 |
jcr:desciption |
可選 預設: "" |
提供變化(顯示在片段編輯器的變化標籤中)說明的文本。 |