IFrameクライアント拡張機能の使用
Liferay 7.4以降
IFrame クライアント拡張機能は、Liferay のフロントエンドインフラストラクチャを使用して、外部アプリケーションを <iframe> HTML 要素として登録します。それらはウィジェットとしてLiferayのページに追加されます。他のフロントエンドクライアント拡張機能とは異なり、IFrameは静的なリソースを提供しません。
サンプルワークスペースのクライアント拡張機能から始めましょう。
前提条件
クライアント拡張機能の開発を開始するには、
-
サポートされているバージョンのJavaをインストールしてください。
-
サンプルワークスペースをダウンロードして解凍してください。
curl -o com.liferay.sample.workspace-latest.zip https://repository.liferay.com/nexus/service/local/artifact/maven/content\?r\=liferay-public-releases\&g\=com.liferay.workspace\&a\=com.liferay.sample.workspace\&\v\=LATEST\&p\=zipunzip com.liferay.sample.workspace-latest.zip
これで、IFrameクライアント拡張機能をデプロイするためのツールが揃いました。
IFrameクライアント拡張機能を読み込むためのURLを指定してください。
client-extensions/liferay-sample-iframe-1/client-extension.yamlファイルは、サンプルワークスペース内の IFrame クライアント拡張プロジェクトを定義します。
liferay-sample-iframe-1-counter-app:
name: Counter App
type: iframe
url: https://arnab-datta.github.io/counter-app
このクライアント拡張機能のIDはliferay-sample-iframe-1で、IFrameクライアント拡張機能の主要な設定が含まれています。これには、IFrameとして取り込むアプリのname 、 type 、URLなどが含まれます。例のURLで実行されているカウンターアプリは、ショッピングカートに商品を追加することをシミュレートする基本的なReactアプリです。クライアント拡張機能をデプロイした後、他のウィジェットと同様に、Liferayのページにアプリを追加できます。
利用可能なプロパティの詳細については、 IFrame YAML設定リファレンスを参照してください。
IFrameクライアント拡張機能をデプロイする
クライアント拡張機能を Liferay SaaS にデプロイするには、Liferay Cloudコマンドラインツールを使用してlcp deploy実行します。
Liferay の新しいインスタンスを起動するには、次のコマンドを実行します。
docker run -it -m 8g -p 8080:8080 liferay/portal:7.4.3.132-ga132
http://localhost:8080で Liferay にサインインしてください。メールアドレスはtest@liferay.com 、パスワードはtest を使用してください。プロンプトが表示されたら、パスワードをlearnに変更してください。
次に、サンプルワークスペース内のクライアント拡張機能のフォルダーに移動して、
../../gradlew clean deploy -Ddeploy.docker.container.id=$(docker ps -lq)
これによりクライアント拡張機能がビルドされ、zipファイルがLiferayの/deployフォルダにデプロイされます。
ワークスペース内のすべてのクライアント拡張機能を同時にデプロイするには、 /client-extensionsフォルダーからコマンドを実行します。
Liferayインスタンスのコンソールでデプロイメントを確認します。
STARTED liferay-sample-iframe-1_1.0.0 [1592]
クライアント拡張機能がデプロイされたので、Liferayがそれを使用するように設定してください。
IFrameクライアント拡張機能をウィジェットとして追加する
iFrameはウィジェットとしてページに追加されます。
-
どのページの上部にもある「編集」 (
)をクリックしてください。 -
ウィジェットをページに追加します。コンポーネントサイドバー(
)で、ウィジェットをクリックします。 -
「クライアント拡張機能」→「カウンターアプリ」ウィジェットを見つけて、ページにドラッグします。「公開」をクリックしてください。

カウンターアプリが正しく動作していることを確認するために、いくつかアイテムを追加してみてください。