Category Wall — Visual category page

Category Wall replaces PrestaShop’s native subcategory list with a wall of image tiles, complete with product counters and three layouts to choose from. This guide covers installation, configuration and advanced use of the module.

Installation

The module installs like any PrestaShop module, with no external dependency and no Composer.

1. In the back office, open Modules > Module Manager, then click Upload a module (top-right button).
2. Select the dfcategorywall.zip file and run the installation.
3. Once installed, click Configure to reach the settings.

How the display works

On every category page, the module automatically shows the subcategory wall above the product listing. It relies on the displayContentWrapperTop hook, present in the Classic theme and most themes derived from it.

If no active subcategory exists for the browsed category, the wall is not shown: the module stays completely invisible on “leaf” categories.

Configuration options

All options are set from the module’s configuration screen.

Layout

Three presentations are available:

• Grid — a regular grid of equally sized tiles, ideal for a clean, structured result.
• Mosaic — a dynamic arrangement where the first subcategory takes an enlarged tile, to draw the eye to a flagship aisle.
• Carousel — a smooth horizontal scroll, touch-friendly on mobile and equipped with navigation arrows on desktop.

Columns

Set the number of columns shown on desktop, from 2 to 6. This value applies to the grid and carousel layouts. The display automatically drops to 3 then 2 columns on tablet and mobile.

Product counters

Enable Show product counters to display, on each tile, the subcategory’s product count as a badge.

• Count products recursively — adds up the products across the whole child tree (nested subcategories included), not only products attached directly.
• Hide empty subcategories — removes from the wall any subcategory with no visible product, to present only genuinely stocked aisles.

Description and title

• Show subcategory description — displays a short excerpt below each tile’s name (truncated to 120 characters).
• Show section title and Section title — a customizable, multilingual heading shown above the wall (for example “Browse subcategories”). Leave the field empty to hide the title.

Hide the native list

The Hide the native subcategory list option adds a discreet CSS rule that hides the theme’s default subcategory block, to avoid any duplicate with the wall. This option has no effect if your theme doesn’t display that block.

Tiles without an image

When a subcategory has no cover image, the module automatically generates a fallback tile: a stable color gradient derived from the category ID, carrying the initial of its name. The grid therefore always stays consistent, with no empty cell.

Widget usage

Beyond the category page, the wall can be inserted anywhere in a template through PrestaShop’s widget interface.

{widget name='dfcategorywall'}

To target a specific category, pass its ID:

{widget name='dfcategorywall' id_category=12}

Troubleshooting

The wall doesn’t show

• Check that the browsed category actually has active subcategories.
• Make sure your theme fires the displayContentWrapperTop hook. Otherwise, use the widget insertion described above.

Subcategories appear twice

Enable the Hide the native subcategory list option to remove the theme’s original block.

The carousel arrows don’t appear

The arrows only show when there are enough tiles to overflow the visible width. On mobile, navigation is by finger only (touch scrolling).