頁面範本 — 可編輯 page-templates-editable

可編輯的範本已引入以:

  • 允許專業作者建立和編輯範本

    • 這類特殊作者稱為​ 範本作者
    • 範本作者必須是template-authors群組的成員。
  • 提供可保留動態連線至任何建立頁面的範本。 這麼做可確保對範本所做的任何變更都反映在頁面本身中。

  • 讓頁面元件變得更通用,以便無需自訂即可使用核心頁面元件。

使用可編輯的範本,建立頁面的片段會隔離在元件中。 您可以在UI中設定必要的元件組合,如此一來,您就不需要為每個頁面變數開發新的頁面元件。

NOTE
靜態範本也可供使用。

本檔案:

  • 提供建立可編輯範本的概觀

  • 說明建立可編輯範本所需的管理員/開發人員工作

  • 說明可編輯範本的技術基礎

本檔案假設您已熟悉建立和編輯範本。 請參閱撰寫檔案建立頁面範本,其中詳細列出範本作者所看到的可編輯範本功能。

NOTE
下列教學課程可能也適合在新專案中設定可編輯的頁面範本:
開始使用AEM Sites第2部分 — 建立基礎頁面和範本

建立新範本 creating-a-new-template

建立可編輯的範本主要是由範本作者使用範本主控台和範本編輯器完成。 本節提供此程式的概述,並接著說明在技術層級進行的工作。

有關如何在AEM專案中使用可編輯範本的資訊,請參閱使用Lazybones建立AEM專案

建立可編輯的範本時,您可以:

  1. 為範本🔗建立資料夾。 此資料夾並非強制性,但建議使用最佳實務。

  2. 選取範本型別。 此型別已複製以建立範本定義

    note note
    NOTE
    現成提供一系列範本型別。 如有必要,您也可以建立您自己的網站特定範本型別
  3. 設定新範本的結構、內容原則、初始內容和版面配置。

    結構

    • 結構可讓您定義範本的元件和內容。

    • 範本結構中定義的元件無法在產生的頁面上移動,也無法從任何產生的頁面中刪除。

      • 如果您是在We.Retail範例內容之外的自訂資料夾中建立範本,您可以選擇基礎元件或使用核心元件
    • 如果您希望頁面作者能夠新增和移除元件,請新增段落系統至範本。

    • 您可以解除鎖定元件,然後再將其鎖定,讓您可以定義初始內容。

    如需範本作者如何定義結構的詳細資訊,請參閱建立頁面範本

    如需結構的技術細節,請參閱本檔案中的結構

    原則

    • 內容原則會定義元件的設計屬性。

      • 例如,可用的元件或最小/最大尺寸。
    • 這些原則適用於範本(以及使用範本建立的頁面)。

    如需範本作者如何定義原則的詳細資訊,請參閱建立頁面範本

    如需原則的技術詳細資訊,請參閱本檔案中的內容原則

    初始內容

    • 初始內容會定義根據範本首次建立頁面時顯示的內容。
    • 然後,頁面作者可以編輯初始內容。

    如需範本作者如何定義結構的詳細資訊,請參閱建立頁面範本

    如需初始內容的技術細節,請參閱本檔案中的初始內容

    配置

    • 您可以為一系列裝置定義範本配置。
    • 範本的回應式版面運作方式與頁面製作相同。

    如需範本作者如何定義範本配置的詳細資訊,請參閱建立頁面範本

    如需範本配置的技術詳細資訊,請參閱本檔案中的配置

  4. 啟用範本,然後允許用於特定內容樹。

    • 您可以啟用或停用範本,讓頁面作者可以使用或無法使用此範本。
    • 範本可以供某些頁面分支使用或無法使用。

    如需範本作者如何啟用範本的詳細資訊,請參閱建立頁面範本

    如需啟用範本的技術詳細資訊,請參閱本檔案中的啟用和允許我們使用範本e

  5. 使用它來建立內容頁面。

    • 使用範本建立頁面時,靜態範本與可編輯範本之間沒有可見的差異,也沒有任何指示。
    • 對於頁面作者,程式是透明的。

    如需頁面作者如何使用範本建立頁面的詳細資訊,請參閱建立及組織頁面

    如需使用可編輯的範本建立頁面的技術詳細資訊,請參閱本檔案中的結果內容頁面

