ページテンプレート

ページを作成する場合は、テンプレートを選択する必要があります。ページテンプレートは、新しいページのベースとして使用されます。テンプレートによって、結果ページの構造、すべての初期コンテンツ、使用可能なコンポーネント（設計プロパティ）が定義されます。これには、次のようないくつかの利点があります。

• ページテンプレートによって、専門的な作成者がテンプレートを作成および編集できます。
  • このような専門的な作成者は、テンプレート作成者​と呼ばれます。
  • テンプレート作成者は、template-authors グループのメンバーである必要があります。
• ページテンプレートから作成されたすべてのページとページテンプレートとの動的な接続が保持されます。これにより、テンプレートに対するあらゆる変更がページに反映されます。
• ページテンプレートによって、ページコンポーネントの汎用性が高まり、核となるページコンポーネントをカスタマイズなしで使用できます。

ページテンプレートを使用すると、ページの構成要素がコンポーネント内で分離されます。UI で必要なコンポーネントの組み合わせを設定できるので、ページのバリエーションごとに新しいページコンポーネントを開発する必要はなくなります。

このドキュメントでは、

• ページテンプレートの作成の概要を示します。
• 編集可能テンプレートの作成に必要な管理者や開発者のタスクについて説明します
• 編集可能テンプレートの技術的基礎について説明します
• AEM がテンプレートの利用可能性を評価する方法について説明します

新しいテンプレートの作成

ページテンプレートの作成は、主にテンプレート作成者が、テンプレートコンソールおよびテンプレートエディターを使用して行います。ここでは、そのプロセスの概要を示し、技術的なレベルでどのような処理が行われるかを説明します。

新しい編集可能テンプレートを作成する場合は、次の手順を実行します。

1. テンプレート用フォルダーを作成します。これは必須ではありませんが、推奨されるベストプラクティスです。

2. テンプレートタイプを選択します。テンプレート定義を作成するために、このタイプがコピーされます。

   メモ

   すぐに利用できるテンプレートタイプが用意されています。また、 独自のサイト固有のテンプレートタイプを作成する （必要に応じて）

3. 新しいテンプレートの構造、コンテンツポリシー、初期コンテンツおよびレイアウトを設定します。

   構造

   • 構造を使用して、テンプレートのコンポーネントとコンテンツを定義できます。
   • テンプレート構造で定義されたコンポーネントは、結果ページに移動することも、結果ページから削除することもできません。
   • ページ作成者がコンポーネントを追加または削除するには、テンプレートに段落システムを追加する必要があります。
   • コンポーネントのロックを解除（再度ロックできます）して、初期コンテンツを定義できます。

   テンプレート作成者が構造を定義する方法について詳しくは、ページテンプレートの作成を参照してください。

   構造の技術的な詳細については、このドキュメントの構造を参照してください。

   ポリシー

   • コンテンツポリシーでは、コンポーネントのデザインプロパティを定義します。

     • 例えば、使用できるコンポーネントや最小／最大サイズを定義できます。

   • これらは、テンプレート（およびテンプレートを使用して作成されたページ）に適用できます。

   テンプレート作成者がポリシーを定義する方法について詳しくは、ページテンプレートの作成を参照してください。

   ポリシーの技術的な詳細については、このドキュメントのコンテンツポリシーを参照してください。

   初期コンテンツ

   • 初期コンテンツは、テンプレートに基づいてページが最初に作成されたときに表示されるコンテンツを定義します。
   • その後、ページ作成者が初期コンテンツを編集できます。

   テンプレート作成者が構造を定義する方法について詳しくは、ページテンプレートの作成を参照してください。

   初期コンテンツの技術的な詳細については、このドキュメントの初期コンテンツを参照してください。

   レイアウト

   • デバイスの形式に合わせてテンプレートのレイアウトを定義できます。
   • テンプレートがページオーサリングと同じように動作するには、レスポンシブレイアウトを使用します。

   テンプレート作成者がテンプレートレイアウトを定義する方法について詳しくは、ページテンプレートの作成を参照してください。

   テンプレートレイアウトの技術的な詳細については、このドキュメントのレイアウトを参照してください。

