Product Waterfall Decoration Module
Overview
Product Waterfall is a plugin that adds a product waterfall display module to the admin "Design → Decoration" builder. Select a product category as the "album", and the storefront displays products from that album in a waterfall grid. Each product card features an automatic discount ribbon (X% OFF), a struck-through original price, and a "Save $X" badge. The storefront shows only the first row initially; clicking the "View More" button loads the next row one batch at a time (number of loads configurable). After all products are shown, the button automatically redirects to the selected album's category page. Perfect for homepage bestseller showcases, limited-time promotions, and album product displays.
Key Features
🌊 Batch-Loading Waterfall Display
| Feature |
Description |
| Album selection |
Select a product category as the album content source |
| Batch loading |
Only the first row is shown initially; clicking "View More" reveals the next row one batch at a time |
| Configurable load times |
Set 1–10 load times (one row per load) – total products = items per row × load times |
| Auto redirect |
After all products are shown, the button automatically redirects to the album's category page |
🛒 Product Card Features
| Feature |
Description |
| Discount ribbon |
Automatically calculates discount percentage – displayed as a brand-color flag-shaped ribbon (X% OFF) |
| Price display |
Sale price + struck-through original price + "Save $X" badge – clearly shows discount value |
| Login-based price display |
Follows system settings – can hide prices for non-logged-in users |
| Image hover zoom |
Product image smoothly scales on hover |
📐 Rich Configuration Options
| Option |
Description |
| Title |
Main module title (multi-language support) |
| Short description |
Module description text (rich text support) |
| Items per row (PC) |
Configurable from 2 to 6 columns |
| Items per row (Mobile) |
Configurable from 1 to 3 columns |
| Load times |
Configurable from 1 to 10 – max total products 60 |
| View More copy |
Custom button text (multi-language support) |
| Module width |
Narrow (container) / Wide (container-fluid) / Full (w-100) |
📋 Album Selection
| Feature |
Description |
| Album selector |
Popup category selector with search support |
| Automatic resolution |
Automatically pulls album covers, titles, and links |
Technical Features
- ✅ Batch-loading waterfall : First row shown initially – subsequent rows load on demand – reduces initial page load time
- ✅ Responsive grid : 2–6 columns on PC, 1–3 columns on mobile – automatically adapts
- ✅ Auto-calculated discount ribbon : Automatically calculates and displays discount percentage based on original and sale price
- ✅ "Save $X" badge : Intuitively shows the amount saved on each product
- ✅ Smart price display : Follows system "show price after login" configuration
- ✅ Fade-in animation : Newly loaded product cards animate with fade-in and slide-up effect
- ✅ Smart button behavior : Loads more products when available – redirects to category page after all products are shown
- ✅ Any theme compatible : Frontend views are plugin-bundled – product cards reuse current theme components
- ✅ Full design editor support : Real-time preview – album selector supports search
Use Cases
- Homepage bestseller product recommendations
- Limited-time promotion displays
- Album/category product showcase walls
- New arrival waterfall displays
- Alternative to infinite scroll (batch loading for controlled experience)
