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