TIP
切勿在範本中輸入任何必須國際化的資訊。 基於內部化的目的,建議使用核心元件🔗的本地化功能。
NOTE
範本是簡化頁面建立工作流程的強大工具。 然而,太多的範本會讓作者不知所措,並使頁面建立變得混亂。 一個好的經驗法則是將範本數保持在100以下。
由於潛在的效能影響,Adobe不建議使用超過1000個範本。
NOTE
編輯器使用者端程式庫假設內容頁面中存在cq.shared名稱空間。 如果不存在,則會導致JavaScript錯誤Uncaught TypeError: Cannot read property 'shared' of undefined
所有範例內容頁面都包含cq.shared,因此任何以這些頁面為基礎的內容都會自動包含cq.shared。 但是,如果您決定從頭開始建立自己的內容頁面,而不根據範例內容,則必須確定包括cq.shared名稱空間。
如需進一步資訊,請參閱使用使用者端資料庫

範本資料夾 template-folders

若要組織範本,您可以使用下列資料夾:

  • 全域
  • 特定網站
    您建立用來組織範本的網站特定資料夾,是以具有管理員許可權的帳戶所建立。
NOTE
即使您可以巢狀內嵌資料夾,當使用者在​ 範本 ​主控台中檢視資料夾時,資料夾會顯示為平面結構。

在標準AEM執行個體中,global ​資料夾存在於範本主控台中。 此資料夾會保留預設範本,並在目前資料夾中找不到原則及/或範本型別時,做為遞補專案。 您可以將預設範本新增至此資料夾或建立資料夾(建議)。

NOTE
最佳實務是建立資料夾來儲存您的自訂範本,而不是使用全域資料夾。
CAUTION
資料夾必須由具有admin許可權的使用者建立。

範本型別和原則會根據下列優先順序繼承至所有資料夾:

  1. 目前的資料夾。
  2. 目前資料夾的父項或父項。
  3. /conf/global
  4. /apps
  5. /libs

將會建立所有允許專案的清單。 如果任何設定重疊( path/ label),則只會向使用者顯示最接近目前資料夾的執行個體。

若要建立資料夾,請執行下列動作:

  • 以程式設計方式或使用CRXDE Lite
  • 使用設定瀏覽器

使用 CRXDE Lite using-crxde-lite

  1. 可以程式設計方式或使用CRXDE Lite為您的執行個體建立新資料夾(在/conf下)。

    必須使用下列結構:

    code language-xml
    /conf
        <your-folder-name> [sling:Folder]
            settings [sling:Folder]
                wcm [cq:Page]
                    templates [cq:Page]
                    policies [cq:Page]
    
  2. 然後,您可以在資料夾根節點上定義下列屬性:

    <your-folder-name> [sling:Folder]

    名稱:jcr:title

    • 類型:String

    • 值:您要在​ 範本 ​主控台中顯示的標題(資料夾)。

  3. 在​ 增加 ​至標準撰寫許可權和許可權(例如content-authors),指派群組並定義必要的存取許可權(ACL),讓您的作者能夠在新資料夾中建立範本。

    template-authors群組是必須指派的預設群組。 如需詳細資訊,請參閱下列區段ACL和群組

    如需管理和指派存取許可權的完整詳細資訊,請參閱存取許可權管理

使用設定瀏覽器 using-the-configuration-browser

  1. 移至​ 全域導覽 > 工具 > 設定瀏覽器

    現有資料夾會列在左側,包括​ 全域 ​資料夾。

  2. 按一下​ 建立

  3. 在​ 建立組態 ​對話方塊中,必須設定下列欄位:

    • 標題:提供設定資料夾的標題
    • 可編輯的範本:選取以允許在此資料夾中編輯範本
  4. 按一下「建立」。

NOTE
若要在此資料夾中建立範本,您可以在組態瀏覽器中編輯全域資料夾並啟動​ 可編輯的範本 ​選項。 不過,我們不建議使用此作法。
如需詳細資訊,請參閱設定瀏覽器檔案。

