Skip to content

Repository files navigation

Simple Product Carousel

A PrestaShop 8.1+/9.x module for building multiple independent product carousels, each rendered through display hooks or the native WidgetInterface — powered by Slick Slider.

Front office: two independent product carousels rendered with the theme's own product cards

Back office: configuring a slider and picking products by drag-and-drop

Why this exists

Most carousel modules give you one slider, one place, one hard-coded look. Real stores need more:

  • How do I show bestsellers on the home page and a hand-picked set in the footer — independently?
  • Can one slider live in several hooks with a different order in each?
  • Can I drop a specific carousel anywhere in my theme without touching the module?
  • Will the product cards still match my theme's prices, promos and buttons?

This module answers all four: any number of sliders, each assignable to multiple hooks with an independent order per hook, embeddable by ID via the PrestaShop widget, rendering product cards through the active theme's own presenter.

Features

Area What you get
Multiple sliders Unlimited independent carousels from one install
Hook assignment Assign a slider to many hooks; drag-and-drop order kept per hook
Widget embed {widget name='simpleproductcarousel' id_slider=3} anywhere in a template
Product sources Category (with subcategories), manual pick, or automatic: bestsellers / new / price drops
Slick options Slides to show/scroll, autoplay, arrows & dots presets, infinite, lazy load, center mode, responsive breakpoints — all validated, no raw JSON field
Theme-native cards Uses PrestaShop's product presenter → correct prices, promos, currencies, per-shop context
Safe by default Assets loaded only on pages with a slider, once per page; graceful fallback if JS/Slick fail

Install

The directory installed in PrestaShop must be named simpleproductcarousel:

<prestashop>/modules/simpleproductcarousel/

Then install from the Back Office module manager, or from the PrestaShop root:

php bin/console prestashop:module install simpleproductcarousel

Requirements

  • PrestaShop: 8.1.0 – 9.x (ps_versions_compliancy 8.1.0 → 9.99.99). Verified on PrestaShop 8.2 and 9.0.3.
  • PHP: 8.1+.
  • Slick Slider 1.8.1 and jQuery are loaded from CDN, only on pages that render a slider. jQuery uses the one provided by PrestaShop/your theme by default; a clearly-warned "force jQuery" fallback is available and off by default.

Development

The module ships with no runtime Composer dependencies — install it as-is. Dev tooling (PHPUnit, PHP_CodeSniffer) lives under require-dev:

composer install       # dev tools only
composer test          # PHPUnit (tests/Integration)
composer cs            # PSR-2 check (phpcs)
composer quality       # cs + test

The PHP sources follow PSR-2 (phpcs.xml.dist) and are covered by PHPUnit integration tests for the database schema and module metadata.

Pro version

Simple Product Carousel Pro installs alongside the free module (separate tables, config keys, controller and assets — both can run in the same shop) and adds a filtered-catalog source:

  • multiple brands combined with OR;
  • multiple values of the same feature combined with OR;
  • different features / filter types combined with AND;
  • optional restriction to one category, with or without subcategories;
  • tags picked through an autocomplete search.

Interested in the Pro build? Reach out: kontakt@breczek-koduje.pl.

Contributing

Corrections and additions welcome — PrestaShop keeps moving. Open an issue or PR with the PrestaShop version you observed.

License

MIT.

Author

Marcin Bręczewski (@Breczek) — WordPress & PrestaShop developer. breczek-koduje.pl · kontakt@breczek-koduje.pl

Support

If this saved you time:

About

Configurable Slick product sliders for PrestaShop 8.1+/9.x — multiple independent carousels via hooks or theme widgets

Topics

Resources

Stars

2 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages