Important

You are browsing the documentation for version 4.1 of OroCommerce, OroCRM and OroPlatform, which is no longer maintained. Read version 5.1 (the latest LTS version) of the Oro documentation to get up-to-date information.

See our Release Process documentation for more information on the currently supported and upcoming releases.

Available in OroCommerce

Configure Content Variants for the Content Node

This section provides an overview of the content node types and a brief guidance on their setup.

Note

The first content variant that is added to the node is marked as the default variant. When you add more content variants, please, specify the restrictions next to the content variant details. These restrictions will limit the use of this content variant only to specific cases.

Specify the restrictions for the default content node

Add a System Page

System page is one of the standard pre-designed pages of OroCommerce storefront (e.g. Requests for Quotes, Open Orders).

To add a system page to the menu in the OroCommerce storefront:

  1. Select the Add System Page in the Content Variants list.

    Add system page and specify restrictions
  2. Select the system page from the list.

  3. This step applies only to the content nodes with more than one content variant.

    When your system page is not selected as a default variant for the content node, there is a Restrictions section beneath the selected system page. In this section, you can define the condition when the system page overrides the default content variant. See the Configure Content Visibility section for more information.

  4. Click Save when you are done filling in the web catalog content node or keep adding the content variants.

Add a Product Page

Product page node is a direct link to the product details in OroCommerce storefront.

To add a product page node to the menu in the OroCommerce storefront:

  1. Select the Add Product Page in the Content Variants list.

    Add product page and specify the restrictions
  2. Select the product from the list. To use search, start typing the product name or SKU in the box. To use filtering, click on the bars, and select the filtering conditions in the Manage filters section.

  3. This step applies only to the content nodes with more than one content variant.

    When your product page is not selected as a default variant for the content node, there is a Restrictions section beneath the selected product. In this section, you can define the condition when the product details override the default content variant. See Configure Content Visibility section for more information.

  4. Click Save when you are done filling in the web catalog content node or keep adding the content variants.

Add All Products Page to Web Catalog

Once the All Products page has been enabled in the system configuration globally or per website, you can add it as a part of your web catalog.

Note

Please note that it is recommended to enable the All Products page exclusively for small catalogs with no more than a few hundred products, otherwise browser performance might be affected.

  1. Navigate to Marketing > Web Catalogs in the main menu.

  2. For the necessary web catalog, hover over the more actions menu to the right and click to start editing the catalog content tree.

Click the content tree icon in the more options menu of the Default Web Catalog
  1. In the Content Nodes menu on the left, select the node to which you need to add the All Products page by clicking it.

  2. Click Create Content Node on the top right of the page.

  3. Complete the required fields to configure the web catalog node.

  4. In the Content Variants section, make sure to add the All Products as the system page. To do this:

    1. Click Add System Page.

    2. From a System Page Route list, select the Oro Catalog Frontend Product Allproducts (All Products page).

    Selecting the All products page for the System Page Route for the Default Web Catalog

    Note

    See Content Variants topic for more information on using content variants. See System Page topic for more information on this content variant type.

  5. Once all the details have been provided, click Save on the top right of the page.

Add a Category

Category node is a direct link to the product category with the list of products in the OroCommerce storefront.

To add a category node to the menu in the OroCommerce storefront:

  1. Select Add Category in the Content Variants list.

    Select a category from the content tree
  2. Click next to Sub-Categories to select the required option from the list.

    The available options are:

    • Include, show as filter - Used to include all the products assigned to the subcategories of the selected category in addition to the products that are already assigned directly. The subcategories of the first level with at least one product will be displayed as a category filter in the OroCommerce storefront.

      Illustration of the Include, show as filter option
    • Do not include - Used to include the products assigned only to the selected category. In case the category has a subcategory, its product items will not be displayed.

  3. Select the category from the product catalog tree. To use search, start typing the category name in the box. Use > and v to expand/collapse the tree node.

    Start typing the category name in the search bar
  4. This step applies only to the content nodes with more than one content variant.

    When your category is not selected as a default variant for the content node, there is a Restrictions section beneath the tree of categories. In this section, you can define the condition when the selected category overrides the default content variant. See Configure Content Visibility section for more information.

  5. Click Save when you are done filling in the web catalog content node or keep adding the content variants.

Add a Landing Page

Landing Page node is a link to the custom content page created in the Marketing > Landing Pages section.

To add a landing page node to the menu in the OroCommerce storefront:

  1. Select the Add Landing Page in the Content Variants list.

    Add a landing page and specify the restrictions
  2. Select the existing landing page from the list. To use search, start typing the keywords in the box to search for the necessary page. To use filtering, click on the bars, and select the filtering conditions in the Manage filters section. Alternatively, you can create a new landing page:

    1. Click + to the right from the Landing page list.

      The Create Landing Page pops up.

    2. Fill in the landing page details and contents as described here.

  3. This step applies only to the content nodes with more than one content variant.

    When your landing page is not selected as a default variant for the content node, there is a Restrictions section beneath the selected landing page. In this section, you can define the condition when the landing page overrides the default content variant. See Configure Content Visibility section for more information.

  4. Click Save when you are done filling in the web catalog content node or keep adding the content variants.

Add a Product Collection

Product Collection is a filter-based segment that helps you display a custom and dynamic set of products in the web catalog similarly to the category contents.

Note

You can control the frequency of the product collections indexation. By default, product collections are indexed every hour. See the Product Collections Configuration guide for the details on how to change the default indexation frequency.

  1. To add a product collection node to the menu in the OroCommerce storefront:

    Select the Add Product Collection in the Content Variants list.

    Add a product collection and specify the restrictions
  2. To name a segment of the product collection:

    Enter the segment name for the product collection in the provided field.

    Enter the segment name for the product collection in the provided field
  3. To add a product to the collection via filter:

    In the All Added tab, click Advanced Filter to set up a filter that will limit the products list and include only the necessary products.

    Set up a filter to limit the products list

    Note

    Advanced Filter is hidden by default.

    Click Preview Results to check whether the products found via the filter match your criteria, or to exclude unnecessary items from the list.

    Click Preview Results

    Note

    To manage the columns displayed Within the products grid, click .

  4. To add a product to the collection manually:

    Click Add next to Advanced Filter to add the selected products manually. This can be used in cases when you have few products to be added and there is no need to set up a complicated filter, or when you need to add specific products that may be out of the filter’s scope.

    Click Add and select the products manually

Manually added items will appear both in the Manually Added and All Added tabs.

  1. To exclude items from the collection:

    To ensure that specific items are excluded from the list of the product collection and will not be included automatically or manually, click Add in the Excluded tab:

    Click Add in the Excluded tab

    Tick the Selected box to the left of the necessary products, and click Add.

    Note

    You may use filter on the top of the dialog to limit the scope of the products and make it fit into the visible area.

    Select the necessary products manually
  2. To reset products:

    To clear all filters and reset the product collection to the default state, click Reset Products next to the tabs.

    Click Reset Products next to the tabs
  3. This step applies only to the content nodes with more than one content variant.

    When your collection is not selected as a default variant for the content node, there is a Restrictions section beneath the product collection preview. In this section, you can define the condition when the product collection overrides the default content variant. See Configure Content Visibility section for more information.

  4. Click Save when you are done filling in the web catalog content node or keep adding the content variants.

Set a Default Content Variant

The first content variant that is added to the node is marked as the default variant.

When you add more content variants, they have a dedicated restrictions section next to the content variant details. These restrictions will limit the use of this content variant only to specific cases; the default option is used in any other case.

To set up a newly added content variant as default, select the radio on the top left of its type.

Select the content variant to make it the default one