Feature-rich responsive slider plugin for Sylius 2 with translatable image and video slides, live admin previews, Symfony UX rendering, Twig Hooks, and optional CMS integrations.
A Sylius 2.x plugin for building and managing rich storefront sliders and banners: a two-column admin workspace with a live preview, per-breakpoint media and layout, per-locale overrides, one-click style presets, content animations and video slides (self-hosted or YouTube) — rendered on the storefront through Symfony UX (Stimulus + Twig Components) and Twig Hooks.
Feature tour
Editing workspace — live preview with the settings drawer (toolbar-driven breakpoints and languages, live draft refresh):
Style preset try-on — hovering a preset in the toolbar previews it on the actual banner, click applies it:
Storefront slider, and the same slide re-laid-out per breakpoint:
What it does
youtube-nocookie player); the provider layer is extensible.vanssa-slider Stimulus controller; every admin-configured value is exposed as a CSS custom property or data attribute for theming.Full option-by-option reference: docs/usage/options-reference.md.
Requirements
| Dependency | Version |
|---|---|
| PHP | >= 8.3 |
| Sylius | ^2.1 |
| Symfony | ^7.4 |
symfony/ux-turbo |
^2.22 |
| Node.js | >= 20 (Yarn Classic v1) |
The frontend requires an Encore + @symfony/stimulus-bridge build
(the Sylius-Standard default). AssetMapper is not supported — the plugin ships no importmap entries.
composer.json temporarily pins
api-platform/metadata,
api-platform/symfony,
api-platform/doctrine-common and
api-platform/doctrine-orm
below 4.3 via a
conflict block: a fresh install resolving api-platform
4.3.x breaks
cache:warmup in Sylius's ApiBundle routing.
Keep those sub-packages below 4.3 in your project until the pin is lifted.
Install
composer config --json extra.symfony.endpoint '["https://raw.githubusercontent.com/vanssata/sylius-slider-plugin/2.3/flex/index.json","flex://defaults"]'
composer require vanssa/sylius-slider-plugin
bin/console doctrine:migrations:migrate -n
yarn install && yarn build && bin/console assets:install
The Flex recipe registers the bundle, imports the config and mounts the admin and shop routes; core Flex's
PackageJsonSynchronizer
wires the 14 Stimulus controllers into your
assets/controllers.json.
Manual wiring, the frontend contract and the optional Twig Hooks homepage integration are in
docs/usage/getting-started.md;
docs/FLEX_RECIPE.md
explains what the endpoint resolves and writes.
Documentation
Using the plugin
- Getting started — install, first slider, demo fixtures
- Admin guide — the editing workspace, section by section
- Style presets — gallery, try-on, admin-managed vs config
- Storefront — routes, hooks, breakpoints, video slides
- Options reference — every option, value and default
Extending the plugin
- Architecture — layers and where things live
- Adding a Stimulus controller — the four manifests
- Extending — templates, services, form fields, providers
- Style presets — defining presets in config
- Color picker type — the reusable RGBA field
- Testing — PHPUnit, Behat, Playwright and when to use which
- Docs media — regenerating the screenshots and GIFs
- Contributing — local setup and release flow
- Flex recipe — how the recipe endpoint works
Upgrading
composer update vanssa/sylius-slider-plugin
bin/console doctrine:migrations:migrate -n
yarn install && yarn build && bin/console assets:install
Yarn Classic copies file:
dependencies instead of symlinking them, so run
yarn install --force
if a rebuild does not pick up plugin asset changes. Check
CHANGELOG.md
for new config keys, migrations or controller manifest changes.
License
MIT — see LICENSE. The Sylius trademark and logo are covered by LICENSE_OF_TRADEMARK_AND_LOGO.
Reviews
No reviews yet. Be the first to review this product!
© 2026 Sylius. All rights reserved.
