Co robi moduł i dlaczego warto
- Jedno, kontrolowane miejsce rekomendacji – spójny blok na stronie produktu i w koszyku (zamiast rozproszonych sugestii).
- Dobór na podstawie reguł – rekomendacje wynikają z kryteriów, wag i limitów, a nie z ręcznego „dobierania na oko”.
- Dostępność pod kontrolą – opcje „Dodaj do koszyka” oraz filtr „tylko dodawalne” ograniczają frustrację i martwe kliknięcia.
- Skalowanie bez pracy operacyjnej – wynik jest cache’owany i odświeżany po zmianach w produktach.
- Bez konfliktów z motywem – karuzela może działać na Slick, ale można wyłączyć ładowanie biblioteki, jeśli motyw ma ją już wgraną.
Zastosowania modułu
- Sklepy z szerokim katalogiem, gdzie kluczowe jest szybkie podpowiadanie produktów bez ręcznej kuracji list.
- Branże z zakupami komplementarnymi (np. akcesoria), gdzie liczy się skuteczny cross‑sell i „kupowane razem”.
- Sklepy prowadzące promocje i wyprzedaże, które chcą eksponować produkty z rabatami w logicznym kontekście.
- Sklepy B2B/B2C wymagające spójnej prezentacji oferty na urządzeniach mobilnych i desktop.
Funkcjonalności – Back Office
1. Nagłówki bloku
Ustawiasz, jak nazywa się sekcja rekomendacji w dwóch miejscach
- Osobny nagłówek dla strony produktu oraz koszyka.
- Wielojęzyczność – nagłówki zależne od języka sklepu.
- Fallback – gdy nagłówek jest pusty, moduł użyje tekstu domyślnego.
2. Limity wyświetlania (desktop/mobile + per kryterium)
Kontrolujesz liczbę produktów, żeby blok był skuteczny i nie przeciążał strony.
- Globalny limit osobno dla desktop i mobile.
- Limit per kryterium – każde źródło rekomendacji ma własny „cap”, żeby nie zdominowało wyniku.
3. Dodaj do koszyka + dostępność (jedna, spójna logika)
Ustalasz, kiedy produkt może zostać dodany do koszyka i czy produkty bez możliwości zakupu mają być ukrywane.
- Aktywacja przycisku „Dodaj do koszyka” + Walidacja – przycisk pojawia się tylko, gdy produkt spełnia warunki zakupu.
- Filtr „tylko możliwe do zakupu” – opcjonalnie usuwa produkty z rekomendowanych które są bez możliwości "Dodania do koszyka".
- Produkty z atrybutami – możliwość wyświetlenia przycisku "Dodaj do koszyka" dla produktów które zawierają warianty.
4. Wygląd bloku: siatka lub karuzela (Slick)
Dobierasz UX pod katalog: szybki przegląd w siatce albo przewijanie w karuzeli.
- Tryb siatki lub tryb karuzeli – bez zmian w motywie (kompatybilność theme Classic).
- Slick – moduł może ładować bibliotekę lub tylko ją inicjalizować (gdy motyw już maw w komplecie karuzele Slick).
- Responsywność – breakpointy i liczba widocznych produktów.
- Zachowanie karuzeli – autoplay, prędkości, strzałki/paginacja, pętla, przewijanie.
5. Kryteria rekomendacji (10) + wagi/limity + „From category”
Budujesz logikę doboru produktów: wybierasz źródła rekomendacji i ustawiasz ich wpływ na wynik.
- 10 kryteriów : tagi, kategoria, bestsellery, kupowane razem, akcesoria, promocje, on sale, marża, ostatnio oglądane, producent.
- Aktywacja / Waga / Limit dla każdego kryterium.
- „From category” (gdzie dostępne) – zawężenie do kategorii kontekstu: produkt (kategoria produktu) / koszyk (kategorie produktów w koszyku).
6. Analytics konfiguracji
Szybko weryfikujesz, jak obecne ustawienia „rozstawiają akcenty” między kryteriami.
- Podgląd aktywnych kryteriów i ich parametrów.
- Influence % – procentowy udział wagi w sumie wag aktywnych kryteriów.
- Podsumowanie limitów dla desktop/mobile.
7. Cache, odświeżanie i aktualizacje
Blok jest szybki w działaniu i sam dba o aktualność po zmianach w katalogu.
- Cache osobno dla strony produktu i koszyka.
- Automatyczne czyszczenie cache po dodaniu/edycji/usunięciu produktu.
- PPUpdater – informacja o dostępnych aktualizacjach w panelu modułu.
Funkcjonalności – Front Office
1. Gdzie blok się wyświetla
Rekomendacje pojawiają się tam, gdzie użytkownik najczęściej podejmuje decyzję o zakupie.
- Strona produktu – rekomendacje w kontekście oglądanego produktu.
- Koszyk – sugestie tuż przed finalizacją zamówienia.
2. Spójny wygląd z motywem
Moduł nie narzuca własnego „widgetu” – wykorzystuje standardową prezentację produktów.
- Miniatury produktów w strukturze zgodnej z motywem (spójny UI).
- Nagłówek z konfiguracji – osobno dla produktu i koszyka.
3. Siatka lub karuzela (Slick)
Ten sam zestaw produktów może być pokazany jako siatka lub jako karuzela – zależnie od konfiguracji.
- Siatka – szybki przegląd wielu produktów.
- Karuzela Slick – przewijanie i konfiguracja zachowania oraz responsywności.
4. „Dodaj do koszyka” (rekomendacje + listing)
Moduł może skrócić drogę do zakupu, ale tylko tam, gdzie dodanie jest realnie możliwe.
- Przycisk w rekomendacjach – jeśli włączony w konfiguracji.
- Przycisk na listingu – moduł może wstrzyknąć „Dodaj do koszyka” także w listach produktów.
- Brak martwych klików – przycisk jest pokazywany tylko dla produktów spełniających warunki dodania.
- Opcja „tylko dodawalne” – dodatkowo ogranicza rekomendacje do produktów możliwych do zakupu.
Automatyzacja i logika działania
- Rekomendacje są budowane z aktywnych kryteriów oraz ustawień wag i limitów.
- Ten sam produkt może pojawić się w kilku kryteriach – wtedy jego wynik się sumuje i stabilnie rośnie w rankingu.
- W zależności od ustawień moduł weryfikuje „dodawalność” produktu (dla przycisku i/lub filtrowania listy).
- Całość jest cache’owana i odświeżana automatycznie po zmianach w produktach.
Wpływ na sprzedaż i SEO
- Więcej produktów w koszyku – dodatkowa ekspozycja w koszyku zwiększa szansę na dodanie pozycji komplementarnych.
- Mniej „martwych klików” – opcja „tylko dodawalne” ogranicza sytuacje, w których użytkownik nie może dodać sugerowanego produktu.
- Stabilna sekcja treści – rekomendacje tworzą powtarzalny blok contentu na stronach o wysokiej wartości SEO (produkt/koszyk).
- Lepsza kontrola ekspozycji – wagi i limity pozwalają testować układ rekomendacji i porównywać efekty w analityce sklepu.
Dla kogo jest ten moduł?
- Handlowcy – do uporządkowania cross‑sell i zwiększania wartości koszyka bez ręcznego ustawiania list.
- Administratorzy – do bezpiecznej konfiguracji rekomendacji, kontroli dostępności i łatwego utrzymania.
- Deweloperzy PrestaShop – do wdrożeń, które wymagają przewidywalnego zachowania, cache i minimalnych konfliktów z motywem.
- Specjaliści SEO – do budowania spójnych sekcji treści na kluczowych stronach i wspierania widoczności ofert.
Podsumowanie i CTA
Jeśli chcesz wdrożyć rekomendacje oparte o jasne reguły oraz utrzymać kontrolę nad tym, co użytkownik widzi na karcie produktu i w koszyku, skonfiguruj PPSmartRecommendations i ustaw kryteria zgodnie z ofertą sklepu.
Wezwanie do działania: Zainstaluj moduł i rozpocznij konfigurację kryteriów oraz limitów pod swoje cele sprzedażowe.
Uwaga!
Przed instalacją lub aktualizacją wykonaj kopię bezpieczeństwa plików i bazy danych. Jeśli motyw ładuje Slick, wyłącz w module opcję ładowania biblioteki, aby uniknąć konfliktów i podwójnych assetów. Po zmianach konfiguracji zweryfikuj wygląd na mobile/desktop.
## [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.
