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

Liferayでコンテンツ管理システムのアセットを使用する

リリース機能 (LPD-17564) Liferay DXP 2026.Q1+

Liferayコンテンツ管理システム（CMS）は、複数のスペースにわたるコンテンツとアセットを保存、整理、管理します。その価値は、各機能ごとにコンテンツを複製するのではなく、Liferay全体で一貫して再利用できる点にある。

CMSフィールドをオブジェクトベースのマッピングをサポートするフラグメント要素にマッピングすることで、LiferayでCMSコンテンツを使用できます。このマッピングは、CMS スペースに保存されているテキスト、画像、ファイルをページ、フラグメント、コレクション、ナビゲーションメニュー、およびその他のサポートされている機能に表示し、プラットフォーム全体でコンテンツ配信の単一の情報源を作成します。

注

一部の旧式のコンポーネントやセレクターは依然として従来のアセットに依存しており、CMSオブジェクトとの互換性がありません。詳細については、現在の制限事項を参照してください。

以下の例では、「マーケティング」というスペースを作成し、そのアセットをLiferay全体に統合する手順を説明します。この手順に従って、独自のユースケースを実装してください。

前提条件

重要

リリース機能フラグを使用して、ヘッドレスCMSを有効化します。詳細については、 Liferay CMS の有効化を参照してください。

まず、スペースを作成し、CMS コンテンツを追加します。次に、そのスペースを、このコンテンツを掲載したいサイトに接続します。

また、表示ページテンプレートを作成し、それを CMS アセットに割り当てます。

スペースを作成

Liferay Liferay CMSに移動し、Marketingという名前のスペースを作成します。
基本的なウェブコンテンツを作成し、マーケティングスペースにファイルをアップロードします。この例では、Web コンテンツのタイトルとして Discover the Possibilities を、画像名として marketing-banner を使用します。
マーケティングスペースを、使用したいサイトに接続します。

スペースをサイトに接続すると、そのスペースのコンテンツ構造とアセットがそのサイト全体で利用可能になります。

表示ページテンプレートを作成する

CMSアセットは、表示ページテンプレートを使用して、個々のアセットが直接アクセスされたときにどのようにレンダリングされるかを定義します。これらのテンプレートは、コレクションやその他のナビゲーション要素からアセットをリンクする場合に必須です。

