Experience League

退出搜尋

Experience Cloud

Document Cloud

頁面範本——可編輯

已將可編輯的範本引入：

允許專業作者建立和編輯範本。
- 這些專業作者稱為范 本作者
- 範本作者必須是群組的成 template-authors 員。
提供可保留動態連線至從其建立之任何頁面的範本。如此可確保範本的任何變更都反映在頁面本身。
讓頁面元件更為通用，讓核心頁面元件不需自訂即可使用。

使用可編輯的範本，會將製作頁面的片段隔離在元件中。您可以在UI中設定必要的元件組合，因此不需要針對每個頁面變化開發新的頁面元件。

注意

AEM 6.4.5.0或更新版本是必要項目，才能搭配 SPA編輯器使用可編輯的範本。

注意

此外，也提供靜態範本。

本檔案：

提供建立可編輯範本的概觀
- 如需詳細資訊，請參閱「建立頁面範本」
說明建立可編輯範本所需的管理員／開發人員工作
說明可編輯範本的技術基礎

本檔案假設您已熟悉建立和編輯範本。請參閱編寫文件「建立頁面範本」，其中詳細說明範本作者可公開的可編輯範本功能。

注意

在新專案中設定可編輯的頁面範本時，也可能會感興趣下列教學課程：
AEM Sites快速入門第2部分——建立基本頁面和範本

Creating a New Template

建立可編輯的範本主要由範本作者使用範本主控台和範本編輯器。本節概述此程式，並說明在技術層級發生的情況。

如需如何在AEM專案中使用可編輯範本的詳細資訊，請參閱「使用Lazybones建立AEM專案」。

建立新的可編輯範本時：

為模板建立資料夾。這不是強制性的，而是建議的最佳做法。
選取范本類型。複製此項以建立范本定義。

注意

提供了一系列現成的模板類型。您也可以視需要建立自己的網站特定範本類型。
設定新範本的結構、內容原則、初始內容和版面配置。

結構
- 此結構可讓您定義範本的元件和內容。
- 在範本結構中定義的元件無法在產生的頁面上移動，也無法從任何產生的頁面刪除。
  - 如果您要在We.Retail範例內容以外的自訂資料夾中建立範本，您可以選擇「基礎元件」或使用「核心元件」。
- 如果您希望頁面作者能夠新增和移除元件，請將段落系統新增至範本。
- 元件可以解除鎖定並再次鎖定，以便您定義初始內容。
如需範本作者如何定義結構的詳細資訊，請參閱建立頁面範本。

有關結構的技術詳細資訊，請參閱本文中的結構。

原則
- 內容策略定義元件的設計屬性。
  - 例如，可用元件或最小／最大尺寸。
- 這些範本（和使用範本建立的頁面）適用。
如需範本作者如何定義原則的詳細資訊，請參閱建立頁面範本。

如需政策的技術詳細資訊，請參閱本檔案中的「內容政策」。

初始內容
- 「初始內容」會定義首次根據範本建立頁面時將出現的內容。
- 然後頁面作者就可以編輯初始內容。
如需範本作者如何定義結構的詳細資訊，請參閱建立頁面範本。

如需初始內容的技術詳細資訊，請參閱本檔案中的「初始內容」。

配置
- 您可以為各種裝置定義範本版面。
- 範本的互動式版面功能與網頁製作功能相同。
如需範本作者如何定義範本版面的詳細資訊，請參閱「建立頁面範本」。

如需範本版面的技術詳細資訊，請參閱本檔案中的「版面」。
啟用範本，然後允許範本用於特定內容樹狀結構。
- 範本可以啟用或停用，讓頁面作者可使用或無法使用。
- 範本可供某些頁面分支使用或無法使用。
如需範本作者如何啟用範本的詳細資訊，請參閱建立頁面範本。

如需啟用範本的技術詳細資訊，請參閱本檔案中的啟用和允許範本使用
使用它建立內容頁面。
- 使用範本建立新頁面時，靜態和可編輯範本之間沒有明顯的差異，也沒有任何指示。
- 對於頁面作者，此程式是透明的。
如需頁面作者如何使用範本建立頁面的詳細資訊，請參閱「建立和組織頁面」。

