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

アセットパブリッシャーウィジェットを使用したアセットの表示

Web コンテンツを作成するときは、コンテンツはメッセージ ボードのエントリやブログの投稿などの資産であることを忘れないでください。 最も一般的なアセットの種類は、 Web コンテンツです。 Asset Publisher ウィジェットは、デフォルトで次のアセット タイプをサポートします。

  • ブログのエントリ
  • ブックマークエントリー
  • ブックマークフォルダー
  • カレンダー
  • 基本ドキュメント
  • Google ドライブのショートカット
  • ドキュメントとメディアフォルダー
  • 動的データリスト(DDL)・レコード
  • ナレッジベースの記事
  • 掲示板のメッセージ
  • 基本Webコンテンツ
  • Webコンテンツフォルダー
  • Wikiページ

Liferay DXP 7.2以降、開発者は 情報フレームワーク を使用して 情報リストからアセットを表示できます。

必要なアセットを表示するように Asset Publisher を構成する最も簡単な方法は、 コレクションを使用することです。 アセットが手動で割り当てられるか動的に割り当てられるかに関係なく、Asset Publisher ウィジェットは、コレクションで定義された順序でアセットを自動的にロードします。 Liferay DXP 7.4 U10+ または GA14 では、アセットパブリッシャーはデフォルトでコレクション設定を使用します。

警告

Asset Publisher はインスタンス スコープのオブジェクトを表示できません。

アセットパブリッシャーウィジェットでのアセットの選択

Liferay DXP 2024.Q4/Portal GA129以降、Asset Publisherウィジェットの 動的 および 手動 アセット選択オプションは 非推奨 となり、 非推奨機能フラグ の背後に隠されています (LPD-39304)。 これらのオプションを使用するには、機能フラグを有効にするか、コレクションからアセットのみを選択します。

Asset Publisher ウィジェットを設定して、 コレクションからのアセットを表示できます。

ヒント

Liferay 7.2 以前では、コレクションは コンテンツセットと呼ばれます。

  1. 新しいページを作成 または 既存のページを編集

  2. ページの編集中に、ページ エディターの左側にある [フラグメントとウィジェット] タブを確認し、 Asset Publisher ウィジェットを検索します。

  3. Asset Publisher ウィジェットを編集領域にドラッグ アンド ドロップします。

  4. ウィジェット ヘッダーの オプション (Widget Options icon) → 構成をクリックします。

    「アクション」をクリックして、Asset Publisher の構成オプションにアクセスします。

    Liferay DXP 2025.Q1/Portal GA132 より前では、設定オプションはウィジェットの右上隅に表示されていました。

  5. アセット選択で、ウィジェットに表示するコレクションを選択します。

  6. 表示設定で、コンテンツの表示方法を設定します。

  7. サブスクリプションで、電子メールのサブスクリプションと RSS フィードのサブスクリプションを構成します。

  8. アセットを選択してウィジェットを設定したら、 [保存]をクリックします。

アセット パブリッシャーの権限を設定することはできますが、どのロールに 追加 アイコンが表示されるかを直接制御することはできません。 このレベルの権限を実現するには、カスタマイズが必要です。

ページの削除とフレンドリー URL への影響

Liferay DXP の Web コンテンツ には、次の 2 つの一般的な形式のフレンドリ URL を設定できます。

  1. Asset Publisher ウィジェットを含むページは /–/ URL を生成します。

    /–/ URL は、デフォルトの Asset Publisher ウィジェットを持つ特定のページに依存します。 そのページを削除すると、関連付けられている Web コンテンツのすべての /–/ URL が壊れます。 自動フォールバックは存在しません。

  2. ページ テンプレートを表示 /w/ URL を生成します。

    /w/ URL は表示ページ テンプレートに依存しており、ページからは独立しています。 ページを削除しても /w/ URL には影響しません。

/–/ URL は Asset Publisher ウィジェットを含むページに依存しているため、URL が壊れないように次のベスト プラクティスに従ってください。

  • 新しいコンテンツには表示ページ テンプレートを優先します。
  • /–/ URL が必要な場合を除き、Asset Publisher ウィジェットを含むページは避けてください。
  • ページを誤って削除した場合は、ページを再作成して再割り当てし、 /–/ URL を復元します。

データ取得方法

アセット パブリッシャー ウィジェットは、以前に保存したコレクションまたはコレクション プロバイダーからアセットを選択します。 コレクションの詳細については、「 コレクションとコレクション ページについて」を参照してください。

  1. [Select Collection]で、[選択]をクリックします。

  2. コレクション または コレクション プロバイダー タブのいずれかを選択します。

  3. 既存のコレクションまたはコレクションプロバイダーのいずれかを選択します。

  4. [保存]をクリックします。

「選択」をクリックして、保存したコレクションから選択します。

開発者は、コレクションプロバイダーを使用して、より高度な基準を持つ特定のコレクションを作成することができます。 詳細については、 情報フレームワーク 開発者向けドキュメントの 情報リスト プロバイダーの作成 に関する情報をお読みください。

動的

Liferay Liferay DXP 2024.Q4/Portal GA129 以降で廃止

選択した基準に基づいて、アセット パブリッシャー ウィジェットにアセットが自動的に含められます。