ACL和群組 acls-and-groups

建立範本資料夾後(透過CRXDE或使用「組態瀏覽器」),必須為範本資料夾的適當群組定義ACL,以確保適當的安全性。

We.Retail參考實作的範本資料夾可作為範例使用。

範本 — 作者群組 the-template-authors-group

template-authors群組是用來管理範本存取權的群組,且隨附於AEM,但為空白。 必須將使用者新增至專案/網站的群組。

CAUTION
必須能建立範本的使用者的template-authors群組是​ 僅限
編輯範本的功能強大,若未正確完成,現有範本可能會失效。 因此,此角色應著重於且僅包含合格使用者。

下表詳細說明範本編輯的必要許可權。

路徑
角色/群組
許可權
說明
/conf/<your-folder>/settings/wcm/templates
範本作者
讀取、寫入、復寫
在網站特定/conf空間中建立、讀取、更新、刪除和復寫範本的範本作者
匿名Web使用者
讀取
匿名Web使用者在轉譯頁面時必須讀取範本
內容作者
復寫
replicateContent作者在啟用頁面時必須啟用頁面的範本
/conf/<your-folder>/settings/wcm/policies
Template Author
讀取、寫入、復寫
在網站特定/conf空間中建立、讀取、更新、刪除和復寫範本的範本作者
匿名Web使用者
讀取
匿名Web使用者在轉譯頁面時必須讀取原則
內容作者
復寫
內容作者在啟用頁面時必須啟用頁面範本的原則
/conf/<site>/settings/template-types
範本作者
讀取
範本作者會根據其中一個預先定義的範本型別建立範本。
匿名Web使用者
匿名Web使用者不得存取範本型別

此預設template-authors群組僅涵蓋專案設定,其中所有template-authors成員都可存取及編寫所有範本。 對於更複雜的設定,需要多個範本作者群組來區隔範本的存取權,則必須建立更多自訂範本作者群組。 不過,範本作者群組的許可權將仍相同。

/conf/global下的舊版範本 legacy-templates-under-conf-global

請勿在/conf/global中儲存範本。 但是,對於某些舊版安裝,此位置可能仍存在範本。 ​在此類舊式情況下,應明確設定下列/conf/global個路徑。

路徑
角色/群組
許可權
說明
/conf/global/settings/wcm/templates
範本作者
讀取、寫入、復寫
在中建立、讀取、更新、刪除和復寫範本的範本作者 /conf/global
匿名Web使用者
讀取
匿名Web使用者在轉譯頁面時必須讀取範本
內容作者
復寫
內容作者在啟用頁面時必須啟用頁面的範本
/conf/global/settings/wcm/policies
Template Author
讀取、寫入、復寫
在中建立、讀取、更新、刪除和復寫範本的範本作者 /conf/global
匿名Web使用者
讀取
匿名Web使用者在轉譯頁面時必須讀取原則
內容作者
復寫
內容作者在啟用頁面時必須啟用頁面範本的原則
/conf/global/settings/wcm/template-types
範本作者
讀取
範本作者會根據預先定義的範本型別之一建立範本
匿名Web使用者
匿名Web使用者不得存取範本型別

範本型別 template-type

建立範本時,請指定範本型別:

  • 範本型別可有效提供範本的範本。 建立範本時,會使用所選範本型別的結構和初始內容來建立範本。

    • 範本型別會複製以建立範本。
    • 複製一旦發生,範本和範本型別之間的唯一連線是靜態參考,以供參考。
  • 範本型別可讓您定義:

    • 頁面元件的資源型別。
    • 根節點的原則,定義範本編輯器中允許的元件。
    • Adobe建議您為回應式格線定義中斷點,並在範本型別上的設定行動模擬器。 此步驟是選擇性的,因為組態也可以在個別範本上定義(請參閱範本型別和行動裝置群組)。
  • AEM提供少量現成可用的範本型別,例如「HTML5頁面」和「最適化表單頁面」。

    • 提供其他範例作為We.Retail範例內容的一部分。
  • 範本型別通常由開發人員定義。

