Featured product per category — Installation and configuration guide
Install and configure the module to feature one product per category: border, "Great deal!" flag and pinning to the 1st position.
Overview
The Featured product per category module lets you designate a featured product in each of your PrestaShop categories. That product stands out through three visual levers: a coloured border, a promotional “Great deal!” style flag, and a position at the top of the category listing.
The module is compatible with PrestaShop 8.0 to 9.x and requires no template override: the display relies entirely on CSS injected into the header and on the native product listing hook.
Installation
From your back office, go to Modules > Module Manager, click Upload a module and select the module’s ZIP archive. Installation is automatic.
On installation, the module creates its category/product mapping table, saves its default settings (3 px orange border, “Great deal!” flag enabled) and subscribes to the displayHeader and filterProductSearch hooks.
Appearance settings
Open the module configuration. The first block gathers the visual settings shared by every highlight:
- Border width: from 1 to 50 pixels.
- Border colour: as a hexadecimal value (for example #FFA500) or a CSS colour name (for example orange).
- CSS selector: the element that receives the border. By default, the full product miniature.
Choosing the CSS selector
Depending on your theme, you can target different elements. The generated rule is always automatically scoped to the featured product only.
- .product-miniature: borders the full thumbnail (default value).
- .thumbnail-container: borders only the image container.
- Custom selector: advanced mode. Use the {id} placeholder to write the full selector yourself, for example the thumbnail container inside the miniature of the product targeted by its data-id-product attribute.
Configuring the “Great deal!” flag
The second group of settings controls the badge displayed on the featured product:
- Display a flag: enables or disables the badge.
- Flag text: entered language by language. The text displays automatically in the visitor’s language.
- Background colour and text colour of the flag.
- Position: top-left, top-right, bottom-left or bottom-right.
If the Flag text field is left empty for the visitor’s language, the badge is not displayed. Remember to fill in each active language.
Featuring a product
In the second form, select the relevant category, then search for the product to feature. The search field accepts the product name or reference and offers autocompletion: click a result to select it, with no need to know its ID.
Confirm with Add / Update. The summary table lists all active highlights, each with a delete button.
The module handles one featured product per category. Saving a new highlight for an already associated category automatically replaces the previous product.
Front-office behaviour
On the page of a category that has a highlight, the selected product receives the configured border and flag, and moves to the first position of the listing. If it does not appear on the current page due to sorting or pagination, it is added at the top of the first page, presented exactly like the other products.
Frequently asked questions
Must the featured product belong to the category?
It is not mandatory for the first-position display, but it is recommended for navigation consistency. A warning is shown on save if the product is not associated with the category.
Is the setting specific to each store in multistore?
The appearance configuration and the mappings are global in this version. Per-store management can be added on request.