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

テーマのお気に入りアイコンクライアント拡張の使用

Liferay DXP 7.4+

テーマのお気に入りアイコンクライアント拡張を使えば、選択したページでテーマのお気に入りアイコンを上書きすることができます。クライアント拡張機能をビルドしてデプロイするには、サンプルワークスペースから始めます。

前提条件

クライアント拡張の開発を開始するには、

サポートされているバージョンの Java をインストールしてください。

注

サポートされているJDK、データベース、環境については、互換性マトリックスを確認してください。推奨される JVM 設定については、 JVM 構成を参照してください。

サンプルワークスペースをダウンロードし、解凍します。

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\=zip

unzip com.liferay.sample.workspace-latest.zip

これで、最初のテーマのお気に入りアイコンクライアント拡張をデプロイするためのツールがそろいました。

クライアント拡張の検討

テーマのお気に入りアイコンクライアント拡張は、サンプルワークスペースの client-extensions/sample-global-css/ フォルダにあります。 client-extension.yaml ファイルに定義されています。

liferay-sample-theme-favicon:
   name: Liferay Sample Theme Favicon
   type: themeFavicon
   url: favicon.ico

このクライアント拡張は、IDが liferay-sample-theme-faviconで、タイプや追加するお気に入りアイコンファイルなど、テーマのお気に入りアイコンクライアント拡張の主要な設定項目が含まれています。利用可能なプロパティの詳細については、テーマファビコンYAML設定リファレンスを参照してください。

また、以下のassemble YAMLブロックも含まれています。

assemble:
   - from: assets
   into: static

これは、 assets/ フォルダ内のすべてを、ビルドされたクライアント拡張.zip ファイルに静的リソースとして含めることを指定します。テーマのお気に入りアイコンクライアント拡張のお気に入りアイコンファイルは、Liferayの静的リソースとして使用されます。

Liferayにクライアント拡張をデプロイする

新しい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に変更します。

Liferayが起動したら、サンプルワークスペース内のクライアント拡張機能のフォルダから以下のコマンドを実行してください。

../../gradlew clean deploy -Ddeploy.docker.container.id=$(docker ps -lq)

これにより、クライアント拡張が構築され、Liferayのdeploy/フォルダにzipをデプロイします。

注

クライアント拡張機能を Liferay SaaS にデプロイするには、Liferay Cloud コマンドラインツールを使用して lcp deploy を実行します。

ヒント

ワークスペース内のすべてのクライアント拡張機能を同時にデプロイするには、 client-extensions/ フォルダーからコマンドを実行します。

Liferayインスタンスのコンソールでデプロイメントを確認します。

STARTED liferay-sample-theme-favicon_1.0.0

ページでクライアント拡張を使用する

デプロイされたクライアント拡張を使用するために、Liferayのページを設定します。

ページ上で、上部の編集 () をクリックします。
サイドバーで、[ページデザインオプション] メニュー () に移動し、メニュー上部の設定 () をクリックします。
ファビコン セクションの ルックアンドフィール タブで、 ファビコンの変更 をクリックします。
［クライアント拡張］をクリックし、新しくデプロイしたお気に入りアイコン、［サンプルテーマのお気に入りアイコン］を選択します。
下にスクロールして、［保存］をクリックします。
ページに戻ります。新しいお気に入りアイコンがブラウザのタブに表示されます。

さいごに

Liferayでテーマのお気に入りアイコンクライアント拡張を使用できるようになりました。次は他のクライアント拡張タイプのデプロイメントを試してみましょう。

テーマのお気に入りアイコンYAML設定リファレンス