コレクションの表示
利用可能 Liferay Portal 7.4 GA6+、DXP 7.3 GA1+
コレクションページまたはコレクション表示フラグメントを追加することで、コレクションを表示できます。 これらの表示オプションの詳細は、 コレクションとコレクションページについて を参照してください。
デフォルトでは、どのユーザーもコレクションのコンテンツを表示できます。 ただし、セグメントを使用して、これらの項目の パーソナライズされたバリエーション を作成できます。 詳細は、 Customizing Collections Using Segments を参照してください。
コレクションを表示する前に、コレクションを作成する必要があります。 詳細は、 コレクションの作成 を参照してください。
ページにコレクションを表示する
コレクションを表示する最も簡単な2つの方法は、コレクションページを追加する方法と、コレクション表示フラグメントを既存のページに追加する方法です。
コレクションページでコレクションを表示する
コレクションページは、ページをコレクションにリンクします。 コレクションページには、ページの一部としてコレクション表示フラグメントが含まれます。 代わりに既存のページにコレクション表示フラグメントを追加するには、 このセクション を参照してください。
次の手順に従って、コレクションページを追加します。
[サイト管理] → [Site Builder] → [Pages] に移動します。
新しいページを追加したいレベルで 新規ページ ボタン (
) をクリックし、 [Add Collection Page] を選択します。
[コレクション] タブから、コレクションの1つを選択します。
使用する [マスターページ] を選択します。
コレクションページの 名前 を入力し、 [Add] をクリックします。
コレクションを表示するには、そのコンテンツをページ要素にマップします。 詳細は、 Mapping Components のセクションを参照してください。
コレクションページの下に子ページを作成することはできません。
これで、コレクション表示フラグメント内に選択したコレクションを表示するコレクションページができました。
コレクション表示フラグメントをページに追加する
コレクション表示フラグメントは、コンテンツページにコレクションを表示します。 選択したコレクションを任意のスタイルまたはレイアウトで表示するように構成できます。
コレクション表示フラグメントに既存のコレクションを追加するには:
コンテンツページの編集アイコン (
) をクリックします。
アイコン (
) をクリックして、[フラグメントとウィジェット]パネルを開きます。
フラグメントメニューの [コンテンツの表示] カテゴリの下で、 [コレクション表示] フラグメントをページ上の任意の場所にドラッグします。
コレクション表示フラグメントをクリックして、 [Selection] パネルに構成を表示します。
ボタンをクリックして、パネルの [General] セクションに表示するフラグメントのコレクションを選択します。
コレクション表示フラグメントがページに表示され、選択したコレクションが表示されます。
コレクション表示フラグメントの設定
コレクション表示フラグメントを手動で追加した場合でも、コレクションページ経由で追加した場合でも、ページを編集してフラグメントを選択することで設定できます。
コレクション表示フラグメントを選択すると、コレクション内の各アセットのセクションに分割されます。 コレクションを選択すると、フラグメントの一般設定の下に新しいオプションが表示されます。
- スタイル表示 : リスト内のアセットをフォーマットするために使用するスタイル(例:グリッドや箇条書きのリストスタイル)です。 (7.4 GA23またはU23より前のバージョンでは、この構成は List Style と呼ばれています)。
- レイアウト : アセットが表示される列の数
- Show Gutter : 列間のガター(間隔)を表示するかどうかを設定します。 このオプションは、カラムレイアウトでグリッドスタイルを選択した場合のみ表示されます(バージョン7.4 GA23+またはU23+の場合)。
- Vertical Alignment : コレクション内のアイテムを各行の上、中、下のいずれかに揃えるかどうか。 このオプションは、Gridスタイルを選択した場合のみ表示されます(バージョン7.4 GA23+またはU23+の場合)。
- リストアイテムのスタイル : 個々のアセットのフォーマットに使用されるスタイル。 このオプションは、選択したリストのスタイルによっては表示されない場合があります。
- 最大項目数 : フラグメントが一度に表示できるアセットの最大数
コレクション内のアセットを構成どおりに表示する準備ができたら、ページを公開します。
Liferay 7.4 GA23+またはU23+では、コレクション表示フラグメントにGridスタイルを選択した場合、デバイスのタイプごとに個別にLayout設定を行うことができます。 画面上部のデバイスビューポートボタンをクリックすると、各デバイスごとに設定できます。 タブレットの設定のデフォルトはデスクトップの設定と同じで、携帯電話の縦長と横長の設定のデフォルトは1カラムです。
コレクションのアセットを表示するためのコンポーネントのマッピング
表示コンポーネントをフラグメントにマッピングすることで、フラグメント内の項目のスタイル (各アセットを個別に表示する方法) を構成することもできます。
これらの要素をフラグメントのセルにドラッグして、コレクション表示フラグメント内のアセットにマップします。
コレクション表示フラグメントのリストのスタイルに対して選択したオプションによっては、コンポーネントをフラグメントにドラッグできない場合があります。 もし、コンポーネントをフラグメントにドラッグできない場合は、別のリストスタイルを選択するか、リストアイテムのスタイル
で別のオプションを選択することができます。
ページエディタで、コレクションを表す [コレクション表示] をクリックします。
ツールのサイドバーで、 フラグメントとウィジェット(
) ボタンをクリックします。
[Fragments and Widgets] サイドバーパネルから、コレクション項目の表示に使用するコンポーネントをドラッグアンドドロップします。
noteコレクション表示に複数の項目が含まれている場合、フラグメントまたはウィジェットをそれらのいずれかにドラッグできます。 コレクション内の残りの項目は、自動的に同じレイアウト設定を使用します。
[コレクション表示]でフラグメントまたはウィジェットをクリックします。
もう一度クリックして、マッピングオプションにアクセスします。
[Mapping] 列で、コレクションにマッピングする [Field] を選択します。
必要に応じてフラグメントまたはウィジェットを追加し、コンテンツをコンテンツフィールドにマッピングします。
[Publish] をクリックします。
表示項目のページネーション
7.4以降で利用可能
パジネーション設定により、コレクションアイテムのページ送りが可能です。 このオプションには、2つの重要な利点があります。
- コレクションは、アイテム数が多いほど見せやすくなります。 コレクション内のすべてのアイテムを表示するのではなく、一度に表示するアイテムの数を決定し、ユーザーがコレクション内のアイテムのリストを前後に移動できるようにすることができます。
- 閲覧可能なアイテムのリストを小さなグループに分割すると、サーバーのオーバーヘッドが削減され、サーバーの応答時間とユーザーエクスペリエンスが向上します。
Liferay 7.4 の U18 と GA18 より前のバージョンでは、利用可能なページネーションのオプションが少なくなっています。 これらのバージョンでは、ページ送りを有効にし、一度に表示する項目の最大数を選択することはできますが、ページ送りメニューに表示されるページ数を変更することはできません。
コレクション表示の表示アイテムをページ分割するには、
コレクション表示のあるコンテントページの編集アイコン(
)をクリックします。
ブラウザアイコン (
) をクリックして、[フラグメントとウィジェット]パネルを開きます。
Page Elementsで、ページ分割したいCollection Display Fragmentを選択します。 (選択されたフラグメントは、既存のコレクションを表示するように設定されている必要があります)。
一般設定で、ページネーションオプションを選択します。
- Pagination : None(ページネーションなし)、Numeric(数値)、Simple(前/次コントロール)。
- Display All Pages : ページネーションメニューで、ページごとに番号やコントロールを表示するかどうかを設定します。 pagination type が選択されていない場合、このオプションは Display All Collection Items になります。
- Maximum Number of Pages to Display : ページネーションメニューに表示される最大ページ数です。 このオプションは、「すべてのページを表示する」チェックボックスが選択されていない場合にのみ表示されます。
- Maximum Number of Items per Page : ページネーションが有効な場合に、1ページに表示するコレクションからのアイテムの最大数です。 ページネーションタイプを選択しない場合、このオプションは代わりに Maximum Number of Items to Display になります。
ページ分割を有効にすると、利用可能なページの総数は、コレクション内のアイテムの総数と、「1ページあたりのアイテムの最大数」の設定の両方によって異なります。
コレクション表示フラグメントは、デフォルトでは編集モードで一度に最大20件まで表示されます。 この制限を変更するには、コントロールパネル → インスタンス設定 → ページ → ページエディタに移動し、Maximum Number of Items in Edit mode 欄の数値を変更します。 編集モードで20以上の項目を一度に表示すると、パフォーマンスに影響が出る場合があります。 この設定は、ユーザーが表示モードのページで見るものに影響を与えません。
サイト全体でのコレクションの使用状況の表示
サイトのコレクションの使用統計を確認することができます。
- [サイト管理] → [Site Builder] → [Collections] に移動します。
- [Collections] タブで、確認するコレクションの横にあるアクション(
)メニューをクリックし、 [View Usages] を選択します。
Liferay DXP 7.2
コンテンツセットの表示
コンテンツセットは、主にアセットパブリッシャーを通じて表示されます。 これは現在、追加設定なしで表示できる唯一の方法ですが、コンテンツセットを利用する独自の外部アプリケーションまたはウィジェットを開発することができます。 コンテンツセットの作成 で、2つのコンテンツセットを作成しました。 それらをページに表示してみましょう。
コンテンツセット用のアセットパブリッシャーの構成
コンテンツセットを表示するには、空白のページから始めて、必要なアセットパブリッシャーを追加し、コンテンツセットを表示するように設定します。
サイトの ホーム ページを1列レイアウトのウィジェットページとして作成します。 新しいLiferay DXPバンドルを使用している場合は、サンプルの ホーム ページから [Hello World] ウィジェットを削除するだけです。
[追加] メニューを開き、 [コンテンツ管理] → [アセットパブリッシャー] を縦に重ねてページに追加してください。
一番上のアセットパブリッシャーの
→ [設定] をクリックします。
[データ選択方法] の下で、 [コンテンツセット] を選択します。
[Select Content Set] を開き、 [選択] をクリックします。
[Space Program Images] コンテンツセットをクリックします。
[保存] をクリックします。
これで、画像がページの上部に表示されます。 コンテンツの表示方法 (どのメタデータを表示するかなど) を管理したり、コンテンツのスタイルを設定するための ウィジェットテンプレート を作成したりできますが、表示する項目と表示する順序はコンテンツセットによって決まります。
次に、一番下のアセットパブリッシャーを他のコンテンツセットで構成します。
一番下のアセットパブリッシャーの
→ [設定] をクリックします。
[データ選択方法] の下で、 [コンテンツセット] を選択します。
[Select Content Set] を開き、 [選択] をクリックします。
[Trending] コンテンツセットをクリックします。
[保存] をクリックします。
ここでも、さまざまな表示設定を管理できますが、表示される項目とその順序はコンテンツセットの基準によって決まります。
既存のコンテンツセットへの項目の追加
静的コンテンツセットと動的コンテンツセットの両方の管理について説明するために、新しい画像をアップロードし、タグを付けて、手動で静的コンテンツセットに追加します。
新しい画像をアップロードし、 [カテゴリ設定] の下で、 trending というタグを付けます。
何もしなくても、画像が Trending コンテンツリストの先頭に追加されます。
手動セットに追加するには、 [サイト管理] → [Content & Data] → [サイトビルダー] に戻ります。
[Space Program Images] をクリックし、 [Space Program Images] の横にある
→ [編集] を選択します。
[アセットエントリー] の隣にある、 [選択] → [基本ドキュメント] をクリックします。
新しい画像を選択して、 [Add] をクリックします。
ホーム ページに戻って、一覧に追加された画像を確認します。
コンテンツセットは、サイト全体に表示するコンテンツやその他のアセットを1か所で簡単に定義できる強力な機能です。 また、再利用が可能なので、ユーザーに優れたコンテンツを届けるための繰り返しの作業が少なくて済みます。