I. Plugin Overview
This plugin is designed for the BeikeShop e-commerce system, offering two promotional activity modes: Flash Sale and Time Discount. When an activity starts, prices are automatically locked; when it ends, prices are automatically restored. The entire process runs automatically without manual intervention.
II. Core Features
1. Two Activity Modes
| Mode | Description | Use Case |
|---|---|---|
| ⚡ Flash Sale | Each SKU has its own flash sale price | Hot products, limited quantity flash sales |
| 🏷️ Time Discount | Store-wide unified discount (fixed amount or percentage) | Full store promotions, holiday sales |
2. Multi-SKU Support
-
Each SKU can have its own flash sale price
-
Flash sale prices automatically update when switching SKUs on the frontend
-
Activity stock is independent of actual product stock
3. Price Automation
-
Before activity starts: Flash sale price and stock can be modified anytime
-
During active activity: Prices are automatically locked (prevents overselling)
-
After activity ends: Prices are automatically restored to original
-
Stock sold out: Automatically restores original price
-
Manual disable: Automatically restores all product prices in the activity
4. Multi-Language Support (11 Languages)
| Language | Language | Language |
|---|---|---|
| Simplified Chinese (zh_cn) | Traditional Chinese (zh_hk) | English (en) |
| Japanese (ja) | Korean (ko) | German (de) |
| French (fr) | Spanish (es) | Italian (it) |
| Russian (ru) | Indonesian (id) |
5. Multi-Currency Support
-
Prices automatically convert based on current currency exchange rates
-
Supports USD, EUR, JPY, CNY and other major currencies
6. Customizable Style
| Option | Description |
|---|---|
| Icon | Lightning, hot, tag, gift, and 10+ more options |
| Badge Color | Custom badge background color |
| Price Color | Custom flash sale price text color |
| Background Color | Custom flash sale box background color |
| Border Color | Custom flash sale box border color |
| Show Countdown | Control whether to display activity countdown |
| Show Stock | Control whether to display remaining stock |
| Show Original Price | Control whether to display original price comparison |
7. Stock Management
-
Activity stock is independent of actual product stock
-
Orders placed during activity automatically deduct flash sale stock
-
Order cancellation/refund automatically restores flash sale stock
-
Stock sold out automatically restores original price
8. Performance Optimization
-
Cache Preheating: Automatically preheats cache 1 minute before activity starts
-
One-Click Clear Cache: Clear cache button in admin panel
-
Row Lock Anti-Overselling: Uses database row locks to ensure accurate stock deduction
III. Admin Panel Features
Activity Management Page
-
Create/Edit/Delete activities
-
Enable/Disable activities
-
View activity status (Pending/Active/Ended/Disabled)
-
Search activities (by name or ID)
-
Sort activities (by ID, name, time, status)
Product Management Page
-
Batch add product SKUs to activities
-
Set flash sale price and stock for each SKU independently
-
Batch delete activity products
-
Modify flash sale price and stock (before activity starts)
-
View sold quantity and remaining stock
Style Configuration
-
Visual configuration of icons, colors, display toggles
-
Real-time preview
Multi-Language Text Configuration
-
Set badge text, countdown prefix, stock label for each language
-
Leave blank to use default values automatically
IV. Frontend Display
Product Detail Page
-
Flash sale box displays: Badge + Flash Price + Original Price + Countdown + Remaining Stock
-
Flash sale price automatically updates when switching SKUs
-
Buy buttons work normally during active activities
Product List Page
-
Flash sale badge displays on product images
-
Price area shows flash sale price and original price
V. Use Cases
| Scenario | Description |
|---|---|
| 🎉 Holiday Sales | 618, Double 11, Black Friday, Christmas promotions |
| ⏰ Limited Time Flash Sales | Daily flash sales, hourly deals |
| 🏷️ Clearance Sales | Seasonal clearance, inventory clearance |
| 🆕 New Product Launch | Limited time offers for new products |
| 🎁 Member Day | Member-exclusive limited time discounts |
VI. Important Notes
-
Modifying start/end time during an active activity may cause price anomalies
-
Product prices are locked after activity starts and cannot be modified
-
Ensure all activities have ended before disabling the plugin, otherwise you need to manually restore prices
-
Flash sale price must be lower than the original product price
-
Activity stock cannot exceed actual product stock
-
All activity data will be lost when uninstalling the plugin
