This class provides an interface to refinement options for the product
search. In a typical usage, the client application UI displays the search
refinements along with the search results and allows customers to "refine"
the results (i.e. limit the results that are shown) by specifying additional
product criteria, or "relax" (i.e. broaden) the results after previously
refining. The four types of product search refinements are:
- Refine By Category: Limit the products to those assigned to
specific child/ancestor categories of the search category.
- Refine By Attribute: Limit the products to those with specific
values for a given attribute. Values may be grouped into "buckets" so that a
given set of values are represented as a single refinement option.
- Refine By Price: Limit the products to those whose prices fall in
a specific range.
- Refine By Promotion: Limit the products to those which are related
to a specific promotion.
Rendering a product search refinement UI typically begins with iterating the
refinement definitions for the search result. Call
retrieve the appropriate collection of refinement definitions. For each
definition, display the available refinement values by calling
on the type of the refinement definition, the application must use slightly
different logic to display the refinement widgets. For all 4 types, methods
are used to generate URLs to render
hyperlinks in the UI. When clicked, these links trigger a call to the Search
pipelet which in turn applies the appropriate filters to the native search