Moduł rekomendacji produktów dla PrestaShop

## [1.1.2] - 2025-12-25

### Added

- **Separate headings per context**: introduced two independent, multi-language block headings:
  - `PPSMARTREC_HEADING_PRODUCT` (product page)
  - `PPSMARTREC_HEADING_CART` (cart summary)
- **Translation-ready defaults**: default heading texts are set via `l()` so they can be translated (e.g. in `translations/pl.php`).

### Changed

- **Recommendation configuration snapshot**: recommendation building now uses a cached config snapshot to reduce repeated `Configuration::get` calls.
- **Cart cache key stability**: cart widget cache ID is now stable (product IDs are sorted before hashing), preventing cache misses caused by ordering.
- **Availability check memoization**: availability checks are memoized per request to avoid repeated expensive checks on the same products.
- **Back Office asset scoping**: admin CSS/JS for the module is only loaded on the module configuration page.

### Fixed

- **Criteria helper compatibility**: added missing namespace imports so `CategoryProductSearchProvider` and Product Search classes resolve correctly.

### Notes (Multistore)

- Module configuration is stored using PrestaShop `Configuration` and follows the current shop context selected in Back Office.
- SQL queries use `context->shop->id` and `*_shop` tables where applicable.
- The module updates `PS_ATTRIBUTE_CATEGORY_DISPLAY` (a PrestaShop core configuration). Its scope depends on your multistore context in Back Office.

## [1.1.1] - 2025-12-24

### Added

- **Admin configuration UI**: configuration split into tabs (General / Display / Criteria & weights / Analytics).
- **Carousel integration**: added optional Slick carousel support with responsive breakpoints and behavior controls.
- **Update checker**: integrated the PP updater component for update notifications in Back Office.

### Changed

- **Recommendation algorithm tuning**: scoring and limits adjusted to better balance multiple criteria in the final list.

## [1.1.0] - 2025-12-16

### Added

- **Multiple recommendation criteria**: tag similarity, same category, top sellers, bought together, accessories, promotions, on sale, highest margin, recently viewed, and same manufacturer.
- **Cart recommendations**: added recommendations block in cart summary.
- **Product list integration**: optional add-to-cart button in product listing contexts (when allowed by availability rules).

### Changed

- **Frontend rendering**: introduced a unified template and product presenter helper to keep product tiles consistent.

## [1.0.0] - 2025-10-01

### Added

- **Initial release**: product-page recommendations block with configurable global limits.
- **Basic caching**: template caching support to reduce repeated rendering.
- **Install/uninstall flow**: default configuration setup and cleanup on uninstall.