Plugin Details
Home / Plug-in market / Product Ranking Decoration Module
Product Ranking Decoration Module
Product Ranking Decoration Module
Overview
Product Ranking is a plugin that adds a product leaderboard display module to the admin "Design → Decoration" builder. It displays product rankings for three behaviors — Most Viewed, Best Sellers, and Most Added to Cart — as switchable tabs. Each leaderboard can independently set its own title, time window (last N days), and total product count. Leaderboards with no data are automatically hidden. Perfect for homepage popular recommendations, bestseller showcases, user behavior guidance, and similar use cases.
Key Features
📊 Three Product Leaderboards
| Leaderboard Type | Description | Ranking Basis |
|---|---|---|
| Most Viewed | Ranks products by view count | Number of views from the product_views table within the time window |
| Best Sellers | Ranks products by sales volume | Total quantity from paid/shipped/completed orders within the time window |
| Most Added | Ranks products by add-to-cart count | Total quantity from the cart_products table within the time window |
📐 Flexible Configuration Options
| Option | Description |
|---|---|
| Independent leaderboard titles | Each leaderboard can have its own title (multi-language support) – uses default title when empty |
| Max time window | Each leaderboard can independently set the statistical days (1–365 days) |
| Total products | Each leaderboard can independently set the number of products displayed (1–50) |
| Items per row (PC) | Configurable from 1 to 8 columns |
| Items per row (Mobile) | Configurable from 1 to 3 columns |
| Module width | Narrow (container) / Wide (container-fluid) / Full (w-100) |
🏷️ Visual Features
| Feature | Description |
|---|---|
| Ranking marker | Each product displays its ranking number in the top-left corner – top 3 use brand color highlight |
| Tab switching | Click tabs to switch between different leaderboards |
| Auto-hide empty data | Leaderboards with no data are automatically hidden on the storefront (placeholder products shown in design preview) |
| Reusable product cards | Uses the system theme's shared.product component – maintains consistent styling |
Technical Features
-
✅ Accurate data statistics : Most Viewed counts from
product_viewstable, Best Sellers filters by order status (paid/shipped/completed), Most Added counts fromcart_productstable -
✅ Independent time windows : Each leaderboard can have different statistical days – meets various business needs
-
✅ Responsive grid : 1–8 columns on PC, 1–3 columns on mobile – automatically adapts
-
✅ Top 3 highlight : Products ranked 1–3 have their ranking badges highlighted in brand color
-
✅ Smart hiding : Leaderboards with no data are automatically hidden on the storefront – avoids empty areas
-
✅ Preview friendly : Automatically displays placeholder products in design preview – WYSIWYG
-
✅ Any theme compatible : Frontend views are plugin-bundled – product cards reuse current theme components
-
✅ Full design editor support : Real-time preview – rich and intuitive configuration options
Use Cases
-
Homepage popular product recommendations
-
Bestseller product showcase
-
Weekly/monthly hot-selling leaderboards
-
User browsing trend display
-
Add-to-cart / wishlist leaderboards
-
Data-driven content recommendations