4. テンプレートを有効化し、特定のコンテンツツリーに対して許可します。

   • テンプレートを有効または無効にして、ページ作成者が使用できるようにしたり、使用できなくしたりできます。
   • テンプレートは、特定のページブランチに対して使用可能または使用不可にすることができます。

   テンプレート作成者がテンプレートを有効にする方法について詳しくは、ページテンプレートの作成を参照してください。

   テンプレートの有効化の技術的な詳細については、このドキュメントの使用するテンプレートの有効化と許可を参照してください。

5. テンプレートを使用してコンテンツページを作成します。

   • テンプレートを新しいページを作成するために使用するときは、静的テンプレートと編集可能なテンプレートの間に視覚的な違いはありません。
   • ページの作成者にとって、この処理は透過的です。

   ページ作成者がテンプレートを使用してページを作成する方法について詳しくは、ページの作成と整理を参照してください。

   編集可能テンプレートを使用したページ作成の技術的な詳細については、このドキュメントの作成されるコンテンツページを参照してください。

テンプレートフォルダー

以下のフォルダーを使用してテンプレートを整理できます。

• global
• サイト固有

標準の AEM インスタンスでは、テンプレートコンソールに既に global フォルダーが存在します。この中にデフォルトのテンプレートが格納されており、現在のフォルダーにポリシーやテンプレートタイプがない場合にはフォールバックとして機能します。このフォルダーにデフォルトのテンプレートを追加するか、新しいフォルダーを作成できます（推奨）。

テンプレートのタイプやポリシーは、次の優先順位に従ってすべてのフォルダーに継承されます。

1. 現在のフォルダー
2. 現在のフォルダーの親
3. /conf/global
4. /apps
5. /libs

許可されたすべてのエントリのリストが表示されます。オーバーラップする設定がある場合（path／label）、現在のフォルダーに最も近いインスタンスがユーザーに表示されます。

新しいフォルダーを作成するには、次のいずれかの方法を実行します。

• プログラムで自動的に、または CRXDE Lite を使用して作成
• 設定ブラウザーの使用

CRXDE Lite の使用

1. インスタンスの新しいフォルダー（/conf の下）は、プログラムで自動的にまたは CRXDE Lite を使用して作成できます。

   次の構造を使用する必要があります。

   /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 とグループの節を参照してください。

設定ブラウザーの使用

1. グローバルナビゲーション／ツール／設定ブラウザー​に移動します。

   global フォルダーなどの既存のフォルダーは左側に一覧表示されます。

2. 「作成」をクリックします。

3. 設定を作成​ダイアログで、以下のフィールドを設定する必要があります。

   • タイトル：設定フォルダーのタイトルを指定します
   • 編集可能なテンプレート：このフォルダー内で編集可能なテンプレートを許可する場合にチェックマークを付けます

4. 「作成」をクリックします。

ACL とグループ

（CRXDE または設定ブラウザーを使用して）テンプレートフォルダーが作成されたら、セキュリティを確保するために、テンプレートフォルダーの適切なグループに ACL を定義する必要があります。

例として、WKND チュートリアルのテンプレートフォルダーを使用できます。

template-authors グループ

template-authors グループは、テンプレートへのアクセスを管理するために使用されるグループで、AEM に標準で付属していますが空です。ユーザーは、プロジェクト／サイトのグループに追加する必要があります。

次の表に、テンプレートの編集に必要な権限を示します。

デフォルトの template-authors グループは、プロジェクト設定のみに対応しています。この場合、template-authors のすべてのメンバーは、すべてのテンプレートへのアクセスとそれらの作成が許可されています。より複雑な設定では、テンプレートへのアクセスを分離するために複数のテンプレート作成者グループが必要な場合、より多くのカスタムテンプレート作成者グループを作成する必要があります。 ただし、テンプレート作成者グループの権限は同じです。

テンプレートタイプ

新しいテンプレートの作成時には、テンプレートタイプを指定する必要があります。

• テンプレートタイプは、テンプレートのためのテンプレートとなるものです。新しいテンプレートを作成する際、選択したテンプレートタイプの構造と初期コンテンツを使用して、新しいテンプレートが作成されます。

  • テンプレートタイプがコピーされて、テンプレートが作成されます。
  • コピー後のテンプレートとテンプレートタイプとの関連付けは、情報を取得するだけの静的参照のみとなります。

