Important

You are browsing documentation for version 5.0 of OroCommerce, OroCRM, and OroPlatform, maintained until August 2024 and supported until March 2026. See version 5.1 (the latest LTS version) of the Oro documentation for information on latest features.

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

Customize Product Lists

Product lists are used to show lists of products grouped by some criteria, for example, new arrival products, featured products, top selling products, up-sell products, etc.

The data for these lists are loaded from the website search index. This was done to avoid unnecessary hydration of product entities, which is quite expensive and requires a lot of database requests.

The main entry point to the product lists is ProductListBuilder. This builder creates a base query to load products from website search index, executes this query and converts the result to a list of ProductView objects. To be able to customize which data should be loaded, this builder dispatches the following events:

class BuildQueryProductListEvent, event name: oro_product.product_list.build_query.
class BuildQueryProductListEvent, event name: oro_product.product_list.build_query.PRODUCT_LIST_TYPE.
class BuildResultProductListEvent, event name: oro_product.product_list.build_result.
class BuildResultProductListEvent, event name: oro_product.product_list.build_result.PRODUCT_LIST_TYPE.

PRODUCT_LIST_TYPE here is a unique string that identifies each type of product list. The following product list types are available out-of-the-box:

new_arrivals for the list of new arrivals products.
featured_products for the list of featured products.
top_selling_items for the list of top selling products.
related_products for the list of related products.
upsell_products for the list of up-sell products.
product_mini_block for a product displayed in “Product Mini Block” content widget.
segment_products for the list of products displayed in “Product Segment” content widget.

These events provide a possibility to customize all product lists and a particular product list.