現成可用的範本型別儲存在下列位置:

  • /libs/settings/wcm/template-types
CAUTION
請勿變更/libs路徑中的任何專案。 原因是因為下次升級執行個體時,/libs的內容會被覆寫(當您套用Hotfix或Feature Pack時,這些內容可能會被覆寫)。

您的網站特定範本型別應儲存在類似位置:

  • /apps/settings/wcm/template-types

您自訂範本型別的定義應該儲存在使用者定義的資料夾中(建議使用),或是儲存在global中。 例如:

  • /conf/<my-folder-01>/<my-folder-02>/settings/wcm/template-types
  • /conf/<my-folder>/settings/wcm/template-types
  • /conf/global/settings/wcm/template-types
CAUTION
範本型別必須遵循正確的資料夾結構(即/settings/wcm/...),否則找不到範本型別。

範本型別和行動裝置群組 template-type-and-mobile-device-groups-br

用於可編輯範本的裝置群組 (設定為屬性cq:deviceGroups的相對路徑)會定義哪些行動裝置在頁面製作的配置模式中可以作為模擬器。 此值可在以下兩個位置設定:

  • 在可編輯的範本型別上
  • 在可編輯的範本上

建立可編輯的範本時,值會從範本型別複製到個別範本。 如果型別上未設定值,則可在範本上設定值。 建立範本後,就沒有任何型別繼承到範本。

CAUTION
cq:deviceGroups的值必須設定為相對路徑,例如mobile/groups/responsive,而不是絕對路徑,例如/etc/mobile/groups/responsive
NOTE
若使用靜態範本,可在網站的根目錄設定cq:deviceGroups的值。
若使用可編輯的範本,此值現在會儲存在範本層級,而不支援在頁面根層級。

建立範本型別 creating-template-types

如果您已建立可作為其他範本基礎的範本,則可以複製此範本作為範本型別。

  1. 建立範本,就像您在此處記錄的任何可編輯範本一樣,可作為範本型別的基礎。
  2. 使用CRXDE Lite,將新建立的範本從templates節點複製到範本資料夾下的template-types節點。
  3. 範本資料夾下的templates節點中刪除範本。
  4. template-types節點下的範本復本中,從所有jcr:content節點刪除所有cq:templatecq:templateType屬性。

您也可以使用GitHub提供的範例可編輯範本,在此基礎上開發自己的範本型別。

GITHUB上的程式碼

您可以在GitHub上找到此頁面的程式碼

範本定義 template-definitions

可編輯範本的定義會儲存在使用者定義的資料夾 (建議使用)或global中。 例如:

  • /conf/<my-folder>/settings/wcm/templates
  • /conf/<my-folder-01>/<my-folder-02>/settings/wcm/templates
  • /conf/global/settings/wcm/templates

範本的根節點屬於型別cq:Template,骨架結構為:

<template-name>
  initial
    jcr:content
      root
        <component>
        ...
        <component>
  jcr:content
    @property status
  policies
    jcr:content
      root
        @property cq:policy
        <component>
          @property cq:policy
        ...
        <component>
          @property cq:policy
  structure
    jcr:content
      root
        <component>
        ...
        <component>
      cq:responsive
        breakpoints
  thumbnail.png

