PHPackages vanssa/sylius-slider-plugin - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Utility & Helpers](/categories/utility) 4. / 5. vanssa/sylius-slider-plugin ActiveSylius-plugin[Utility & Helpers](/categories/utility) vanssa/sylius-slider-plugin =========================== Vanssa Sylius Slider plugin. 2.2.7(4mo ago)126[1 PRs](https://github.com/vanssata/sylius-slider-plugin/pulls)MITPHPPHP >=8.3CI failing Since Feb 15Pushed 1mo agoCompare [ Source](https://github.com/vanssata/sylius-slider-plugin)[ Packagist](https://packagist.org/packages/vanssa/sylius-slider-plugin)[ RSS](/packages/vanssa-sylius-slider-plugin/feed)WikiDiscussions main Synced today READMEChangelog (1)Dependencies (31)Versions (15)Used By (0) Vanssa Sylius Slider Plugin =========================== [](#vanssa-sylius-slider-plugin) A Sylius plugin for building and managing rich storefront sliders with: - Slider and Slide admin management - Translatable slide content and settings - Image and video slide support - Symfony UX-based storefront rendering - Twig Hooks integration for Sylius Admin/Shop - Optional integrations with Sylius CMS Plugin and Sylius Rich Editor Plugin System Requirements ------------------- [](#system-requirements) DependencyVersionPHP`>= 8.3`Sylius`^2.2`Symfony`^7.4`Node.js`>= 20`Yarn`>= 1.22`Installation in Sylius-Standard (2.2) ------------------------------------- [](#installation-in-sylius-standard-22) 1. Install the package: ``` composer require vanssa/sylius-slider-plugin ``` 2. Enable the bundle (if not handled by your Flex recipe): ``` // config/bundles.php return [ // ... Vanssa\SyliusSliderPlugin\VanssaSyliusSliderPlugin::class => ['all' => true], ]; ``` 3. Import plugin configuration: ``` # config/packages/vanssa_sylius_slider.yaml imports: - { resource: '@VanssaSyliusSliderPlugin/config/config.yaml' } ``` 4. Import routes: ``` # config/routes/vanssa_sylius_slider.yaml vanssa_sylius_slider_admin: resource: '@VanssaSyliusSliderPlugin/config/routes/admin.yaml' prefix: /admin vanssa_sylius_slider_shop: resource: '@VanssaSyliusSliderPlugin/config/routes/shop.yaml' ``` 5. Run database migrations: ``` bin/console doctrine:migrations:migrate -n ``` 6. Add plugin frontend package in your Sylius-Standard project: ``` yarn add @vanssa/sylius-slider-plugin@file:vendor/vanssa/sylius-slider-plugin/assets ``` 7. Register plugin Stimulus controllers in `assets/controllers.json`: ``` { "controllers": { "@vanssa/sylius-slider-plugin": { "slider": { "enabled": true, "fetch": "eager", "autoimport": { "@vanssa/sylius-slider-plugin/shop/styles/slider.scss": true } }, "slide-preview": { "enabled": true, "fetch": "eager", "autoimport": { "@vanssa/sylius-slider-plugin/admin/styles/slide_preview.scss": true } }, "slider-settings": { "enabled": true, "fetch": "eager" }, "slider-slides-preview": { "enabled": true, "fetch": "eager" }, "rgba-color-picker": { "enabled": true, "fetch": "eager", "autoimport": { "@vanssa/sylius-slider-plugin/admin/styles/rgba_color_picker.scss": true, "@simonwep/pickr/dist/themes/classic.min.css": true } } } }, "entrypoints": [] } ``` 8. Build frontend assets: ``` yarn install yarn build bin/console assets:install ``` 9. Clear cache: ``` bin/console cache:clear ``` 10. Add slider on homepage (optional): ``` # config/packages/vanssa_sylius_slider.yaml ... sylius_twig_hooks: hooks: 'sylius_shop.homepage.index': banner: enabled: false vanssa_sylius_slider_homepage: component: 'vanssa_sylius_slider:shop:homepage_slider' props: code: 'homepage-main' priority: 400 ``` Notes for Sylius-Standard: - Keep your existing controller entries (for example `@symfony/ux-live-component` and `@symfony/ux-autocomplete`) and only add the `@vanssa/sylius-slider-plugin` block. - If your project customizes webpack configs, ensure `assets/controllers.json` is the file passed to `enableStimulusBridge(...)`. Preset Configuration -------------------- [](#preset-configuration) The plugin exports slider/slide preset values and defaults via plugin config: - File: `config/packages/vanssa_sylius_slider.yaml` - Root key: `vanssa_sylius_slider.presets` Each preset contains: - `values`: allowed values used by form choices - `default`: default value used when creating new entities You can override any preset in your project config. Color switcher presets are available under: - `vanssa_sylius_slider.presets.color_switcher.theme` - `vanssa_sylius_slider.presets.color_switcher.default_representation` - `vanssa_sylius_slider.presets.color_switcher.swatches.text|neutral|accent` Slider behavior presets also include: - `vanssa_sylius_slider.presets.slider.parallax_strength`Optional parallax levels (for example: `0.5rem`, `1rem`, `2rem`, `3rem`, `4rem`). If not set, parallax is disabled. Reusable Color Picker Field --------------------------- [](#reusable-color-picker-field) Use `Vanssa\SyliusSliderPlugin\Form\Type\ColorPickerType` in any form field. - `picker_swatches`: predefined swatches shown in picker - `picker_theme`: Pickr theme (`classic`, `monolith`, `nano`) - `picker_options`: raw Pickr options map passed to `Pickr.create(...)` - `picker_predefined_only`: allow only colors from `picker_swatches` Because `picker_options` is passed through, you can configure any supported Pickr option from . Detailed Guides --------------- [](#detailed-guides) - [Color Picker Type](docs/COLOR_PICKER_TYPE.md) - [Screenshots](docs/SCREENSHOTS.md) - [Flex Recipe](docs/FLEX_RECIPE.md) - [Extending](docs/EXTENDING.md) - [Contributing](docs/CONTRIBUTING.md) Admin Usage ----------- [](#admin-usage) After installation, in admin you can manage: - `Sliders`: `/admin/sliders` - `Slides`: `/admin/slides` Typical flow: 1. Create slides (media, translated text, styling/options). 2. Create a slider. 3. Assign/reorder slides in slider edit page. 4. Render slider in storefront by code. Storefront Usage ---------------- [](#storefront-usage) ### Route-based rendering [](#route-based-rendering) - Full slider page: `/slider/{code}` - Banner-like single slide page: `/banner/{code}` ### Twig usage [](#twig-usage) Use Twig component: ``` {{ component('vanssa_sylius_slider:shop:slider', { slider: slider, localeCode: app.request.locale, fallbackLocaleCode: sylius.channel.defaultLocale.code|default(null) }) }} ``` Or homepage component: ``` {{ component('vanssa_sylius_slider:shop:homepage_slider', { code: 'homepage-main' }) }} ``` Demo Fixtures ------------- [](#demo-fixtures) The plugin provides a dedicated fixtures suite: - Suite name: `vanssa_sylius_slider_demo` - Fixture name: `vanssa_slider_demo` Load demo fixtures: ``` bin/console sylius:fixtures:load --suite=vanssa_sylius_slider_demo -n ``` This creates 3 sliders with shared and non-shared slides, including image and video examples. Fixture media is shipped in: - `tests/TestApplication/public/media/fixtures/automotive` License for fixture media: - `tests/TestApplication/public/media/fixtures/automotive/LICENSE.md` Testing ------- [](#testing) ### Unit tests [](#unit-tests) ``` vendor/bin/phpunit ``` ### Behat [](#behat) ``` vendor/bin/behat --strict --tags='@slider_admin' vendor/bin/behat --strict --tags='@slider_frontend' ``` For JS scenarios (if enabled in your CI/project): ``` vendor/bin/behat --strict --tags='@javascript,@mink:chromedriver' ``` Optional Integrations --------------------- [](#optional-integrations) - Sylius CMS Plugin: - Use `@VanssaSyliusSliderPlugin/shop/integration/cms/slider_block.html.twig` - Monsieur Biz Rich Editor Plugin: - Description fields use rich editor type automatically when installed. Publishing Notes ---------------- [](#publishing-notes) For package maintainers: - Extension guide: `docs/EXTENDING.md` - Contribution guide: `docs/CONTRIBUTING.md` - Symfony Flex recipe scaffold: `docs/FLEX_RECIPE.md` and `flex/recipes/vanssa/sylius-slider-plugin/1.0` ### Health Score 42 — FairBetter than 88% of packages Maintenance84 Actively maintained with recent releases Popularity11 Limited adoption so far Community6 Small or concentrated contributor base Maturity57 Maturing project, gaining track record Bus Factor1 Top contributor holds 100% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~0 days Total 9 Last Release 138d ago PHP version history (2 changes)2.2.1PHP ^8.2 2.2.0PHP >=8.3 ### Community Maintainers ![](https://www.gravatar.com/avatar/4180b0d965236f47306d3a0b27309b750e16d1f1d6c42c60276503fce3e413b7?d=identicon)[vanssata](/maintainers/vanssata) --- Top Contributors [![vanssata](https://avatars.githubusercontent.com/u/1220804?v=4)](https://github.com/vanssata "vanssata (28 commits)") --- Tags syliussylius-pluginsylius-slidersyliusslidersylius-pluginautomotive ### Code Quality TestsPHPUnit Static AnalysisPHPStan Type Coverage Yes ### Embed Badge ![Health badge](/badges/vanssa-sylius-slider-plugin/health.svg) ``` [![Health](https://phpackages.com/badges/vanssa-sylius-slider-plugin/health.svg)](https://phpackages.com/packages/vanssa-sylius-slider-plugin) ``` ### Alternatives [sylius/refund-plugin Plugin provides basic refunds functionality for Sylius application. 701.8M20](/packages/sylius-refund-plugin)[stefandoorn/sitemap-plugin Sitemap Plugin for Sylius 841.1M1](/packages/stefandoorn-sitemap-plugin)[monsieurbiz/sylius-rich-editor-plugin A Rich Editor plugin for Sylius. 75416.2k6](/packages/monsieurbiz-sylius-rich-editor-plugin)[odiseoteam/sylius-vendor-plugin Vendor plugin for Sylius. Add Vendor (Brand) to your products 6068.4k1](/packages/odiseoteam-sylius-vendor-plugin)[synolia/sylius-scheduler-command-plugin Scheduler Command Plugin. 35389.6k](/packages/synolia-sylius-scheduler-command-plugin)[stefandoorn/sylius-google-tag-manager-enhanced-ecommerce-plugin Google Tag Manager Enhanced Ecommerce plugin for Sylius. 42247.7k](/packages/stefandoorn-sylius-google-tag-manager-enhanced-ecommerce-plugin) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)