如需有關使用可編輯範本建立頁面的技術詳細資訊，請參閱本檔案中的「產生內容頁面」。

注意

編輯器用戶端程式庫會假設內容頁面 cq.shared 中存在命名空間，如果它不存在，則會產生JavaScript Uncaught TypeError: Cannot read property 'shared' of undefined 錯誤。

所有範例內容頁面都 cq.shared包含，因此任何以它們為基礎的內容都會自動包含 cq.shared。不過，如果您決定從頭開始建立您自己的內容頁面，而不以範例內容為基礎，則必須確定包含命名空間 cq.shared 。

如需詳細資訊，請參閱使用用戶端程式庫。

注意

切勿將任何需要國際化的資訊輸入模板。

範本資料夾

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

全域
特定網站

您為組織範本而建立的網站特定資料夾，是使用擁有管理員權限的帳戶建立。

注意

即使您可以巢狀內嵌資料夾，當使用者在 Templates Console中檢視資料夾時，資料夾會顯示為平面結構。

在標準AEM例項中，范 本主控台中 ，已有全域資料夾存在。如果當前資料夾中未找到策略和／或模板類型，則此選項將保留預設模板並充當備援。您可以將預設範本新增至此檔案夾，或建立新檔案夾（建議使用）。

注意

建立新資料夾以存放您的自訂範本，而不使用全域資料夾，是最佳的作法。

注意

資料夾必須由具有權限的用戶 admin 建立。

模板類型和策略會根據以下優先順序繼承到所有資料夾：

當前資料夾。
當前資料夾的父項。
/conf/global
/apps
/libs

將建立所有允許條目的清單。如果任何配置重疊( path/ label)，則僅向用戶顯示最接近當前資料夾的實例。

若要建立新資料夾，您可以執行下列任一動作：

以程式設計或使用CRXDE Lite
使用配置瀏覽器

使用CRXDE Lite

您可以以程式設計方式或使用CRXDE Lite，為您的例項建立新資料夾（在/conf下）。

必須使用下列結構：

/conf
    <your-folder-name> [sling:Folder]
        settings [sling:Folder]
            wcm [cq:Page]
                templates [cq:Page]
                policies [cq:Page]

然後，可以在資料夾根節點上定義以下屬性：

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

名稱: jcr:title
- 類型: String
- 值：您要顯示在「範本」控制台中的標題(資料夾 )。
除了 標準編寫權限 (例如 content-authors)，您現在需要指派群組，並定義作者在新資料夾中建立範本所需的存取權限(ACL)。

群 template-authors 組是需要指派的預設群組。有關詳細資訊，請參見以下章節「ACL和組」。

有關管理和分配訪問權限的完整詳細資訊，請參閱訪問權限管理。

使用配置瀏覽器

前往全 域導覽 ->工具 >設 定瀏覽器。

現有資料夾列在左側，包括全局資料夾。
按一下建立。
在「創 建配置 」對話框中，需要配置以下欄位：
- 標題:提供配置資料夾的標題
- 可編輯的範本:勾選以允許在此資料夾內編輯範本
Click Create

注意

在「配置瀏覽器」中，如果您希望在此資料夾內建立模板，則可以編輯全局資料夾並激活「可編輯模板」選項，但建議不要這樣做。

如需詳細資訊，請參閱Configuration Browser （設定瀏覽器）檔案。

ACL和組

建立模板資料夾後（通過CRXDE或使用配置瀏覽器），必須為模板資料夾的相應組定義ACL，以確保正確的安全性。

We.Retail參考實作的范本資料夾，可做為範例。

範本作者群組

群 template-authors 組是用來管理範本存取權的群組，是AEM的標準群組，但是是空的。必須將用戶添加到項目／站點的組。

注意

