Plugin Details
Home / Plug-in market / Product Album Decoration Module
Product Album Decoration Module
Album Merchandise Decoration Module
Overview
Album Merchandise is a plugin that adds a product album display module to the admin "Design → Decoration" builder. It selects a product category as the "album" and displays products from that album in a grid layout on the storefront. The top-left intro cell shows a customizable title, short description, and a "View more" button, while the remaining cells are product cards. This layout is perfect for brand zones, category recommendations, or themed product collections on the homepage.
Key Features
🎯 Grid Album Display
| Feature | Description |
|---|---|
| Album selection | Choose any product category as the album content source |
| Grid layout | Intro block occupies the top-left cell; remaining cells are product cards |
| Product cards | Reuses the system theme's product card component (image, name, price) |
| Smart placeholders | Automatically displays placeholder cards in design preview – WYSIWYG |
📝 Content Configuration Options
| Option | Description |
|---|---|
| Title | Main title of the intro block (multi-language support – falls back to default text when empty) |
| Short description | Description text of the intro block (rich text support – falls back to default text when empty) |
| View more | Custom button text (falls back to default text when empty) |
| Total products | Configurable from 1 to 50 products |
| Items per row (PC) | Configurable from 2 to 6 columns (including the intro block) |
| Items per row (Mobile) | Configurable from 1 to 2 columns |
| Module width | Narrow (container) / Wide (container-fluid) / Full width (w-100) |
🎨 Default Text Fallback Mechanism
Title, description, and "View more" button text are all customizable. When left empty, they automatically fall back to the default text configured in the "Custom Settings" section – ensuring the module always displays content.
Technical Features
-
✅ First-cell intro block : Unique layout design – the intro block occupies the first grid position for visual prominence
-
✅ Responsive grid : 2–6 columns on PC, 1–2 columns on mobile – automatically adapts to different devices
-
✅ Product card reuse : Uses the system theme's
shared.productcomponent – ensures consistent styling -
✅ Automatic album linking : The "View more" button automatically links to the selected product category page
-
✅ Preview mode friendly : Automatically displays placeholder cards in design preview when no album is selected or the album has no products
-
✅ Smart fallback : Falls back to default text when custom text is left empty – no need to fill every field
-
✅ Any theme compatible : Frontend views are plugin-bundled – product cards adapt automatically to the theme
-
✅ Full design editor support : Real-time preview – album selection dialog supports search and pagination
Use Cases
-
Homepage brand zone / series product showcase
-
Seasonal / holiday themed product collection
-
Bestseller recommendations / popular category display
-
New product launch zone
-
Category navigation + product preview combined