主要元素包括:

  • <template-name>

    • [initial](#initial-content)
    • jcr:content
    • [structure](#structure)
    • [policies](#policies)
    • thumbnail.png

jcr:content jcr-content

此節點會保留範本的屬性:

  • 名稱jcr:title

  • 名稱status

    • 類型String

    • draftenableddisabled

結構 structure

定義結果頁面的結構:

  • 在建立頁面時與初始內容( /initial)合併。

  • 對結構所做的變更會反映在使用範本建立的任何頁面中。

  • root (structure/jcr:content/root)節點會定義結果頁面中可用的元件清單。

    • 範本結構中定義的元件無法在任何結果頁面上移動或從中刪除。

    • 解鎖元件後,editable屬性會設為true

    • 解鎖已包含內容的元件後,此內容會移至initial分支。

  • cq:responsive節點保留回應式配置的定義。

初始內容 initial-content

定義新頁面建立時的初始內容:

  • 包含已複製到任何新頁面的jcr:content節點。
  • 在建立頁面時與結構(/structure)合併。
  • 如果在建立後變更初始內容,則會更新任何現有頁面。
  • root節點保留元件清單,以定義結果頁面中可用的專案。
  • 如果在結構模式中將內容新增到元件,而該元件之後已解鎖(或反之),則此內容會用作初始內容。

版面配置 layout

編輯範本時,您可以定義配置,此實務使用標準回應式配置,也可以是已設定

內容原則 content-policies

內容(或設計)原則會定義元件的設計屬性,例如元件的可用性或最小/最大維度。 這些原則適用於範本(以及使用範本建立的頁面)。 可在範本編輯器中建立和選取內容原則。

  • root節點上的屬性cq:policy
    /conf/<your-folder>/settings/wcm/templates/<your-template>/policies/jcr:content/root
    提供頁面段落系統內容原則的相對參照。

  • 屬性cq:policy位於root下的元件明確節點上,提供個別元件原則的連結。

  • 實際原則定義儲存在下列位置:
    /conf/<your-folder>/settings/wcm/policies/wcm/foundation/components

NOTE
原則定義的路徑取決於元件的路徑。 cq:policy保留組態本身的相對參照。
NOTE
從可編輯範本建立的頁面不會在頁面編輯器中提供設計模式。
可編輯範本的policies樹狀結構與下列靜態範本的設計模式組態具有相同的階層:
/etc/designs/<my-site>/jcr:content/<component-name>
靜態範本的設計模式設定是按頁面元件定義的。

頁面原則 page-policies

頁面原則可讓您在範本或結果頁面中定義頁面(主要parsys)的內容原則

啟用和允許使用範本 enabling-and-allowing-a-template-for-use

  1. 啟用範本

    使用範本之前,必須透過下列任一方式啟用範本:

    • 正在從​ 範本 ​主控台啟用範本

    • 正在設定jcr:content節點上的狀態屬性。

      • 例如,在:

        /conf/<your-folder>/settings/wcm/templates/<your-template>/jcr:content

      • 定義屬性:

        • 名稱:狀態
        • 型別:字串
        • 值: enabled
  2. 允許的範本

    例如,使用值:

    /conf/<your-folder>/settings/wcm/templates/.*

產生的內容頁面 resultant-content-pages

從可編輯的範本建立的頁面:

  • 是以從範本中的structureinitial合併的子樹狀結構建立

  • 具有範本和範本型別中資訊的參考。 您可以使用具有下列屬性的jcr:content節點來實現此功能:

    • cq:template
      提供實際範本的動態參考;可讓範本的變更反映在實際頁面上。

    • cq:templateType
      提供範本型別的參考。

chlimage_1-71

上圖顯示範本、內容和元件如何相互關聯:

  • 控制器 — /content/<my-site>/<my-page>
    參照範本的結果頁面。 內容會控制整個流程。 根據定義,它會存取適當的範本和元件。

  • 設定 — /conf/<my-folder>/settings/wcm/templates/<my-template>
    範本和相關內容原則定義頁面設定。

  • 模型 — OSGi套件組合
    OSGI組合實作該功能。

  • 檢視 — /apps/<my-site>/components
    在製作和發佈環境中,內容都是由元件轉譯。

轉譯頁面時:

  • 範本

    • 已參考其jcr:content節點的cq:template屬性,以存取對應於該頁面的範本。
  • 元件

    • 頁面元件會將範本的structure/jcr:content樹狀結構與頁面的jcr:content樹狀結構合併。

    • 頁面元件僅可讓作者編輯已標示為可編輯的範本結構的節點(以及任何子系)。

    • 在頁面上呈現元件時,會從jcr:content節點取得該元件的相對路徑;接著會搜尋範本的policies/jcr:content節點下的相同路徑。

      • 此節點的cq:policy屬性指向實際內容原則(亦即,它儲存該元件的設計組態)。

      • 此功能可讓您擁有重複使用相同內容原則設定的多個範本。

recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2