群 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`	範本作者	讀取	範本作者會根據其中一種預先定義的範本類型，建立新範本。
`/conf/<site>/settings/template-types`	匿名Web使用者	無	匿名Web用戶不能訪問模板類型

此預設 template-authors 群組僅涵蓋專案設定，所有成 template-authors 員皆可存取及編寫所有範本。對於更複雜的設定，當需要多個範本作者群組才能區隔範本的存取權時，必須建立更多自訂範本作者群組。不過，範本作者群組的權限仍會相同。

/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`	範本作者	讀取	範本作者會根據其中一種預先定義的範本類型，建立新範本
`/conf/global/settings/wcm/template-types`	匿名Web使用者	無	匿名Web用戶不能訪問模板類型

Template Type

建立新範本時，您需要指定範本類型：

範本類型可有效提供範本的範本。建立新模板時，將使用所選模板類型的結構和初始內容建立新模板。
- 模板類型將被複製以建立模板。
- 複製完成後，範本和範本類型之間的唯一連接，就是供參考之用的靜態參考。
範本類型可讓您定義：
- 頁元件的資源類型。
- 根節點的策略，它定義了模板編輯器中允許的元件。
- 建議您在範本類型上定義回應式格點和行動模擬器設定的中斷點。這是可選的，因為此設定也可以在個別範本上定義(請參閱范本類型和行動裝置群組)。
AEM提供一些現成可用的範本類型選擇，例如HTML5頁面和最適化表單頁面。
- We.Retail範例內容中提供了其他範例。
範本類型通常由開發人員定義。

現成可用的範本類型儲存在：

/libs/settings/wcm/template-types

注意

您不得變更路徑中的任 /libs 何項目。這是因為下次升級 /libs 實例時會覆寫的內容（套用修補程式或功能套件時可能會覆寫）。

您的網站特定範本類型應儲存在下列可比位置：

/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

注意

範本類型必須遵循正確的資料夾結構(即 /settings/wcm/...)，否則將找不到範本類型。

範本類型和行動裝置群組

可編輯範本（設為屬性的相對路徑）所使用的裝置群組，會定義哪些行動裝置可在頁面製作的版面模式 cq:deviceGroups中當做模擬器。此值可設為兩處：

在可編輯的範本類型上
在可編輯的範本上

建立新的可編輯範本時，值會從範本類型複製到個別範本。如果未在類型上設定值，則可在模板上設定值。建立模板後，該類型不繼承到模板。

注意

值必須 cq:deviceGroups 設定為相對路徑（如）, mobile/groups/responsive 而不設定為絕對路徑（如） /etc/mobile/groups/responsive。

注意

使用靜態範本，可 cq:deviceGroups 以在網站的根位置設定值。

使用可編輯的範本，此值現在會儲存在範本層級，而頁面根層級不支援此值。

建立範本類型

如果您已建立可做為其他範本基礎的範本，您可以將此範本複製為範本類型。

建立範本，就像您對任何可編輯的范本一樣，如此處所述，它將做為範本類型的基礎。
使用CRXDE Lite，將新建立的範本從節點複製 templates 到範本資 template-types 料夾下的節點。
從範本資料夾下 templates 的節點刪除範本。
在節點下的模板副本中，刪 template-types 除所有 cq:template 和 cq:templateType 屬 jcr:content 性。

您也可以使用範例可編輯的範本（可在GitHub上使用）來開發您自己的範本類型。

GITHUB代碼

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

在GitHub上開啟aem-sites-example-custom-template-type專案
將專案下載為 ZIP檔案

範本定義

可編輯範本的定義會儲存在使用者定義的資料夾（建議使用），或儲存在 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
- jcr:content
- structure
- policies
- thumbnail.png

jcr:content

此節點包含模板的屬性：

名稱: jcr:title
名稱: status
- 類型: String
- 值: draft、 enabled or或 disabled

結構

定義結果頁的結構：

會在建立新頁面時與 /initial初始內容()合併。
對結構所做的變更將反映在使用範本建立的任何頁面中。
( root )節 structure/jcr:content/root點定義將在結果頁面中提供的元件清單。
- 在模板結構中定義的元件不能在任何結果頁面上移動或刪除。
- 一旦元件解除鎖定後， editable 屬性就會設為 true。
- 當已包含內容的元件解除鎖定後，此內容就會移至分 initial 支。
節 cq:responsive 點保存響應式佈局的定義。

