內容片段模型 建議您建立所有新內容片段。
內容片段模型用於WKND中的所有範例。
在AEM 6.3之前,內容片段是根據範本而非模型建立。
內容片段範本現已過時。 它們仍可用於建立片段,但建議改用內容片段模型。 片段範本不會新增任何功能,且這些功能將在未來版本中移除。
建立內容片段時會選取範本。 它們為新片段提供了基本結構、元素和變異。 用於內容片段的範本需受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時,很可能會覆寫)。
設定和其他變更的建議方法為:
重新建立所需項目(亦即, /libs
)底下 /apps
在內進行任何變更 /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 |
必填 |
包含內容片段元素定義的節點。 此為必要項目,需要包含 主要 元素,但可以包含[1..n]子節點。 使用模板時,元素子分支將被複製到片段的模型子分支。 第一個元素(如CRXDE Lite中所檢視)會自動被視為 main 元素;節點名稱無關,節點本身除以主要資產表示外,沒有特殊意義;其他元素會以子資產的形式處理。 |
元素名稱
名稱 | 類型 | 值 |
---|---|---|
<element-name> |
nt:unstructured |
此節點定義元素。 此為必要項目,且名稱應是唯一的。 |
jcr:title |
必填 |
元素的標題(顯示在片段編輯器的元素選取器中)。 |
defaultContent |
可選 預設: "" |
元素的初始內容;僅使用 precreateElements = true |
initialContentType |
可選 預設: |
元素的初始內容類型;僅使用
|
name |
必填 |
元素的內部名稱;片段類型必須是唯一的。 |
變數
名稱 | 類型 | 值 |
---|---|---|
variations |
可選 |
此選用節點包含內容片段初始變異的定義。 |
變數名稱
名稱 | 類型 | 值 |
---|---|---|
<variation-name> |
若變異節點存在,則此為必要項目 |
定義初始變數。 變異的初始內容將與個別元素相同(請參閱 |
jcr:title |
必填 |
變異的標題(顯示在片段編輯器的 變異 標籤(左側欄)。 |
jcr:desciption |
可選 預設: "" |
提供變異說明的文字 (顯示在片段編輯器的 變異 標籤(左側欄)。 |