ProductBestsellersRanking

ProductBestsellersRanking

GitHub - magesuite/product-bestsellers-ranking

This module calculates product bestseller ranking.

Installation

This module is a part of MageSuite metapackage

 

Installation if metapackage is not used:

composer require "creativestyle/magesuite-product-bestsellers-ranking" ^1.0.0

Admin settings

Settings for the module can be found under: Stores -> Configuration -> MageSuite -> Bestsellers

 

Crone settings:

Name

Options

Note

Name

Options

Note

Enable Daily Calculation

 Yes/No 

If this option is enabled then cron will recalculate bestsellers

Recalculation Cron Schedule

Default: 0 3 * * *

Schedule expression for bestsellers recalculation cron (format: * * * * *)

Use Transactions

Yes/No 

If this option is enabled bestsellers recalculation will be wrapped in db transaction to not lose already calculated bestseller scores, if any error occurs during recalculation

Enable cron crash detector

Yes/No 

When enabled cron job will check if bestseller calculation daily cron job crashed and if so it will try to rerun it.

 

Orders period settings:

Name

Options

Note

Name

Options

Note

Orders period

  • All orders

  • Orders from 7 days

  • Orders from 30 days

  • Orders from 1 year

 

 

Boosting factors settings:

image-20250813-062514.png

 

You can set up below boosting factors to increase product scoring during bestsellers calculation. If an order is older, it gets a lower boosting factor.

Name

Options

Note

Name

Options

Note

Boosting Factor A

Decimal (Default: 3)

Orders within 7 days will get this boosting factor (eg. 3)

Boosting Factor B

Decimal (Default: 2)

Orders within 30 days will get this boosting factor (eg. 2)

Boosting Factor C

Decimal (Default: 1)

Orders within 356 days will get this boosting factor (eg. 1)

Boosting Factor D

Decimal (Default: 0)

Orders older than 365 days will get this boosting factor (eg. 0)

Sold Out Decrease Factor

Decimal (Default: 1)

Products that are sold out will have this decrease factor (eg. 0.5)

Turnover Multiplier

Decimal (Default: 100)

Multiplier for turnover value.

 

Sorting settings:

Name

Options

Note

Name

Options

Note

Sorting direction

Ascending / Descending

 

 

 

Product page settings:

Name

Options

Note

Name

Options

Note

Bestseller Score By Amount

Integer

Field will be overwritten automatically every night

Bestseller Score By Sale

Integer

Field will be overwritten automatically every night

Bestseller Score By Turnover

Integer

Field will be overwritten automatically every night

Bestseller Score Multiplier

Integer

Value in %

Backend

 

BE documentation is in progress

 

Frontend

There is no frontend functionality in this module.