ご覧のページは、お客様の利便性のために一部機械翻訳されています。また、ドキュメントは頻繁に更新が加えられており、翻訳は未完成の部分が含まれることをご了承ください。最新情報は都度公開されておりますため、必ず英語版をご参照ください。翻訳に問題がある場合は、こちらまでご連絡ください。

情報テンプレートの使用

7.4以降で利用可能

情報テンプレートを使用すると、情報フレームワークを実装する任意のアイテムタイプに対して FreeMarker テンプレートを作成できます。サポートされているアイテムの種類には、Web コンテンツ、ドキュメント、アセット、ブログ、カテゴリ、オブジェクトなどがあります。作成後、フラグメントフィールドをテンプレートにマップして、アイテムがコンテンツ内でどのようにレンダリングされ、ページが表示されるかを決定できます。これにより、サイトに一貫したスタイルを実装できるようになります。

重要

情報テンプレートはウィジェットではなくフラグメントでのみ使用できます。ウィジェットに表示される Web コンテンツ用の FreeMarker テンプレートを設計するには、 Web コンテンツテンプレートを使用します。テンプレート間の違いについて詳しくは、「テンプレートの選択」をお読みください。

情報テンプレートの作成

サイトメニュー () を開き、 デザインを展開して、 テンプレート → 情報テンプレートに移動します。
新規をクリックし、名前を入力し、 アイテムタイプを選択して、 (該当する場合) アイテムサブタイプを選択します。
[保存]をクリックします。これにより、テンプレートデザインページにリダイレクトされます。
(オプション) 既存の FreeMarker スクリプトを .ftl ファイルからインポートします。
FreeMarker を使用してテンプレートをデザインします。

オートコンプリート機能を使用するには、エディターに ${ と入力します。

要素サイドパネル () では、選択したアイテムタイプの構造から使用可能なフィールドにすばやくアクセスできます。

注

要素サイドパネルには、テンプレート (ジャーナル記事テンプレート、情報テンプレートなど) に基づくフィールドは含まれません。これは無限ループを防ぐためです。
(オプション) プロパティサイドパネル () で、テンプレートに説明または画像を追加します。
完了したら、 「保存」 をクリックします。

作成された情報テンプレートは、コンテンツ表示フラグメントや、テキストやリッチテキストなどのマッピング可能なサブ要素を持つその他のフラグメントで使用できます。選択すると、コンテンツページおよび表示ページテンプレートでアイテムがどのようにレンダリングされるかが決まります。

Liferay の Headless API サービスは、テンプレートエディターで restClient オブジェクトを通じて利用できます。使用方法の詳細については、テンプレートエディターでのヘッドレス API の呼び出しを参照してください。

スクリプトのインポートとエクスポート

情報テンプレートを編集するときに、FreeMarker スクリプトをインポートおよびエクスポートして、他のコンテキストで再利用できます。

サイトメニュー () を開き、 デザインを展開して、 テンプレート → 情報テンプレートに移動します。
必要な情報テンプレートを選択します。
アプリケーションバーで [アクション] をクリックし、 [スクリプトのエクスポート] または [スクリプトのインポート]を選択します。

エクスポートすると、現在の FreeMarker スクリプトが script.ftl ファイルとして保存されます。

インポートすると、選択したファイルによってテンプレートの現在の FreeMarker スクリプトが置き換えられます。

情報テンプレートの管理

テンプレートアプリケーションでは、既存のすべての情報テンプレートを表示および管理できます。既存の各テンプレートは、そのタイプ (例: Web コンテンツ記事) とサブタイプ (例: 基本 Web コンテンツ) とともに表示されます。テンプレートの アクション () をクリックすると、次のアクションにアクセスできます。

操作	Description
編集する	テンプレートを編集します。
コピー	選択したテンプレートのコンテンツを使用して新しいテンプレートを作成します。
権限の設定	テンプレートの基本的な権限を管理します。
削除	テンプレートを削除します。