• テンプレートタイプでは、以下の項目を定義できます。

  • ページコンポーネントのリソースタイプ。
  • ルートノードのポリシー。テンプレートエディターで許可されるコンポーネントを定義します。
  • そのテンプレートタイプで、モバイルエミュレーターのレスポンシブグリッドと設定のブレークポイントを定義することをお勧めします。

• AEM には、既製のテンプレートタイプがいくつか用意されています（HTML5 ページ、アダプティブフォームページなど）。

  • その他の例は、 WKND チュートリアル.

• テンプレートタイプは通常、開発者が定義します。

既製のテンプレートタイプは次のフォルダーに保存されています。

• /libs/settings/wcm/template-types

サイト固有のテンプレートタイプは、以下に相当する場所に保存してください。

• /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

テンプレートタイプの作成

他のテンプレートの基盤となるテンプレートを作成した場合、このテンプレートをテンプレートタイプとしてコピーできます。

1. こちらのドキュメントで説明されているページテンプレートと同じようにテンプレートを作成します。これは、テンプレートタイプの基盤となります。
2. CRXDE Lite を使用している場合は、新しく作成したテンプレートを templates ノードからtemplate-typesテンプレートフォルダーの下の ノードにコピーします。
3. このテンプレートをテンプレートフォルダーの下の templates ノードから削除します。
4. template-types ノードの下にあるテンプレートのコピーで、すべての jcr:content ノードから cq:template および cq:templateType プロパティをすべて削除します。

