thelia / top-products-module

2.2.1 2026-10-18 12:45 UTC

Requires

• thelia/installer: ^1.6

GPL-3.0-or-later

Published on Packagist.org on 2026-10-18 12:46 UTC

README

This module allows to create selections of top products in category and brand.

Installation

Manually

• Copy the module into <thelia_root>/local/modules/ directory and be sure that the name of the module is TopProducts.
• Activate it in your thelia administration panel

Composer

Add it in your main thelia composer.json file

composer thelia/top-products-module:~1.1.0

Usage

This module adds a new tab Top products in categories and brands where you can create selections and add products in selections.

To retrieve the products of a selection, use the front API resource below.

Front API resource

The module exposes the selections on the Thelia 3 front API, so that a Twig/Flexy theme can read them. The resource is read only: there is no POST, PUT, PATCH or DELETE operation.

GET /api/front/top_products returns the pinned products, by ascending position unless an order[...] parameter is given. The collection is not paginated.

Parameter	Description
elementKey	category or brand
elementId	The id of the category or brand. Repeat it to read several: elementId[]=3&elementId[]=7
selectionCode	The selection, for example new or best
order[position], order[id]	asc or desc

Each item exposes id, elementKey, elementId, selectionCode, position and product, the IRI of the product (/api/front/products/{id}).

GET /api/front/top_products?elementKey=category&elementId=12&selectionCode=best

GET /api/front/top_products/{id} reads one row.