ページを作成するとき、テンプレートを選択する必要があります。これは新しいページを作成するための基本として使用されます。テンプレートは、作成されるページの構造、初期コンテンツ、および使用できるコンポーネントを定義します。
テンプレートエディターにより、テンプレートを作成して管理することは、開発者のみのタスクではなくなりました。ある種のパワーユーザーも、テンプレート作成者と呼ばれ、関与することができます。環境の設定、クライアントライブラリの作成、使用されるコンポーネントの作成は今でも開発者が行う必要がありますが、これら基本となる部分が一度配置されると、テンプレート作成者が開発プロジェクトなしにテンプレートを作成して構成できるようになります。
テンプレートコンソールにより、テンプレート作成者は次のことができます。
テンプレートエディターにより、テンプレート作成者は次のことができます。
このドキュメントでは、テンプレート作成者がテンプレートコンソールおよびエディターを使用して、編集可能なテンプレートを作成および管理する方法を説明します。
編集可能なテンプレートが技術レベルで機能する方法について詳しくは、開発者ドキュメント「ページテンプレート」を参照してください。
テンプレートエディターは、テンプレートレベルで直接ターゲット設定をサポートしません。編集可能テンプレートに基づいて作成されたページは、ターゲット設定できますが、テンプレート自体はできません。
管理者は、設定ブラウザーでテンプレートフォルダーを設定し、テンプレート作成者がそのフォルダーにテンプレートを作成できるように、適切な権限を適用する必要があります。
作業を開始する前に、新しいテンプレートの作成では共同作業が必要ということを考慮に入れておくことが重要です。この理由から、ロールがそれぞれのタスクに示されます。これは、実際にテンプレートを使用してページを作成する方法に影響を与えませんが、ページがテンプレートに関係する方法には影響を与えます。
テンプレートコンソールおよびテンプレートエディターを使用する新しいテンプレートの作成では、次の役割の間の共同作業が必要です。
admin
権限が必要なテンプレートのために新しいフォルダーを作成します。template-authors
のメンバーである特定の作成者です。
一部タスク(フォルダーの作成など)の性質により、開発環境が必要です。これには知識と経験が必要です。
このドキュメントで説明されるタスクは、それらの実行を担当するロールとともにリストされています。
編集可能な新しいテンプレートを作成するには、次のようにします。
https://<host>:<port>/libs/wcm/core/content/sites/templates.html/conf
多くの場合、許可されたテンプレートは Web サイトが最初に設定されたときに事前定義されています。
国際化する必要がある情報は、テンプレートに含めないでください。
ローカライズが必要なヘッダーやフッターなどのテンプレート要素の場合は、コアコンポーネントのローカライゼーション機能を利用します。
テンプレートフォルダーは、プロジェクト固有のテンプレートを保持するためプロジェクトで作成する必要があります。これは管理者タスクであり、ドキュメントのページテンプレートで説明しています。
テンプレートコンソールを(ツール/一般から)開き、必要なフォルダーに移動します。
標準の AEM インスタンスでは、テンプレートコンソールに既にグローバルフォルダーが存在します。この中にデフォルトのテンプレートが格納されており、現在のフォルダーにポリシーやテンプレートタイプがない場合にはフォールバックとして機能します。
プロジェクトで作成されたテンプレートフォルダーを使用することが推奨されるベストプラクティスです。
「作成」、「テンプレートを作成」を選択し、ウィザードを開きます。
「テンプレートタイプ」を選択してから、「次へ」を選択します。
テンプレートタイプは、定義済みのテンプレートレイアウトであり、テンプレートのためのテンプレートであると見なすことができます。これらは、開発者またはシステム管理者が事前定義します。詳しくは、開発者ドキュメントのページテンプレートを参照してください。
次の「テンプレート詳細」を入力します。
「作成」を選択します。確認メッセージが表示されます。テンプレートの編集を開始するには「開く」、テンプレートコンソールに戻るには「完了」を選択します。
新しく作成されたテンプレートは、コンソールでドラフトとマークされます。これは、ページ作成者がまだテンプレートを使用できないことを示します。
テンプレートは、ページ作成ワークフローを効率化する強力なツールです。ただし、テンプレートが多すぎると作成者が圧倒され、ページ作成がを混乱するおそれがあります。経験上、テンプレートの数を 100 未満に抑えるのがよいでしょう。
パフォーマンスに影響が及ぶ可能性があるので、1000 個を超えるテンプレートを用意することはお勧めしません。
テンプレートには、次のプロパティを指定できます。
プロパティを表示または編集するには:
テンプレートのステータス(ドラフト、有効、無効)は、コンソールに示されます。
テンプレートサムネールを定義するには:
ページを作成するときにテンプレートを使用するには、以下の作業が必要です。
テンプレートを有効化または無効化して、「ページを作成」ウィザードで使用できるようにするか、使用できないようにします。
テンプレートを有効化すると、テンプレート作成者がテンプレートをさらに更新しようとするときに警告が表示されます。これは、テンプレートが参照されている可能性があること、変更するとテンプレートを参照しているページに影響が及ぶ可能性があることをユーザーに通知するためのものです。
テンプレートのステータス(ドラフト、有効、無効)は、コンソールに示されます。
テンプレートは、特定のページブランチに対して使用可能または使用不可にすることができます。
テンプレートを使用できるようにするブランチのルートページのページプロパティを開きます。
「詳細」タブを開きます。
テンプレート設定で「フィールドを追加」を使用してテンプレートへのパスを指定します。
パスは直接入力またはパターンを使用できます。例えば、次のように指定します。
/conf/<your-folder>/settings/wcm/templates/.*
パスの順序は無関係で、すべてのパスがスキャンされ、あらゆるテンプレートが取得されます。
許可されたテンプレートのリストが空の場合、値/リストが見つかるまでツリーを上に移動します。
使用可能なテンプレートを参照してください。許可されたテンプレートの原則は保たれます。
「保存」をクリックして、ページプロパティの変更を保存します。
多くの場合、許可されたテンプレートはサイト設定されたときにサイト全体に対して事前定義されています。
ページが表示されるときにテンプレートが参照される場合、テンプレートをパブリッシュ環境で使用できるようにするには、(完全に設定された)テンプレートを公開する必要があります。
テンプレートを作成(または編集)するときに、様々な側面を定義できます。テンプレートの編集は、ページのオーサリングに似ています。
ツールバーのモードセレクターを使用すると、テンプレートの適切な外観を選択して編集できます。
ページ情報メニューの「ページポリシー」オプションを使用すると、必要なページポリシーを選択できます。
作成者が既に有効化されているテンプレートの編集を開始すると、警告が表示されます。これは、テンプレートが参照されている可能性があること、変更するとテンプレートを参照しているページに影響が及ぶ可能性があることをユーザーに通知するためのものです。
テンプレートの以下の属性を編集できます。
ページ作成者は、構造に追加されたコンポーネントを結果ページから移動および削除できません。ページ作成者がコンポーネントを結果ページに移動またはコンポーネントを削除するには、テンプレートに段落システムを追加する必要があります。
コンポーネントがロックされているとコンテンツは追加できますが、ページ作成者はこれを編集できません。コンポーネントのロックを解除して、初期コンテンツを定義できます。
構造モードで、ロックが解除されたコンポーネントの親コンポーネントは移動、切り取り、削除できません。
コンポーネントのロックが解除されていると、結果ページにコピーされる、テンプレートから作成された初期コンテンツを定義できます。これらのロックが解除されたコンポーネントは結果ページで編集できます。
初期コンテンツモードおよび結果ページで、アクセス可能な親を持つ、ロックが解除されたすべてのコンポーネント(例:レイアウトコンテナ内のコンポーネント)は削除できます。
レイアウトでは、必要なデバイスの形式に合わせたテンプレートのレイアウトを事前定義できます。テンプレートオーサリングのレイアウトモードには、ページオーサリングのレイアウトモードと同じ機能があります。
ページポリシーは、定義済みのページポリシーをページに接続できます。これらのページポリシーは、様々なデザイン設定を定義します。
スタイルシステムを使用すると、テンプレート作成者がコンポーネントのコンテンツポリシーのスタイルクラスを定義し、コンテンツ作成者がページでのコンポーネントの編集時にそのスタイルクラスを選択できます。これらのスタイルは、1 つのコンポーネントの別の視覚的バリエーションとして使用することができるので、コンポーネントがより柔軟で扱いやすいものになります。
詳しくは、スタイルシステムのドキュメントを参照してください。
構造モードで、テンプレートのコンポーネントおよびコンテンツを定義し、テンプレートおよびそのコンポーネントのポリシーを定義できます。
テンプレートエディターの構造モードで実行できるいくつかのアクションと支援機能があります。
テンプレートにコンポーネントを追加する方法はいくつか用意されています。
追加すると、各コンポーネントは次の要素でマーキングされます。
テンプレートに(最初から用意されている)タイトルコンポーネントを追加すると、デフォルトのテキスト構造が含まれます。
これを変更し、独自のテキストを追加すると、テンプレートからページが作成されるときにこの更新されたテキストが使用されます。
デフォルトのテキスト(構造)のままにすると、タイトルはデフォルトで後続のページの名前になります。
まったく同じではありませんが、テンプレートにコンポーネントやアセットを追加する操作は、ページをオーサリングするときのアクションと数多くの類似点があります。
コンポーネントがテンプレートに追加されると、コンポーネントでアクションが実行されます。個々のインスタンスにはそれぞれ、使用可能なアクションにアクセスできるツールバーが用意されています。ツールバーはコンポーネントの種類によって異なります。
また、実行されるアクションに依存します。例えば、コンポーネントのポリシーが関連付けられていると、デザイン設定アイコンが使用できるようになります。
これら 2 つのアクションにより、コンポーネントにコンテンツを追加できます。
構造モードで、オレンジ色の境界線は現在選択されているコンポーネントを示します。また、点線は親コンポーネントを示します。
コンテンツ(またはデザイン)ポリシーでは、コンポーネントのデザインプロパティを定義します。例えば、使用できるコンポーネントや最小/最大サイズを定義できます。これらのポリシーは、テンプレートと、そのテンプレートを使用して作成されるページに適用されます。
コンポーネントのコンテンツポリシーを作成するか、既存のポリシーを選択します。
これにより、デザイン詳細を定義できます。
設定ウィンドウは 2 つに分割されます。
利用できるプロパティは選択されたコンポーネントに依存します。例えば、テキストコンポーネントのプロパティでは、コピー&ペーストのオプション、フォーマットのオプション、パラグラフスタイルなどが定義されます。
コンテンツ(またはデザイン)ポリシーでは、コンポーネントのデザインプロパティを定義します。例えば、使用できるコンポーネントや最小/最大サイズを定義できます。これらのポリシーは、テンプレートと、そのテンプレートを使用して作成されるページに適用されます。
ポリシーの下で、既存のポリシーを選択して、ドロップダウンからコンポーネントに適用できます。
新しいポリシーは、ポリシーの選択ドロップダウンの横にある追加ボタンを選択して追加できます。新しいタイトルを「ポリシーのタイトル」フィールドに入力します。
ポリシーの選択ドロップダウンで選択された既存のポリシーは、ドロップダウンの横にあるコピーボタンを使用して、新規ポリシーにコピーできます。新しいタイトルを「ポリシーのタイトル」フィールドに入力します。デフォルトで、コピーされたポリシーは「X のコピー」というタイトルになります。ここで X はコピーされたポリシーのタイトルです。
ポリシーの説明は、「ポリシーの説明」フィールドにオプションで入力できます。
「他のテンプレートも選択したポリシーを使用しています」セクションでは、「ポリシーの選択」ドロップダウンで選択したポリシーを、他のどのテンプレートが使用しているかを簡単に確認できます。
同じタイプの複数のコンポーネントが初期コンテンツとして追加される場合は、同じポリシーがすべてのコンポーネントに適用されます。
プロパティの見出しの下で、コンポーネントの設定を定義できます。見出しには次の 2 つのタブがあります。
メインタブでは、コンポーネントの最も重要な設定が定義されます。
例えば、画像コンポーネントでは、許容される幅は、レイジーローディングを有効にするとともに定義できます。
設定で複数の設定が許される場合は、「追加」ボタンをクリックまたはタップして、他の設定を追加します。
設定を削除するには、設定の右にある「削除」ボタンをクリックまたはタップします。
設定を削除するには、「削除」ボタンをクリックまたはタップします。
「機能」タブを使用すると、コンポーネントの追加の機能を有効または無効にできます。
例えば、画像コンポーネントでは、切り抜き比率、許容される画像の方向、およびアップロードを許可するかどうかを定義できます。
AEM のトリミング比率は、高さ/幅で定義されます。これは従来の定義である「幅/高さ」とは異なり、レガシー互換性のための設定です。ページオーサリングユーザーは、名前を明確に定義していれば、これが UI に表示されるので、違いに気が付きません。
リッチテキストエディターを実装するコンポーネントのコンテンツポリシーは、UI 設定を通じて RTE で提供されるオプションに対してのみ定義できます。
レイアウトコンテナのポリシーおよびプロパティ設定は、一般使用の場合と似ていますが、いくつか違いがあります。
ポリシーの設定はコンテナコンポーネントでは必須です。これにより、コンテナで使用できるコンポーネントを定義できるからです。
ウィンドウの一般使用の場合と同じく、設定ウィンドウは 2 つに分割されます。
コンテンツ(またはデザイン)ポリシーでは、コンポーネントのデザインプロパティを定義します。例えば、使用できるコンポーネントや最小/最大サイズを定義できます。これらのポリシーは、テンプレートと、そのテンプレートを使用して作成されるページに適用されます。
ポリシーの下で、既存のポリシーを選択して、ドロップダウンからコンポーネントに適用できます。これは、ウィンドウの一般使用の場合と同じく機能します。
プロパティ見出しの下で、レイアウトコンテナのために使用できるコンポーネントを選択して、それらの設定を定義することができます。見出しには次の 3 つのタブがあります。
許可されたコンポーネントタブで、レイアウトコンテナのために使用できるコンポーネントを判断できます。
デフォルトのコンポーネントタブで、与えられたメディアタイプに自動的に関連付けられるコンポーネントを定義できるので、作成者がアセットをアセットブラウザーからドラッグするとき、AEM にはそれに関連付けられるコンポーネントがわかります。ドロップゾーンのあるコンポーネントだけが、こうした設定のために使用できます。
「マッピングの追加」をクリックまたはタップして、完全に新しいコンポーネントおよび MIME タイプマッピングを追加します。
リストの中のコンポーネントを選択し、「タイプの追加」をクリックまたはタップして、既にマップされているコンポーネントに追加の MIME タイプを追加します。「削除」アイコンをクリックして、MIME タイプを削除します。
レスポンシブ設定タブで、レイアウトコンテナの結果グリッドの列数を設定できます。
コンポーネントをロックまたはロック解除することで、コンテンツを初期コンテンツモードで変更できるかどうかを定義します。
コンポーネントのロックが解除されているときは、次のようになります。
これには、ロック解除コンテナコンポーネントも含まれるので、初期コンテンツモードまたは結果ページのいずれかに、さらにコンポーネントを追加できます。ロック解除前にコンテナにコンポーネント/コンテンツを既に追加している場合は、これらは今後構造モードでは表示されなくなりますが、初期コンテンツモードでは表示されます。構造モードでは、コンテナコンポーネント自体だけがその許容コンポーネントのリストとともに表示されます。
スペースを節約するため、レイアウトコンテナは、許可されたコンポーネントのリストが収まるように拡大されません。代わりにコンテナがスクロールできるリストになります。
設定できるコンポーネントは、「ポリシー」アイコン付きで表示され、それをタップまたはクリックすると、そのコンポーネントのポリシーおよびプロパティを編集できます。
構造が、テンプレートに基づいてページを作成した後で更新される場合、これらのページはテンプレートの変更を反映します。ツールバーに警告が表示されて、この事実が確認ダイアログとともに示されます。
初期コンテンツモードは、テンプレートに基づいてページが最初に作成されるときに、表示されるコンテンツを定義するために使用されます。その後初期コンテンツはページ作成者が編集できます。
構造モードで作成されたすべてのコンテンツは初期コンテンツに表示されますが、選択および編集できるのはロックが解除されているコンポーネントのみです。
初期コンテンツモードは、そのテンプレートで作成されたページの編集モードと考えることができます。このため、ポリシーは、初期コンテンツモードで定義されず、構造モードで定義されます。
編集可能なロックが解除されたコンポーネントはマーキングされています。選択すると、青い境界線が表示されます。
ロックが解除されたコンポーネントにはツールバーがあり、コンテンツを編集および設定できます。
(構造モードで)コンテナコンポーネントのロックが解除されている場合、(初期コンテンツモードで)新しいコンポーネントをコンテナに追加できます。初期コンテンツモードに追加されるコンポーネントは、結果ページに移動したり、そこから削除したりできます。
コンポーネントは、コンポーネントをここにドラッグ領域を使用するか、適切なコンテナのツールバーから「新規コンポーネントを挿入」オプションを使用して追加できます。
テンプレートに基づいてページを作成した後に、テンプレートの初期コンテンツを更新しても、これらのページはテンプレートの初期コンテンツの変更により影響を受けません。
初期コンテンツは、コンテンツを作成するための出発点となるコンポーネントおよびページレイアウトを準備するためのものです。そのまま残す実際のコンテンツとなるものではありません。そのため、初期コンテンツは変換できません。
ヘッダーやフッターなど、翻訳可能なテキストをテンプレートに含める必要がある場合は、コアコンポーネントのローカライゼーション機能を使用できます。
デバイスの形式に合わせてテンプレートのレイアウトを定義できます。テンプレートがページオーサリングと同じように動作するには、レスポンシブレイアウトを使用します。
レイアウトの変更は初期コンテンツモードには反映されますが、構造モードには反映されません。
必要なクライアントサイドライブラリを含むページポリシーは、ページ情報メニューの「ページポリシー」オプションの下に維持されます。
ページデザインダイアログにアクセスするには
テンプレートエディターのツールバーで「ページ情報」、「ページポリシー」と選択してダイアログを開きます。
ページポリシーダイアログが開いて、次の 2 つのセクションに分割されます。
テンプレートまたは結果ページのいずれかにコンテンツポリシーを適用できます。これにより、ページ上の主段落システムのコンテンツポリシーが定義されます。
ポリシーの選択ドロップダウンからページ用の既存のポリシーを選択できます。
新しいポリシーは、ポリシーの選択ドロップダウンの横にある追加ボタンを選択して追加できます。新しいタイトルを「ポリシーのタイトル」フィールドに入力します。
ポリシーの選択ドロップダウンで選択された既存のポリシーは、ドロップダウンの横にあるコピーボタンを使用して、新規ポリシーにコピーできます。新しいタイトルを「ポリシーのタイトル」フィールドに入力します。デフォルトで、コピーされたポリシーは「X のコピー」というタイトルになります。ここで X はコピーされたポリシーのタイトルです。
ポリシーのタイトルを「ポリシーのタイトル」フィールドで定義します。ポリシーにはタイトルを指定する必要がありますが、これはポリシーの選択ドロップダウンから簡単に選択できます。
ポリシーの説明は、「ポリシーの説明」フィールドにオプションで入力できます。
「他のテンプレートも選択したポリシーを使用しています」セクションでは、「ポリシーの選択」ドロップダウンで選択したポリシーを、他のどのテンプレートが使用しているかを簡単に確認できます。
ページのプロパティを使用し、「ページデザイン」ダイアログを使用して、必要なクライアントサイドライブラリを定義できます。これらのクライアントサイドライブラリには、テンプレートおよびそのテンプレートで作成されたページとともにロードされるスタイルシートおよび JavaScript が含まれます。
このテンプレートで作成されるページに対して適用するクライアントサイドライブラリを指定します。クライアント側ライブラリセクションのテキストフィールドにライブラリ名を入力します。
複数のライブラリが必要な場合は、「追加」ボタンをクリックして、ライブラリ名のために追加のテキストフィールドを追加します。
クライアントサイドライブラリで必要なだけいくつでも任意の数のテキストフィールドを追加します。
必要に応じて、ドラッグハンドルを使用してフィールドをドラッグすることで、ライブラリの相対位置を定義します。
テンプレート作成者は、テンプレートにページポリシーを指定できるますが、開発者から適切なクライアントサイドライブラリの詳細を得る必要があります。
「最初のページのプロパティ」オプションを使用して、結果ページの作成時に使用される最初のページプロパティを定義できます。
テンプレートエディターのツールバーで、ページ情報/最初のページのプロパティと選択してダイアログを開きます。
ダイアログで、このテンプレートで作成されるページに対して適用するプロパティを定義できます。
「完了」で定義を確認します。
新しいテンプレートを作成するときには、次の点を考慮してください。
テンプレートに対する変更がそのテンプレートを使用して作成されたページに及ぼす影響。
テンプレートに対して行うことができる各種操作と、その操作が結果ページに与える影響を次に示します。
構造の変更
コンテンツポリシーおよびデザイン設定の変更
初期コンテンツの変更
レイアウトに対する変更:変更されるコンポーネントが次のいずれであるかによって変わります。
以下の場合は特別に注意します。
有効化されたテンプレートでのコンポーネントのロックまたはロック解除
既存のページが既にそれを使用している可能性があるので、これにより副作用が起こる可能性があります。一般的に、以下のようになります。
ドラフトでなくなったテンプレートのコンポーネントのロック状態を変更すると、AEM は明示的に警告します。
サイト固有のテンプレートに独自のフォルダーを作成します。
テンプレートコンソールから独自のテンプレートを公開します。