1. Content collections

Extend content collections

By default, users can only add content items to content collections. However, as a superuser, you can extend content collections to work with other entity definitions.

Note

To configure Content Hub, you must either be a superuser or have the necessary permissions granted to you through user group policies.

In this configuration example, you extend content collections to add products, including:

Add existing products

To allow adding new products to content collections, you must:

  1. Create a relation between content collections and products.

  2. Edit the search component of the Content collection details page.

  3. Edit the creation component of the Content collection details page.

Create a relation

To create a relation between content collections and products, follow the procedure to add a relation. Make sure to enter the following parameters:

Where

Desired field value

Page name

M.ContentCollection

Name in New member group dialog box

Product

New member dialog box

In RELATION, click Select and fill in the following fields:

  • Name: ContentCollectionsToPCM, for example

  • Associated definition: M.PCM.Product

  • Cardinality: ManyToMany

When you have done this, click Save and Apply changes.

Edit the search component

To allow the Content search component to find M.PCM.Product entities, you must:

  1. Edit the filters to include M.PCM.Product.

  2. Edit the the grid view to include the desired product fields.

  3. Make the same changes to the Add existing items component.

Filters

To edit the filters of the Content search component, follow this procedure. Make sure to enter the following parameters:

Where

Desired field value

Page name

Content collection details

In Filters, on the System tab

Change the combine operator from and to or

Filter

Select the Product (M.PCM.Product) definition

Fixed tab

Fill in the following fields:

  • Input type: Page entity

  • Filter type: Ancestor

  • Name: ContentCollection

Note

The * symbol is a wildcard. It filters dynamic data related to content collections. In this case, it filters the ContentCollectionsToPCM and ContentCollectionToContent members.

In the final step, change the Filter type back to Relation and click Save.

Views

To edit the view of the Content search component:

  1. On the Content search component page, in the Views section, turn on Grid.

  2. To edit the product grid view, select the M.PCM.Product toggle.

  3. To add the desired fields, on the Fields tab, click Add field.

  4. Click Save.

Note

The grid view is the default view to display content with thumbnails.

Edit the Add existing items component

Now, make changes to the filters and output of the Add existing items component as follows:

  1. On the Content collection details page, on the Add existing items component, click the switch to enable custom settings.

  2. Click the Add existing items component.

  3. In Filters, on the System tab, change the combine operator from AND to OR.

  4. To confirm your change, click Save.

  5. In the left pane, in the Views section, click Grid and then click the M.PCM.Product block.

  6. To add the desired fields, on the Fields tab, click Add field.

  7. Click Save.

Edit the creation component

To allow the Creation component to link existing products to content collections:

  1. On the Content collection details page, on the Creation component, click the switch to enable custom settings.

  2. Click the Creation component.

  3. Click Link items, and then click Add definition.

  4. In the drop-down list, select the ContentCollectionsToPCM relation.

  5. Click Save.

  6. Click the General section.

  7. Add a label, either a Default or Custom option.

  8. In Linked search component, select Content search and Add existing items.

  9. Click Save and close.

Add new products

To allow adding new products to content collections:

  1. On the menu bar, click Manage .

  2. Click Pages and find the Content collection details page.

  3. On the Creation component, click the switch to enable custom settings.

  4. Click the Creation component.

  5. Click New entities, and then click Add definition.

  6. In the drop-down list, select M.PCM.Product.

  7. Fill in the fields as follows:

    • Label type: Default or Custom. Here, you select Default.

    • Detail Page: here, you select Product creation (the template page for the creation of a new product).

    • Window type: defines the size of the dialog box used for product creation (Medium modal is the default):

  8. Under DEFAULT VALUES, click Add value.

  9. In the two drop-down lists, click ContentCollectionsToPCM* and Current entity respectively.

  10. To confirm your changes, in the bottom-right of the screen, click Save.

  11. In the top-right of the screen, click Save or Save and close.

    Tip

    To remove, edit, or delete products from a content collection, edit the Selection component to define operations for M.PCM.Product.

If you have suggestions for improving this article, let us know!