Sort products and categories by popularity based on previously placed orders.
This plugin periodically scores products and categories based on the amount of times they occur in previously placed orders. The goal is to be able to order products and categories by their popularity, so we can present the most popular products and categories to our customers first.
import { PopularityScoresPlugin } from 'vendure-popularity-scores-plugin-fix'
...
plugins: [
PopularityScoresPlugin.init({
endpointSecret: 'test',
}),
...
];
This plugin exposes an endpoint that can be periodically called: /order-by-popularity/calculate-scores/your-secret
. This will push a job named calculate-popularity
to the worker. The worker will handle this message and do the following:
- Get all orders from the past 12 months. The amount of months should be configurable.
- Calculate the amount of times each Variant has been sold.
- It then calculates the sum of all variants per Product, so that we have the amount of times a Product has been sold in the past 12 months.
- It normalizes this value to a score of 0 to 10000, because we don't want to expose our number of sales publicly.
- The normalized score will the be stored on
Product.customFields.popularityScore
- It then calculates the popularity of collections, based on the product scores. The collection scores do not have to be normalized again.
- The score of a parent collection should include the scores of all its subcollections
- Collection scores should be stored on
Collection.customFields.popularityScore
- Both the Product and Collection popularity scores should be publicly available in the GraphQL Shop API.
Run yarn start
to start the server. The following will be available after startup:
-
http://localhost:3050/admin
you can login with superadmin/superadmin -
http://localhost:3050/admin-api
Admin GraphQL playground -
http://localhost:3050/shop-api
Shop GraphQL playground
Run yarn test
to run the testcases defined in test/e2e.spec.ts