ソース、スコープ、フィルター、順序など、動的アセット コレクションのオプションを定義します。

  1. [スコープ] セクションで、個々のサイトまたは他のサイトのアセットを表示するように選択します。

  2. [ソース] セクションで、[アセット タイプ] ドロップダウン メニューを使用してアセットを選択します。 特定のアセット タイプを選択するか、 複数選択 してさまざまなタイプから選択します。

    一部のオプション (Web コンテンツ記事やドキュメントなど) では、サブタイプ (Web コンテンツ記事の構造やドキュメント タイプなど) を選択する必要があります。 任意のサブタイプを選択することも、複数のサブタイプを選択することもできます。

  3. フィルター セクションで、アセット パブリッシャー ウィジェット内のアセットのルールを定義します。 カテゴリタグ、またはキーワードに基づいてルールを定義できます。

    次のカテゴリ、キーワード、またはタグのすべてまたはいずれかを含む/含まないなどの項目のフィルターを選択して、カテゴリ、キーワード、またはタグを指定できます。

  4. Liferay DXP 2024.Q1+/Portal GA112+より前では、カスタムユーザー属性を定義している場合はそれを含めます。

    アセットは、含まれているカスタム ユーザー プロファイル属性と一致する場合にのみ表示されます。

    Asset Publisher ウィジェット内のカスタムユーザー属性オプションは、 Liferay DXP 2024.Q1+/Portal GA112+以降は非推奨となります。 代わりに、 エクスペリエンスを使用してコンテンツを動的に表示するを試してください。

  5. 「順序付け」セクションで、アセット パブリッシャー ウィジェット内のアセットの表示順序を選択します。

    資産を並べ替えるためのプライマリ フィールドとセカンダリ フィールドを選択します。 アセットを昇順または降順で並べることもできます。

    警告

    アセット タイプとして Web コンテンツ記事を選択し、ローカライズされた Web コンテンツ構造フィールドで並べ替える場合、サイトに他の言語を適用すると、すべてのアセットのフィールド値がローカライズされる必要があります。 別の言語が適用された場合は、翻訳されたアセットのみが注文されます。

  6. (オプション) この構成からコレクションを作成をクリックし、タイトルを入力して 保存 をクリックし、構成を新しい コレクションとして保存します。

手動

Liferay DXP 2024.Q4/Portal GA129 以降で廃止

パラメータを設定し、特定のアセットを手動でフィルタリングします。

  1. [スコープ] セクションで、個々のサイトまたは他のサイトのアセットを表示するように選択します。

  2. [アセットエントリー]セクションで、[選択]ボタンを使用して特定のタイプのアセットをフィルタリングします。

    重要

    承認済みまたはスケジュールされた Web コンテンツのみを選択します。

    アセット自体はリストから選択できますが、ページが公開されるとこの選択は破棄されます。

  3. 選択するアセットのタイプについて、含めるアセットにチェックを入れます。

    基本的なウェブコンテンツをフィルタリングし、手動でアイテムを選択する例を示します。

  4. 追加をクリックします。

  5. (オプション) この構成からコレクションを作成をクリックし、タイトルを入力して 保存 をクリックし、構成を新しい コレクションとして保存します。

エクスペリエンスを使用してコンテンツを動的に表示する

Asset Publisher ウィジェットでコンテンツを表示する準備ができたら、各グループの Asset Publisher ウィジェットに表示されるコンテンツをカスタマイズして、さまざまなユーザー グループ向けにパーソナライズされたエクスペリエンスを作成できます。 エクスペリエンスのパーソナライズの詳細については、「 コンテンツ ページのパーソナライズ 」を参照してください。

Liferay DXP 2024.Q1+/Portal GA112+より前では、カスタムユーザー属性を使用して、一致するカスタムユーザープロファイル属性を持つユーザーグループにカスタマイズされたコンテンツを表示できました。 しかし、このオプションはLiferay DXP 2024.Q1+/Portal GA112+で 非推奨となりました。

Asset Publisher ウィジェットとコレクションを配置したら、オーディエンスに基づいてコンテンツを動的に表示する エクスペリエンス を作成します。

  1. ページの左上にある言語フラグの横にある デフォルト をクリックして、「エクスペリエンスの選択」モーダルを開きます。 新しいエクスペリエンスを作成するか 既存のエクスペリエンスを選択します。

    すでに経験がある場合は、次の手順をスキップしてください。

  2. エクスペリエンスに名前を付け、ターゲット オーディエンスを選択し、 保存をクリックします。

    対象ユーザーが設定されていない場合は、 [新しいセグメント] をクリックして作成します。 詳細については、「 セグメントの作成 」をお読みください。

    エクスペリエンスを作成すると、「エクスペリエンスの選択」モーダルに表示されます。

  3. 矢印を使用して体験を上に移動して、体験を整理し、希望する体験に優先順位を付けます。 エクスペリエンスをデフォルト エクスペリエンスの上に移動してアクティブ化します。 詳細については、「 エクスペリエンスの仕組みを理解する 」をお読みください。

  4. エクスペリエンスを選択したら、Asset Publisher ウィジェットやウィジェットに表示されるコンテンツなど、ページを設定および編集します。 選択したエクスペリエンスがアクティブな場合、このページのバージョンが表示されます。

以下に、 HR 従業員向けコンテンツIT 従業員向けコンテンツの 2 つのエクスペリエンスが作成されています。 それぞれ異なるカテゴリーのコンテンツが、異なる視聴者に表示されます。 利用可能なすべてのコンテンツを表示するデフォルトのエクスペリエンスも確認できます。

2 つのエクスペリエンスを導入することで、3 つの異なるコンテンツ セットを表示できます。

Asset Publisher ウィジェットを使用して、さまざまなコンテンツのバリエーションを紹介する複数のエクスペリエンスを作成します。