また、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](#initial-content)
  • jcr:content
  • [structure](#structure)
  • [policies](#policies)
  • thumbnail.png

jcr:content

このノードは、テンプレートのプロパティを保持します。

• 名前：jcr:title
• 名前：status
  • ``型：String
  • 値：draft、enabled または disabled

構造

作成されるページの構造を定義します。

• 新しいページの作成時に初期コンテンツ（/initial）と統合されます。

• 構造に加えた変更は、そのテンプレートを使用して作成されたすべてのページに反映されます。

• root（structure/jcr:content/root）ノードは、作成されたページで使用できるコンポーネントのリストを定義します。

  • テンプレート構造で定義されたコンポーネントは、作成されたページで移動することも、作成されたページから削除することもできません。
  • コンポーネントをロック解除した後、 editable プロパティはに設定されます。 true.
  • 既にコンテンツを含むコンポーネントをロック解除すると、このコンテンツは initial ブランチに移動されます。

• cq:responsive ノードは、レスポンシブレイアウトの定義を保持します。

初期コンテンツ

作成時に新しいページに表示される初期コンテンツを定義します。

• すべての新しいページにコピーされる jcr:content ノードが含まれます。
• 新しいページの作成時に構造（/structure）と統合されます。
• 作成後に初期コンテンツが変更されても、既存のページはすべて更新されません。
• The root ノードは、作成されたページで使用可能なコンポーネントを定義する、コンポーネントのリストを保持します。
• コンテンツが構造モードでコンポーネントに追加され、その後、そのコンポーネントがロック解除された場合（またはコンポーネントのロック解除後にコンテンツが追加された場合）、このコンテンツは初期コンテンツとして使用されます。

レイアウト

テンプレートを編集する際に、レイアウトを定義できます。これには、標準のレスポンシブレイアウトが使用されます。

コンテンツポリシー

コンテンツポリシーでは、コンポーネントのデザインプロパティを定義します。例えば、使用できるコンポーネントや最小／最大サイズを定義できます。これらは、テンプレート（およびテンプレートを使用して作成されたページ）に適用できます。 コンテンツポリシーは、テンプレートエディターで作成および選択できます。

• root ノード上の cq:policy プロパティ
  /conf/<your-folder>/settings/wcm/templates/<your-template>/policies/jcr:content/root
  ページの段落システムのコンテンツポリシーに対する相対参照を提供します。

• root の下のコンポーネントを明示的に示すノードの cq:policy プロパティは、個々のコンポーネントのポリシーへのリンクを提供します。

• 実際のポリシー定義は、次の場所に保存されます。
  /conf/<your-folder>/settings/wcm/policies/wcm/foundation/components

ページポリシー

ページポリシーを使用して、テンプレートまたは作成されるページで、ページ（メインの parsys）のコンテンツポリシーを定義できます。

使用するテンプレートの有効化と許可

1. テンプレートの有効化

   テンプレートを使用する前に、次のいずれかの方法で有効にする必要があります。

   • テンプレート​コンソールからテンプレートを有効化する。

   • jcr:content ノードの status プロパティを設定する。

     • 例：

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

     • 次のプロパティを定義します。

       • 名前：ステータス
       • タイプ：String
       • 値：enabled

2. 許可されたテンプレート

   • 適切なページまたはサブブランチのルートページの​ページプロパティ​に対して許可されたテンプレートのパスを定義します。

   • プロパティを設定します。

     cq:allowedTemplates
     を必要なブランチの jcr:content ノードに設定します。

   例えば、次の値を使用します。

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

作成されるコンテンツページ

編集可能テンプレートから作成されるページには、次の特徴があります。

• テンプレートの structure と initial を統合したサブツリーを使用して作成されます。

• テンプレートおよびテンプレートタイプに保持されている情報への参照を保持します。これは、次のプロパティを持つ jcr:content ノードを使用して行います。

  • cq:template - 実際のテンプレートへの動的参照を提供します。テンプレートへの変更を実際のページに反映させることができます。

  • cq:templateType - テンプレートタイプへの参照を提供します。

上の図は、テンプレート、コンテンツおよびコンポーネントの相関関係を示したものです。

• コントローラー - /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 プロパティは、実際のコンテンツポリシーを指します（すなわち、このプロパティは、そのコンポーネントのデザイン設定を保持しています）。
        • これにより、同じコンテンツポリシー設定を再利用する複数のテンプレートを作成できます。

使用可能なテンプレート

サイト管理インターフェイスで新しいページを作成する場合、使用可能なテンプレートのリストは、新しいページの場所と、各テンプレートで指定されている配置制限によって異なります。

次のプロパティは、新しいページをページ P の子として配置する場合に、テンプレート T を使用できるかどうかを決定します。これらの各プロパティは、0 個以上の正規表現を保持する複数値の文字列で、パスの照合に使用されます。

• jcr:content サブノードの P または P の上位ページの cq:allowedTemplates プロパティ。

• T の allowedPaths プロパティ。

• T の allowedParents プロパティ。

• P のテンプレートの allowedChildren プロパティ。

評価は次のように行われます。

• P で始まるページ階層を昇順にしているときに見つかった、最初の空でない cq:allowedTemplates プロパティは、T のパスと一致します。一致する値がない場合、T は拒否されます。

• T に空でない allowedPaths プロパティがあるものの、 P のパスと一致する値がない場合、T は拒否されます。

• 上記のプロパティの両方が空または存在しない場合、P と同じアプリケーションに属さない限り、T は拒否されます。T は、T のパスの 2 番目のレベルの名前が P のパスの 2 番目のレベルの名前と同じである場合に限り、P と同じアプリケーションに属します。例えば、テンプレート /apps/wknd/templates/foo は、ページ /content/wknd と同じアプリに属しています。

• T に空でない allowedParents プロパティがあるものの、P のパスと一致する値がない場合、T は拒否されます。

• P のテンプレートに空でない allowedChildren プロパティがあるものの、T のパスと一致する値がない場合、T は拒否されます。

• その他すべての場合は、T は許可されます。

以下の図は、テンプレートの評価プロセスを示しています。

子ページで使用するテンプレートの制限

特定のページの下に子ページを作成するために使用できるテンプレートを制限するには、ページの jcr:content ノードの cq:allowedTemplates プロパティを使用して、子ページとして許可するテンプレートのリストを指定します。例えば、/apps/wknd/templates/page-content リストの各値は、許可されている子ページのテンプレートへの絶対パスである必要があります。

以下を使用すると、 cq:allowedTemplates プロパティを使用して、テンプレートの jcr:content ノードを追加して、このテンプレートを使用するすべての新しく作成されたページにこの設定を適用します。

テンプレート階層に関する制約などをさらに追加する場合は、テンプレートの allowedParents/allowedChildren プロパティを使用できます。その後、テンプレート T から作成されたページが、テンプレート T から作成されたページと親子である必要があることを明示的に指定できます。

Business.Adobe.com リソース