ウィジェットのスコープを設定する
スコープ設定は、Liferay DXP 2024.Q4/Portal GA129 の時点で 非推奨 となっており、将来のリリースで削除される予定です。
デフォルトでは、Liferay のページ ウィジェットはサイトごとに スコープ されます。つまり、サイト内のすべてのウィジェット インスタンスは同じデータを共有し、同じコンテンツを表示します。 たとえば、同じサイト内の 2 つのページにメッセージ ボード ウィジェットを追加すると、同じデータを使用する 2 つのインスタンスが作成されます。 ただし、ウィジェットを 2 つの異なるサイトに追加すると、異なるデータを持つ 2 つの独立したインスタンスが作成されます。
ウィジェット インスタンスのスコープを個々のページに設定して、各ウィジェットに独自のデータを持たせることもできます。
Liferay は、ページ ウィジェットに 3 つのスコープ オプションを提供します。
| スコープ | Description |
|---|---|
| デフォルト | ウィジェット データを現在のサイトに限定します。 |
| グローバル | ウィジェット データをグローバル サイトに限定し、コンテンツ管理をグローバル サイトに制限します。 |
| ページ | ウィジェット データを特定のページに限定します。 このスコープは、作成されると、異なるページであっても、異なるウィジェット間で使用できるようになります。 |
ウィジェットのスコープを設定するには、
-
ウィジェット ヘッダーの オプション (
) → 構成をクリックし、スコープ タブを選択します。注Liferay DXP 2025.Q1/Portal GA132 より前では、設定オプションはウィジェットの右上隅に表示されていました。
-
ドロップダウン メニューを使用してスコープを選択します。
このメニューには現在のサイト (Liferay DXP など) が含まれます。 現在のサイトとは、デフォルトのスコープ、グローバル サイト、現在のページ、およびサイト内で使用可能なその他のページ スコープを指します。
現在のページにスコープを作成していない場合、その名前の後に
(Create New)(例: Home (Create New)) が付きます。![[Scope]タブで、ドロップダウンメニューからスコープを選択します。](https://resources.learn.liferay.com/images/dxp/latest/en/sites/creating-pages/page-fragments-and-widgets/using-widgets/configuring-widgets/setting-widget-scopes/images/01.png)
-
[保存]をクリックします。
新しいウィジェット スコープを作成すると、サイト メニュー (
) のコンテンツ & データの下にスコープ構成ボタン (
) が表示されます。 これを使用して、デフォルトのスコープまたは使用可能なページ スコープを管理できます。
![[Content & Data]のスコープ設定ボタンを使用して、コンテンツを管理するスコープを決定します。](https://resources.learn.liferay.com/images/dxp/latest/en/sites/creating-pages/page-fragments-and-widgets/using-widgets/configuring-widgets/setting-widget-scopes/images/02.png)
スコープを削除できるのは、関連付けられているページを削除する場合のみです。