PopularBoughtRecommendationsList
PopularBoughtRecommendationsList
The PopularBoughtRecommendationsList
controller recommends the most purchased products.
Methods
refresh
Gets new recommendations for popular bought items.
subscribe
Adds a callback that’s invoked on state change.
Parameters
-
listener:
() => void
A callback that’s invoked on state change.
Returns Unsubscribe
: A function to remove the listener.
Attributes
state
The state of the PopularBoughtRecommendationsList
controller.
Properties
-
error:
SearchAPIErrorWithStatusCode | null
An error returned by the Coveo platform when executing a recommendation request, or
null
if none is present. -
isLoading:
boolean
Whether a recommendation request is currently being executed against the Coveo platform.
-
maxNumberOfRecommendations:
number
The maximum number of recommendations.
-
recommendations:
ProductRecommendation[]
The products recommended by the Coveo platform.
Initialize
buildPopularBoughtRecommendationsList
Creates a PopularBoughtRecommendationsList
controller instance.
Parameters
-
engine:
ProductRecommendationEngine
The headless engine.
-
props:
PopularBoughtRecommendationsListProps
The configurable
PopularBoughtRecommendationsList
properties.
Returns PopularBoughtRecommendationsList
PopularBoughtRecommendationsListProps
The configurable PopularBoughtRecommendationsList
properties.
Properties
-
options?:
PopularBoughtRecommendationsListOptions
PopularBoughtRecommendationsListOptions
Properties
-
additionalFields?:
string[]
Additional fields to fetch in the results.
-
maxNumberOfRecommendations?:
number
The maximum number of recommendations, from 1 to 50.
Default:
5
Related Types
ProductRecommendation
Properties
-
additionalFields:
Record<string, unknown>
An object containing the requested additional fields for the product.
-
childResults:
ProductRecommendation[]
A list of child product recommendations in a product grouping context.
-
clickUri:
string
A direct link to the product in URL format.
-
documentUri:
string
This parameter is no longer used by the Coveo Usage Analytics service.
-
documentUriHash:
string
Document UriHash in the index. Useful for analytics.
-
permanentid:
string
The SKU of the product.
-
totalNumberOfChildResults:
number
The total number of items in the group.
-
ec_brand?:
string
The brand of the product.
From the
ec_brand
field. -
ec_category?:
string
The category of the product (for example,
"Electronics"
,"Electronics|Televisions"
, or"Electronics|Televisions|4K Televisions"
).From the
ec_category
field. -
ec_images?:
string[]
Additional product images in URL format.
From the
ec_images
field. -
ec_in_stock?:
boolean
The availability of the product (that is, whether it’s in stock).
From the
ec_in_stock
field. -
ec_item_group_id?:
string
The id used for Product Grouping.
From the
ec_item_group_id
field. -
ec_name?:
string
The name of the product.
From the
ec_name
field. -
ec_price?:
number
The base price of the product or variant.
From the
ec_price
field. -
ec_promo_price?:
number
The promotional price of the product or variant.
From the
ec_promo_price
field. -
ec_rating?:
number
A rating system. Ratings range from 0-10.
From the
ec_rating
field. -
ec_shortdesc?:
string
A short description of the product.
From the
ec_shortdesc
field. -
ec_thumbnails?:
string[]
Product images in URL format.
From the
ec_thumbnails
field.
Unsubscribe
Call signatures
-
(): void