サイトメニュー () を開き、 デザイン → ページテンプレート をクリックします。
表示ページテンプレート タブをクリックし、新規をクリックします。
テンプレートに名前を入力し、コンテンツタイプとして 基本 Web コンテンツ を選択します。次に、保存をクリックします。
フラグメントとウィジェットのサイドバーで、 見出し フラグメントをページにドラッグします。
フラグメントをクリックすると、マッピングオプションが開きます。
「フィールド」で「 タイトル」を選択します。
段落フラグメントを見出しフラグメントの下にドラッグします。
フラグメントをクリックしてマッピングオプションを開き、[フィールド] の下で [ コンテンツ を選択します。
見出し フラグメントを選択し、右側のメニューで スタイル タブを開きます (1)。
パディングボトム (2) をクリックし、 スペーサー 4 (1.5 rem) (3) を選択します。
ディスプレイページテンプレートを公開する。
ページテンプレートアプリで、テンプレートのアクションをクリックし、デフォルトとして設定する選択します。

表示ページテンプレートが基本ウェブコンテンツに関連付けられ、そのアセットのデフォルト表示ページとして設定されました。

ページビルダーでCMSアセットを使用する

サイドパネルの「マッピング」タブを使用して、ページにLiferay CMSコンテンツを表示します。一部のフラグメントは、ソース選択の「直接」オプションに依存していますが、このオプションは従来のコンテンツとドキュメントおよびメディアアイテムのみをサポートしており、CMSアセットを読み取ることはできません。

ほとんどのフラグメントは標準的なマッピング機能を使用します。直接表示オプションとマッピングオプションの両方を含むフラグメントでは、フラグメント要素にCMSアセットとそのフィールドを表示するために、マッピングを選択してください。

Liferay CMSセレクターを使用したフラグメント

新しいページを作成するか、編集を開始する。
フラグメントとウィジェットのサイドバーで、 見出し フラグメント (1) を探します。それをページにドラッグアンドドロップします（2）。
フラグメントを2回クリックすると、マッピングオプション（3と4）にアクセスできます。
追加 () (3) をクリックし、左側のメニューで 基本ウェブコンテンツ (CMS) を選択し、 可能性の発見 基本ウェブコンテンツを選択します。

ヒント

カスタムコンテンツ構造に基づくものを含め、すべてのCMSアセットタイプがこのセレクターに表示されます。標準搭載のCMSアセットには、（CMS）ラベルが表示されます。
フィールド（4）で、 タイトルを選択します。

見出しフラグメントに、Liferay CMSのWebコンテンツのタイトルが表示されるようになりました。

フラグメントを、表示したいLiferay CMSアセットフィールドにマッピングします。

マッピングソース選択付きフラグメント

新しいページを作成するか、編集を開始する。
「フラグメントとウィジェット」サイドバーで、「画像」フラグメントを探してください。それをドラッグ＆ドロップして、見出しフラグメントの下のページに配置します。
フラグメントをダブルクリックすると、マッピングオプションにアクセスできます。
ソース選択で、 マッピング を選択します。
をクリックして を追加 () → アイテムを選択 をクリックします。左側のメニューで 基本ドキュメント (CMS) を選択し、 マーケティングバナー 画像を選択します。
画像ソースタブで、フィールドの下にある プレビュー URL を選択します。

これにより、ページに画像が表示されます。

サイドパネルの「マッピング」タブを使用して、ページにCMSコンテンツを表示します。

アセットを追加して、それらを他のフラグメントにマッピングしてみてください。

コレクションでCMSアセットを使用する

コレクションを使用して、Liferay CMS アセットをグループ化し、ページ間で再利用します。

CMS アセットはオブジェクトベースであるため、CMS コンテンツ構造を公開すると、対応するコレクションプロバイダーを通じてアセットが自動的に利用可能になります。

コレクションプロバイダーを使用する以外にも、動的なコレクションと手動のコレクションを作成して、CMS アセットのグループ化と表示方法をさらに制御できます。

コレクション表示フラグメントを使用して、ページ上にコレクション項目を表示したり、それをサポートするフラグメントでマッピングソースとしてコレクションを選択したりできます。詳細については、コレクションの表示を参照してください。

コレクションプロバイダー

Liferay CMSのアセットの場合、コンテンツ構造を公開するとコレクションプロバイダーが自動的に作成されます。各プロバイダーは、その構造から作成されたすべてのアセットをグループ化し、コレクションおよびコレクション表示フラグメントを構成する際に利用可能になります。

これにより、CMSアセットを表示する前にコレクションを定義する手順が不要になります。追加のフィルタリング、並べ替え、またはアイテム選択が必要な場合にのみ、動的コレクションまたは手動コレクションを使用してください。

動的コレクション

動的コレクションは、ユーザーが定義した条件に基づいてアイテムを自動的に取得します。詳細については、コレクションの表示およびオブジェクトエントリの表示を参照してください。

コレクションを作成し、動的コレクションタイプを選択します。
「アイテムタイプ」で、アセットのコンテンツ構造を選択します（カスタム構造も含まれます）。標準搭載のコンテンツ構造には、基本ドキュメント、基本ウェブコンテンツ、ブログ、外部ビデオなどがあります。
スコープの下で、 をクリックし、 → その他のサイト、アセットライブラリ、またはスペース… を選択します。
スペース タブを開き、CMS アセットが含まれているスペースを選択します。

オプションの下にある () をクリックすると、スコープを削除できます。
フィルターと並べ替え機能を使用して、条件を定義します。コレクションは、一致するアイテムが追加されると自動的に更新されます。

ヒント

複数のアイテムタイプの下にある 複数選択 オプションは、手動または動的なコレクションに複数のアセットタイプを追加します。詳細については、コレクションの作成を参照してください。

手動コレクション

手動コレクションの場合、含めるアセットを選択します。

コレクションを作成し、手動コレクションタイプを選択します。
「アイテムタイプ」で、アセットのコンテンツ構造を選択します（カスタム構造も含まれます）。標準搭載のコンテンツ構造には、基本ドキュメント、基本ウェブコンテンツ、ブログ、外部ビデオなどがあります。
をクリックし、コレクションアイテムの横にある を選択して、アイテムの種類を1つ選択します。
セレクターで、パンくずリストを使用して サイトとライブラリ に移動します。
スペース タブを開き、CMS アセットが含まれているスペースを選択します。
含める項目を選択し、追加をクリックします。

次に、コレクション表示フラグメントをページに追加し、作成したコレクションのいずれかにマッピングして、コレクションをテストします。

コレクション表示フラグメントと表示ページの使用

Liferay CMSアセットのコレクションを表示するには、コレクション表示フラグメントで各アセットのフィールドをマッピングし、各アイテムを表示ページにリンクさせます。この設定では、アセットの一覧が表示され、ユーザーがアイテムを選択すると表示ページにリダイレクトされます。

新しいページを作成するか、編集を開始する。
フラグメントとウィジェットのサイドバーで、 コレクション表示 フラグメントを探します。それをページにドラッグ＆ドロップしてください。
をクリックしてコレクション を選択し、CMSアセットのコレクションを選択します。
見出し フラグメントをコレクション表示の上部領域にドラッグします。

注

2025年第2四半期以前は、フラグメントを任意のアイテムにドロップすることができ、そのフラグメントはすべてのアイテムに複製されていました。 2025年第2四半期以降、破片は最上部のドロップゾーンにのみドロップされ、システムは他のアイテム用にそれらを複製します。この違いは、この例には影響しません。
最初の 見出し例 をクリックして、マッピングオプションを開きます。
「フィールド」で「 タイトル」を選択します。
リンク タブを開きます。フィールドで、前提条件で作成したディスプレイページテンプレートを選択します。

ヒント

最初のコレクション項目を選択し、リストの読みやすさを向上させるために、下部のパディングとして スペーサー 3 (1rem) を追加します。
［Publish（公開）］をクリックします。

ページにアクセスして、タイトルをクリックしてください。表示ページテンプレートが開き、アセットのタイトルとコンテンツが表示されます。

全体的な表示を改善するには、ページ上のコレクション表示フラグメントと表示ページテンプレートの両方をカスタマイズしてください。ボタン、見出し、段落などのフラグメントを使用して、リスト内での項目の表示方法や、個々のアセットがそれぞれの表示ページでどのようにレンダリングされるかを制御できます。

リストからタイトルを選択すると、そのアセットの表示ページが開きます。

Liferay CMSのアセットをナビゲーションメニューに追加できます。

各アセットを表示ページテンプレートに関連付けることで、メニュー項目がアセットの表示ページを開くようにします。
ナビゲーションメニューを作成します。
をクリックして を追加し、アセットのコンテンツ構造（カスタム構造を含む）を選択します。標準搭載のコンテンツ構造には、基本ドキュメント、基本ウェブコンテンツ、ブログ、外部ビデオなどがあります。
追加するアセットを選択してください。

そのアセットはナビゲーションメニュー項目として表示されます。

LiferayでCMSアセットを使用する際の現在の制限事項

Liferay CMSのコンテンツとファイルはオブジェクトベースであるため、Liferayでそれらを使用するには、以前の世代のアイテムセレクターから直接アイテムを選択するのではなく、フィールドマッピングに依存します。以下の制限事項に留意してください。

一部のフラグメントは Liferay CMS アセットをサポートしていません。
Webコンテンツ表示フラグメントとドキュメント表示フラグメントは、従来のアセットでのみ機能し、CMSアセットを表示することはできません。

注

一部のフラグメントでは、アイテムセレクターに スペース タブが表示される場合があります。このタブは必ずしもLiferay CMSのコンテンツ選択と連動しているとは限らないため、CMSのアイテムが表示されない場合があります。