初始內容

定義建立新頁面時將包含的初始內容：

包含復 jcr:content 制到任何新頁面的節點。
在建立新頁面時 /structure與結構()合併。
如果初始內容在建立後變更，則不會更新任何現有的頁面。
節 root 點包含一個元件清單，用於定義在結果頁中可用的元件。
如果以結構模式將內容新增至元件，且該元件隨後已解除鎖定（反之亦然），則此內容會用作初始內容。

配置

編輯範本時，您可以定義版面，這會使用標準的互動式版面，也可以設定。

Content Policies

內容（或設計）原則可定義元件的設計屬性。例如，可用元件或最小／最大尺寸。這些範本（和使用範本建立的頁面）適用。可在範本編輯器中建立和選取內容原則。

屬性 cq:policy，在節 root 點

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

提供頁面段落系統內容原則的相對參考。
屬性 cq:policy位於元件顯式節點下， root提供各元件策略的連結。
實際策略定義儲存在以下位置：

/conf/<your-folder>/settings/wcm/policies/wcm/foundation/components

注意

策略定義的路徑取決於元件的路徑。 cq:policy 保存配置本身的相對引用。

注意

從可編輯範本建立的頁面不會在頁面編輯器中提供設計模式。

可編 policies 輯模板的樹狀結構與靜態模板的設計模式配置具有相同的層次結構，位於：

/etc/designs/<my-site>/jcr:content/<component-name>

靜態模板的設計模式配置是按頁面元件定義的。

頁面原則

頁面原則可讓您在范本或結果頁面中，定義頁面的內容原則（主參數）。

啟用和允許範本使用

啟用範本

範本必須先由下列其中一項啟用，才能使用：
- 從範本主控台啟用範本。
- 在節點上設定狀態 jcr:content 屬性。
  - 例如，在：
    
    /conf/<your-folder>/settings/wcm/templates/<your-template>/jcr:content
  - 定義屬性：
    - 名稱：狀態
    - 類型：字串
    - 值: enabled
允許的範本
- 在子分支的適當頁面或根頁面的「頁面屬性」上定義允許的範本路徑。
- 設定屬性：
  
  cq:allowedTemplates
  
  在所需 jcr:content 分支的節點上。
  例如，值為：
/conf/<your-folder>/settings/wcm/templates/.*;

產生的內容頁面

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

是使用從和模板中合併的子 structure 樹 initial 建立的
對範本和範本類型中保存的資訊有引用。這是通過具有以下 jcr:content 屬性的節點實現的：
- cq:template
  
  提供實際模板的動態參考；可讓範本的變更反映在實際頁面上。
- cq:templateType
  
  提供範本類型的參考。

chlimage_1-250

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

控制器- /content/<my-site>/<my-page>

參照範本的結果頁面。內容控制整個程式。根據定義，它訪問適當的模板和元件。
設定 - /conf/<my-folder>/settings/wcm/templates/<my-template>

範本和相關內容原則，定義頁面設定。
Model - OSGi bundles

OSGI搭售組合，實作功能。
檢視 - /apps/<my-site>/components

在作者和發佈環境中，內容都由元件呈現。

呈現頁面時：

範本:
- 其節 cq:template 點的屬性 jcr:content 將被引用，以訪問與該頁對應的模板。
元件:
- 頁面元件將合併模 structure/jcr:content 板的樹和頁 jcr:content 面的樹。
- 頁面元件僅允許作者編輯已標幟為可編輯的範本結構節點（以及任何子系）。
- 在頁面上呈現元件時，該元件的相對路徑會從節點中取 jcr:content 得；然後，將搜索模 policies/jcr:content 板節點下的相同路徑。
  - 此節 cq:policy 點的屬性指向實際內容策略（即它包含該元件的設計配置）。
  - 這可讓您擁有多個範本，可重複使用相同的內容原則設定。

adobe.com 上的資源

Automated Onboarding Auto Form Fill Personalized Experiences Dynamic Media Content Management Headless Cms

本頁內容

檢視下一個:

隱私權（已更新）

使用條款