Documentation

Creating Collections

Note

This information applies to Liferay DXP 7.3+. For previous Liferay DXP versions, see Liferay DXP 7.2.

You can create Manual or Dynamic Collections. For information about the different types of Collections, see About Collections and Collection Pages.

Creating a Manual Collection

  1. Go to Site AdministrationSite BuilderCollections.

  2. Click on the New button (Add) and select Manual Collection.

  3. Add a Title for your Manual Collection and click Save.

  4. In the Item Type drop-down menu, select the item type you want to include in the Collection.

    • If you want to include only one item type

      1. Select the type under Single Item Type.

      2. Optionally, if your Item Type includes a subtype, select this in the Item Subtype drop-down menu.

      3. Click Save.

      Configure the content Type and Subtype for the Manual Collection

    • If you want to include more than one item type

      1. Select Select More Than One under Multiple Item Types.

      2. In the dual list box, add or remove the item types you want to include in your collection.

      Select the different item Types for the Manual Collection

  5. Click Save.

  6. Click Select next to Collection Items and select one of your item types.

    Select the items you want to include in the Manual Collection

  7. In the selection dialog, check the items you want to include.

  8. Click Add.

  9. If your Manual Collection includes more than one item type, repeat steps 6 to 8 for the other types.

Note that Documents and Media folders and Web Content folders can be added to a Collection.

Note

While Documents and Media and Web Content folders can be added to a collection, the content is not displayed when the folder is published on a Collections Page or in an Asset Publisher widget. Even if these assets are added to a collection, they can only be viewed separately. This is a known limitation and will be fixed in a future release.

Creating a Dynamic Collection

  1. Go to Site AdministrationSite BuilderCollections.

  2. Click on the New button (Add) and select Dynamic Collection.

  3. Add a Title for your Manual Collection and click Save.

  4. In the Item Type drop-down menu, select the item type you want to include in the Collection.

    • If you want to include only one item type,

      1. Select the type under Single Item Type.

      2. Optionally, if your Item Type includes a subtype, select this in the Item Subtype drop-down menu.

      3. To filter you Item Subtype by a specific field, enable the Filter by Field switch, click Select, choose the field, and click Apply.

      4. Click Save.

      You can filter the Item Subtype in your Collection by one of the item fields

    • If you want to include more than one item type,

      1. Select Select Types under Multiple Item Types.

      2. In the dual list box, add or remove the item types you want to include in your collection.

      Select the different item Types for the Manual Collection

  5. Configure the criteria for your Dynamic Collection, based on Scope, Filter, Content Recommendation, or Ordering.

    Scope: Define the source of items in your Dynamic Collection. By default, the source is the current site.

    Filter: Configure the rules for the items in the Dynamic Collection. For example, you may want to include only items with the “promotion” tag.

    Filter your Dynamic Collection by adding one or more rules.

    Tip

    You can add multiple rules to your Filter clicking on the Add button. The final content in the Dynamic Collection is the result of adding all the rules.

    Content Recommendation: Enable this option to display content based on user behavior. For more information, see Configuring Content Recommendations.

    Note

    The Content Recommendation option is available when you connect the DXP instance to Analytics Cloud and synchronize the content.

    Ordering: Items in the collection appear using the order criteria you define here.

  6. Click Save.

Creating a Collection from an Asset Publisher

You can create a new Collection from an Asset Publisher Widget. This is useful when you have an Asset Publisher customization that you want to use as a Collection in other pages.

You can transform an Asset Publisher widget into a Collection.

  1. Go to Site AdministrationSite BuilderPages.

  2. Click the Actions button (Add) next to the page that contains the Asset Publisher and select Edit.

    Edit the page which contains your Asset Publisher.

  3. Hover over the Asset Publisher, click the Options icon (Options) in the widget’s menu, and select Configuration.

    Configure the Asset Publisher Widget.

  4. In the Asset Publisher - Configuration dialog, click the Setup tab and Asset Selection sub-tab.

  5. Scroll down and click Create a Collection from this Configuration.

    Click the Create a collection from this configuration to transform the Asset Publisher widget into a new Collection.

  6. Enter the Title for your Collection and click Save.

  7. Close the Asset Publisher - Configuration dialog.

  8. Find your new Collection in Site AdministrationSite BuilderCollections.

Liferay DXP 7.2

Creating Content Sets

You can create Content Sets through the Content Sets interface in Site Administration. Content Sets can use either Manual or Dynamic selection. You can create any number of Content Sets and display them through the Asset Publisher or custom applications. Content Sets can also have personalized variations that provide different experiences for different users based on criteria that you specify. Criteria management is shared with the Asset Publisher. For more information on each option, see Selecting Assets in the Asset Publisher.

Creating a Manual Content Set

To demonstrate the creation of a Manual Content Set, create a Content Set that contains a number of images to be displayed on the Frontpage of the fictitious Space Program website. To prepare for this exercise, upload some appropriate images to Documents and Media to use for the Content Set.

  1. Go to Site AdministrationContent & Data and select Content Sets.

    Content Sets is found in the Content & Data section of Site Administration.

  2. Click Add and select Manual Selection.

  3. Name your Content Set Space Program Images.

On the next screen, you can select the assets to include in the Content Set.

  1. Click SelectBasic Document.

    You can select the type of asset to add to the Content Set.

  2. Now, check the boxes for each image that you want to add and click Add.

Now this Content Set can be displayed anywhere on the site where it was created. You can add or remove items from the set, and it will automatically update it wherever it is displayed.

Creating a Dynamic Content Set

To demonstrate the creation of a Dynamic Content Set, create a Content Set that contains a number of varied assets that are tagged as “trending.” In order for this to work, you will need some number of existing assets with the appropriate tag.

  1. From the Content Sets page, click AddDynamic Selection.

  2. Enter Trending for the name and click Save.

With Dynamic Content Sets, you can choose the Source, Scope, Filter, and Ordering for the items in the set.

  1. Leave Source as Any and Scope as Current Site

  2. Open Filter, make sure it is set to Contains Any of the following Tags, and then enter “trending” in the Tags box.

    Content Sets use the same filter system as the Asset Publisher.

  3. Open Ordering and set it to Order By: Publish Date, And Then By: Title.

  4. Click Save.

This will create a Content Set which will contain any items that are currently tagged as trending and any future items with the trending tag will be added to the Content Set automatically.

Now that you have your Content Sets created, you can display them on a page.

Converting Asset Publisher Configurations to Content Sets

In the previous two guides in this section, you’ve seen Creating Content Sets and Displaying Content Sets demonstrated. Next, try out converting an existing Asset Publisher configuration to a Content Set.

In this case, you have an Asset Publisher on a page, which is configured to display images tagged as trending in reverse alphabetical order by title. This might not be too hard to reproduce in the Content Set creator, but it’s even easier to create the Content Set definition directly from the Asset Publisher.

  1. Go to OptionsConfiguration for the Asset Publisher.

  2. Click Create a content set from this configuration.

    You can generate a Content Set directly from the Asset Publisher configuration.

  3. Enter the title and click Save.

And as quickly as that you have a new Content Set that you can use with Asset Publishers anywhere on the site.

The Content Set is added right alongside any existing sets.

Great! You converted your Asset Publisher configuration to a Content Set.