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

マーケットプレイスフラグメントをページに追加する

Liferay DXP 2025.Q3+

Liferay Marketplaceでは、ページエディターにシームレスに統合できるさまざまなアプリとフラグメントを提供しています。 これらのマーケットプレイスフラグメントにアクセス、設定、使用することで、コンテンツページに機能を追加し、動的で機能豊富なページを作成できます。

Liferay DXPに接続されたマーケットプレイスエクスプローラーでは、無料のフラグメントのみが利用可能です。

マーケットプレイスの設定

この機能は 2025年第1四半期 (LPD-35941) に リリースされ、 2025年第3四半期 に一般提供されました。

  1. ページエディタでマーケットプレイスのフラグメントを使用する前に、Liferay DXP と Marketplace 間の接続を 設定する必要があります

ページエディタおよびフラグメントアプリケーションでマーケットプレイスのフラグメントを使用するには、Liferay DXPをマーケットプレイスに接続します。

マーケットプレイスからフラグメントをインストールするには、ユーザーは管理者権限を持っている必要があります。

マーケットプレイスフラグメントをフラグメントアプリケーションまたはページエディターに追加する。

接続が確立されたら、マーケットプレイスのフラグメントをフラグメントアプリケーションまたはページエディターに追加します。

  1. フラグメントアプリケーションまたはページエディターを開きます。

    Fragments アプリケーションにアクセスするには、 サイト メニュー (Product Menuを開き、 デザインを展開し、 Fragments に移動します。

    ページ・エディターを使って既存のページを編集したり、新しいページを作成するには、サイト・メニュー(Product Menu)を開き、サイト・ビルダーを展開し、ページに進みます。

  2. マーケットプレイスエクスプローラーを開く (Marketplace icon) をクリックすると、 マーケットプレイスから追加 モーダルで利用可能なフラグメントとフラグメントセットが表示されます。

    Fragments アプリケーションでは、ボタンは「フラグメント セットの追加 (1)」の隣にあります。 ページエディターでは、コンポーネントタブの検索バーの横にあります(2)。

    マーケットプレイスエクスプローラーにアクセスして、利用可能なフラグメントを確認してください。

  3. (オプション) フラグメントのカード をクリックすると、開発者名、公開日、サポートされているサービスなどの詳細が表示されます。

    フラグメントのカードをクリックすると、そのフラグメントに関する詳細情報が表示されます。

    左上隅の リストに戻る をクリックすると、マーケットプレイスから追加するモーダルに戻ります。

  4. をクリックしてをインストールします。

    単一のフラグメントをインストールする場合、保存場所を選択してください。

    • 既存のセットを使用するには、 フラグメントセット リストから1つを選択します。
    • 新しいセットを作成するには、 新しいセットに保存 をクリックします。 (フラグメントセットがまだ存在しない場合は、新規セット作成フォームが自動的に開きます。) 名前 フィールドで、デフォルト (無題のセット) を受け入れるか、セットの新しい名前を入力し、必要に応じて説明を追加して、 保存 をクリックします。

    フラグメントセットをインストールすると、そのセットには独自のコレクションメタデータが含まれているため、インストール先を指定することなくすぐにインストールが開始されます。

  5. インストール後、フラグメントはフラグメントアプリケーションのフラグメントセットリスト(1)またはページエディターのコンポーネントタブ(2)で選択されたセットに表示されます。

    マーケットプレイスの断片には、マーケットプレイスのアイコン(Marketplace icon)が付いています。 他のフラグメントと同様に名前を変更できますが、コードと設定はマーケットプレイスによって管理され、新しいバージョンが公開された場合にのみ更新されます。

    インストールされたフラグメント/フラグメントセットは、フラグメントアプリケーションまたはページエディタに追加されます。

  6. (オプション)ページエディターで、マーケットプレイスアイコンの横にあるコンポーネントオプション Components Option icon)をクリックすると、セットの順序を変更したり、リストとカードの表示モードを切り替えたりできます。

    「セットの並べ替え」オプションをクリックすると、新しいモーダルウィンドウが開き、そこでセットをドラッグ&ドロップして順序を調整できます。 変更を適用するには、 をクリックして保存 をクリックしてください。

    コンポーネントオプションを使用して、フラグメントセットの順序を変更したり、表示モードを切り替えたりできます。

マーケットプレイスのフラグメントを検索中

ページエディタの「コンポーネント」タブにある検索バーを使用して、インストールされているフラグメントとウィジェットを検索してください。 マーケットプレイスのフラグメントまで検索範囲を広げるには、検索語を入力し、タブの下部にある マーケットプレイスの結果を表示 をクリックします。 一致するマーケットプレイスのフラグメントとフラグメントセットが結果に表示されます。

検索バーを使用して、マーケットプレイスのフラグメントだけでなく、フラグメントやウィジェットも検索できます。

マーケットプレイスフラグメントの再インストール

Liferay DXP 2026.Q2+

フラグメントまたはフラグメントセットが既にインストールされていて、マーケットプレイスから再度インストールする場合、 既存アイテムの管理 ダイアログが表示されます。 各競合の処理方法を選択し、 保存 をクリックしてください。

  • 既存のアイテムを追加しない: 既にインストールされているアイテムをスキップします。 既にローカルで名前を変更したり整理したりしていて、変更したくないアイテム を除くすべての を更新したい場合は、このオプションを使用してください。

  • 既存のアイテムを上書きします: インストール済みのコピーを、アップデートを含むマーケットプレイスのバージョンに置き換えます。 このオプションを使用すると、マーケットプレイスで公開されている最新バージョンを入手できます。

  • 両方保持: 新しいコピーを既存のコピーの横に追加し、複製の名前に番号を追加します。 このオプションを使用すると、複数のバージョンを並べて比較できます。

ZIPファイルからフラグメントをインポートする際にも同じダイアログが表示されるため、インストール、再インストール、インポートのフローは一貫した体験を共有することができます。

マーケットプレイスフラグメントを含むフラグメントセットのエクスポート

Liferay DXP 2026.Q2+

マーケットプレイスのフラグメントは、マーケットプレイスが公式の提供元であるため、エクスポートすることはできません。ZIPファイルで共有するのではなく、マーケットプレイスからダウンロードする必要があります。 Export アクションには 3 つの結果があります。

  • マーケットプレイスのフラグメントとカスタムフラグメントまたはインポートされたフラグメントを組み合わせたフラグメントセットをエクスポートできます。 マーケットプレイスの断片はスキップされ、エクスポートされるZIPファイルにはエクスポート可能なアイテムのみが含まれます。

  • Marketplace フラグメントのみ (または React タイプのフラグメントのみ) を含むフラグメント セットには、アクション メニューに エクスポート アクションがなく、個々の Marketplace フラグメント カードにも行レベルの エクスポート アクションがありません。

  • ツールバーの一括 エクスポート アクションは引き続き使用できますが、マーケットプレイスと React フラグメントは、結果として生成される ZIP からサイレントにスキップされます。 選択範囲にマーケットプレイスのフラグメントのみが含まれている場合、生成されるZIPファイルは空になります。