ウィジェットページをコンテントページに変換する

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

以前のバージョンでは、ウィジェットページはカスタムレイアウトやカスタマイズ可能な列などの独自の機能を提供していました。これらの独自の機能の多くは、7.3 以降ではコンテンツページで利用できるため、通常はコンテンツページを作成することをお勧めします。

以前のバージョンから Liferay Portal 7.3 または 7.4 にアップグレードし、既存のウィジェットページを移行する場合は、それらをコンテンツページに変換できます。ウィジェットページをすぐにコンテンツページに変換することも、変換をプレビューして変更を加えてからページを変換することもできます。

変換するページが複数ある場合は、サイト管理を通じて一括変換することも、利用可能な API と組み込みのスクリプトエディターを使用してすべてのウィジェットページを一度に変換することもできます。ここでは、すべてのアプローチについて説明します。

ウィジェットページを変換する前に変換ドラフトをプレビューするには、次の手順に従います。

サイトメニュー () を開き、 サイトビルダー → ページに移動します。
目的のウィジェットページの横にある アクション () を開き、 コンテンツページに変換…を選択します。
警告を確認し、変換下書きに必要な調整を行います。この時点で、必要なフラグメントを下書きに追加することもできます。
プレビュー下書きを公開するには、 「公開」 をクリックします。ウィジェットページを元の状態にリセットするには、 「変換下書きを破棄」 をクリックします。警告がある場合は、以下で説明するように、ベストエフォートの変換が完了します。

ベストエフォートコンバージョン

ウィジェットページの一部の機能はコンテンツページでサポートされていないため、そのままでは変換できません。これらの場合、ユーザーには問題が警告され、ベストエフォートの変換が処理されます。次のウィジェットページ機能はサポートされていません:

入れ子になったアプリケーション： 入れ子になったアプリケーションは、変換中にレイアウトの同じ列に配置されます。ベストエフォートの変換が完了したら、必要に応じてこれらのアプリケーションを再編成します。

カスタマイズ可能なセクション: ページがカスタマイズ可能である場合、ユーザーが行ったカスタマイズは変換中に失われます。

カスタムページレイアウト： レイアウトを変換できる場合、レイアウトの構造が保持され、ユーザーに警告が表示され、処理する前に変換下書きを確認する機会が与えられます。レイアウトを変換できない場合、すべてのウィジェットは単一の行と列に配置されるため、ページの変換後に手動で再編成する必要があります。

カスタムレイアウトテンプレートが変換可能であることが既に確認されている場合は、レイアウトテンプレートのレイアウトテンプレート変換の警告を無効にして、レイアウトを使用するウィジェットページを変換するたびに警告が表示されないようにすることができます。

グローバルメニュー () を開き、 コントロールパネル → 構成 → システム設定に移動します。

「コンテンツとデータ」の下の ページ を選択し、 ウィジェットページからコンテンツページへのコンバーターに移動して、レイアウトテンプレート ID を検証済みレイアウトテンプレート ID のリストに追加します。

注

ポートレットはウィジェットページではレンダリングウェイトに従ってレンダリングされますが、コンテンツページではそうではありません。ポートレットは、コンテンツページのページに表示される順序 (つまり、左から右、上から下) でレンダリングされるため、コンテンツページ上の配置に応じて、一部のポートレットが早くレンダリングされたり遅くレンダリングされたりすることがあります。

サイトメニュー () を開き、 サイトビルダー → ページに移動します。
ウィジェットページまたは複数のウィジェットページのボックスをチェックします。管理ツールバーの アクション () をクリックし、 コンテンツページに変換 オプションを選択します。

表示されたプロンプトで ［OK］ をクリックして変換を完了します。

組み込みのスクリプトエディターを使用して、サイト上のすべてのウィジェットページをコンテンツページに一括変換できます。

グローバルメニュー () を開き、 コントロールパネル → システム → サーバー管理 → スクリプトに移動します。

スクリプトウィンドウにこのスクリプトを入力します。必ず、グループIDを自分のものに置き換えてください。 Groovy スクリプトは、 BulkLayoutConverter インターフェースを使用して、指定されたグループ ID を持つすべてのウィジェットページをコンテンツページに変換します。

import com.liferay.layout.util.BulkLayoutConverter
import com.liferay.portal.kernel.util.ArrayUtil
import org.osgi.framework.ServiceReference
import org.osgi.framework.BundleContext
import com.liferay.portal.kernel.module.util.SystemBundleUtil
import org.osgi.framework.BundleContext

BundleContext bundleContext = SystemBundleUtil.getBundleContext();

ServiceReference serviceReference = bundleContext.getServiceReference(BulkLayoutConverter.class.getName());

BulkLayoutConverter bulkLayoutConverter = bundleContext.getService(serviceReference);

long groupId = 20118L // Use your groupId

long[] plids = bulkLayoutConverter.getConvertibleLayoutPlids(groupId)

out.println("Convertible layouts before conversion:" + ArrayUtil.toStringArray(plids))

long[] convertedLayoutPlids = bulkLayoutConverter.convertLayouts(groupId)

out.println("Converted layouts:" + ArrayUtil.toStringArray(convertedLayoutPlids))

plids = bulkLayoutConverter.getConvertibleLayoutPlids(groupId)

out.println("Convertible layouts after conversion: " + ArrayUtil.toStringArray(plids))

スクリプトを実行するには、実行をクリックします。
出力は以下のスニペットのようになり、変換可能なレイアウト（ページ）が残っていないことが示されます。
```
Convertible layouts before conversion:[25, 26, 27]
Converted layouts:[25, 26, 27]
Convertible layouts after conversion: []
```