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

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

ウィジェットページは、Liferay DXP 2026.Q3 以降非推奨となっており、今後のメジャーリリースで削除される予定です。コンテンツページはそれらの代替です。既存のウィジェットページは引き続き機能しますので、準備ができたら変換してください。

ウィジェットページをコンテンツページに直接変換することも、変換後のドラフトをプレビューして変更を加え、公開することもできます。

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

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

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

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

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

ネストされたアプリケーション: ネストされたアプリケーションは、変換時にレイアウトの同じ列に配置されます。最善を尽くした変換が完了した後、必要に応じてこれらのアプリケーションを再編成してください。

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

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

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

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

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

注記

ウィジェットページではポートレットは render-weight に従ってレンダリングされますが、コンテンツページではそうではありません。ポートレットはコンテンツページに表示される順序（左から右、上から下）でレンダリングされるため、コンテンツページ上の配置によっては、一部のポートレットのレンダリングが早かったり遅かったりする場合があります。

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

変換を完了するには、表示されるプロンプトで OK をクリックします。

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

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

スクリプトウィンドウにこのスクリプトを入力してください。その際、グループIDを必ずご自身のグループ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 // groupId を使用してください

long[] plids = bulkLayoutConverter.getConvertibleLayoutPlids(groupId)

out.println("変換前の変換可能なレイアウト:" + ArrayUtil.toStringArray(plids))

long[] convertedLayoutPlids = bulkLayoutConverter.convertLayouts(groupId)

out.println("変換済みレイアウト:" + ArrayUtil.toStringArray(convertedLayoutPlids))

plids = bulkLayoutConverter.getConvertibleLayoutPlids(groupId)

out.println("変換後の変換可能なレイアウト: " + ArrayUtil.toStringArray(plids))

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