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