# SmartSell Ranker – Automate WooCommerce Top-Seller Categories

**Contributors:** crescentek  
**Tags:** woocommerce, best-seller, product automation, top-selling products, product categorization, dynamic categories, sales-based sorting, ecommerce optimization  
**Requires at least:** WordPress 6.3  
**Tested up to:** WordPress 6.8.1  
**Requires PHP:** 7.4  
**Stable tag:** 1.0.1  
**License:** GPLv3  
**License URI:** [https://www.gnu.org/licenses/gpl-3.0.html](https://www.gnu.org/licenses/gpl-3.0.html)  

Automatically assign your WooCommerce top-selling products to a custom category with SmartSell Ranker. Keep your store fresh, dynamic, and conversion-focused.

---

## 🛒 Description

**SmartSell Ranker** is a powerful WooCommerce plugin that automates the way you showcase your store’s best-performing products.

By analyzing recent order data, SmartSell Ranker automatically detects your top-selling WooCommerce products and assigns them to a selected category like “Best Sellers” or “Trending Now.” The plugin runs daily using a scheduled Cron job to ensure the list stays fresh, saving you hours of manual work.

Whether you're managing a seasonal campaign, a large inventory, or flash sales, SmartSell Ranker ensures that your most popular products are always front and center.

---

## 🚀 Key Features

- 🔍 Automatically detect top-selling WooCommerce products  
- 📦 Assign top sellers to a designated product category  
- 🕒 Run updates on a 24-hour schedule using Cron jobs  
- 🛡️ Preserve existing product categories — no overwriting (optional)  
- 📊 Define your own timeframe for sales data  
- 🎨 Fully compatible with WooCommerce themes and extensions  
- ⚡ Lightweight and performance-optimized  

---

## 💼 Use Cases

- Highlight top-selling products during promotions or sales  
- Automate merchandising for large or busy stores  
- Improve user experience with dynamic product sorting  
- Increase conversions by showcasing what’s trending  

Stop managing your best-seller lists manually — let SmartSell Ranker automate the process and boost your WooCommerce store’s performance.

---

## 🔧 Installation

### Modern Way:

1. Upload the plugin files to the `/wp-content/plugins/smartsell-ranker` directory, or install directly from the WordPress Plugin Repository.
2. Activate the plugin through the **Plugins** menu in WordPress.
3. Go to **SmartSell Ranker Settings** in the WooCommerce admin menu.
4. Select your desired time period and target category for top-sellers.
5. Save your settings — SmartSell Ranker will begin auto-updating every 24 hours.

---

## ❓ Frequently Asked Questions

### What is SmartSell Ranker used for?
SmartSell Ranker automatically assigns your WooCommerce top-selling products to a designated category, helping increase visibility and conversions without manual effort.

### How are top-selling products determined?
The plugin reviews WooCommerce order data over a set timeframe (e.g., last 3 months) and ranks products based on sales quantity or revenue.

### Will this affect existing product categories?
No. SmartSell Ranker does not remove products from their current categories. It adds an additional category for top-selling items.

### Can I change how often the update runs?
The default is every 24 hours via Cron job. Advanced users may modify this via WordPress or server-level Cron configurations.

### Is it compatible with other WooCommerce plugins and themes?
Yes. SmartSell Ranker is developed using WordPress best practices and is compatible with most WooCommerce themes and extensions.

### How do I show the product rank on the frontend?
You can use the shortcode:

```php
[ss_ranker_products]