Showcase Revolution: setup and help

Upload and install mprshowcaserevolution in Modules > Module Manager. Click Configure to open the dashboard. Use Improve > Showcase Revolution for Widgets, Collections, and Settings > Configuration. The Settings submenu also contains Integrity, License, Support, and Update.

Requires PrestaShop 1.6.1 or later and PHP 7.1 or later.

For a first test, open Widgets, add a widget, enter a Title, choose Widget Type: New Products, Hook (Placement): Homepage (displayHome), Layout: Grid, Products Count: 8, and Active: Yes. Enter 4 desktop products per row and 2 mobile products per row. Save and open the homepage.

Features

Use the module enabled state in Module Manager, or a widget's Active setting, to control actual display. The separate Enable module configuration field does not replace those controls.

Widget Defaults

These are saved global preferences. Existing widgets have their own fields. Set each new widget explicitly; do not assume changing a global preference updates saved widget values or prepopulates every editor field.

Trending

Use the dashboard's manual trending recalculation control after collecting views. Scores combine recorded views and valid order sales. Product views are recorded through actionObjectProductViewAfter; confirm that your shop or integration emits that hook. Back-in-stock recording uses actionUpdateQuantity and compares the quantity visible in storage with the hook's new quantity. Verify this transition with your stock update flow.

Performance

HTML containing price or add-to-cart output is excluded from the shared widget HTML cache. Personal sources are also excluded. Warehouse-compatible carousels have an additional selection and lightweight-card cache; personalized first-row product data is rendered in the visitor's context.

Theme styles

Defaults come from the shared theme style system. The module registers --mpr-sc-primary, --mpr-sc-accent, --mpr-sc-filter-bg, --mpr-sc-radius, --mpr-sc-shadow-hover, and --mpr-sc-transition. Card gap defaults to 16px and supplies --mpr-sc-gap. Change the shared styling controls when you need to adjust the detected palette or spacing. Primary-hover and normal shadow mappings are unavailable.

The editor has General, Display, and Advanced tabs. The defaults below describe schema defaults; enter explicit values when a new form is empty.

General

Sources are Best Sellers, New Products, On Sale, Featured Products, Trending Now, Curated Collection, Back in Stock, Recently Viewed, and Cart Recommendations. Recently Viewed is listed but returns no products; do not select it for a working block.

Cart Recommendations needs an enabled MPR Sales Revolution module, a loaded cart, and products in it. Other sources work independently of that integration. Featured Products uses Category Scope or the configured featured category. Category Scope is not applied by every source, including the collection and cart recommendation paths.

Display

Grid, Slider, and Carousel normally use the theme's native product miniature on modern PrestaShop. PrestaShop 1.6 has a module legacy template. List and Compact use smaller module templates. Dots and autoplay are passed to the current carousel renderer.

Advanced

Sort By is stored, but automatic sources keep their own query order. CSS Class defaults to empty and adds a wrapper class. Custom CSS defaults to empty and prints a style block. Position defaults to 0 and orders widgets within a hook.

Custom CSS is not automatically scoped to the widget. Include the CSS Class in your selectors:

.homepage-staff-picks .mpr-showcase-widget__title {
  text-transform: uppercase;
}

The database also stores sort_dir with default DESC and show_manufacturer with default 0; these are not controls in the current widget form.

Create a collection with Name, optional rich-text Description, Type, Start Date, End Date, Active, and Position. Name and description default to empty, Type defaults to curated, dates to empty, Active to Yes, and Position to 0. Types include curated, staff_picks, seasonal, and spotlight.

Add selected products, reorder them, then save a widget with Widget Type: Curated Collection and the matching Collection. Products use their saved collection position.

Dates and Active affect collection queries that request active-only selection. The widget's direct collection product lookup does not check those collection scheduling fields. Control a collection widget with its own Active switch; do not rely on collection dates to hide an already assigned widget.

For example, create a collection called Summer Picks, then configure:

Title: Summer Picks
Widget Type: Curated Collection
Collection: your saved collection
Hook (Placement): displayHome
Layout: Grid
Products Count: 8
Active: Yes

Supported hooks are:

displayHome
displayFooterCategory
displayLeftColumn
displayRightColumn
displayFooterBefore
displayFooterProduct
displayProductAdditionalInfo
displayOrderConfirmation2
displayCrossSellingShoppingCart
displayNotFound

The theme must call the selected hook. For a custom product footer:

{hook h='displayFooterProduct'}

There is no CMS shortcode renderer. Use a supported hook.

Theme override paths include:

themes/your_theme/modules/mprshowcaserevolution/views/templates/front/widget.tpl
themes/your_theme/modules/mprshowcaserevolution/views/templates/front/_product-miniature-widget.tpl
themes/your_theme/modules/mprshowcaserevolution/views/templates/front/layouts/list-item.tpl
themes/your_theme/modules/mprshowcaserevolution/views/templates/front/layouts/compact-item.tpl

Useful selectors include .mpr-showcase-widget, its --grid, --slider, --carousel, --list, and --compact modifiers, .mpr-showcase-widget__title, .mpr-showcase-widget__subtitle, .mpr-showcase-widget__link, .mpr-showcase-slider__nav, .mpr-list-item, and .mpr-compact-item.

1. Confirm your first Grid widget shows products on its selected hook.
2. Change it to Slider and test arrows, dots, and autoplay on desktop and mobile.
3. Check price and add-to-cart controls in your actual theme.
4. Click a widget product and inspect the trackClick request if click records matter to you.
5. Test a collection and cart recommendation source separately before reusing them elsewhere.

No wrapper is printed if a source returns no presentable products. Check active state, current shop association, exact hook, source eligibility, category, cover images, and product count. Best Sellers needs sales and Trending Now needs recorded views plus recalculation. Back in Stock needs recorded stock transitions. Recently Viewed returns no products in this version.

If changes appear late, account for the fixed 30-minute caches and your shop/theme cache. If collection scheduling appears ignored, use the widget's own Active control. If a theme ignores price or button flags, review its miniature template.

Export or record widgets and collections before uninstalling. Uninstall removes the admin menu, column-management registration, theme registration, and module-owned schema tables, including widgets, collections, trending, and tracking data. Standard uninstall removes hook registrations. If theme cleanup fails, the method stops before removing the remaining setup. Remove any manual theme hook calls and overrides you added.