odiseoteam / sylius-banner-plugin

v2.1.1 2026-09-21 14:58 UTC

Requires

• php: ^8.2
• sylius/sylius: ~2.0.0

Requires (Dev)

• behat/behat: ^3.16
• dmore/behat-chrome-extension: ^1.4
• dmore/chrome-mink-driver: ^2.9
• friends-of-behat/mink: ^1.11
• friends-of-behat/mink-browserkit-driver: ^1.6
• friends-of-behat/mink-debug-extension: ^2.1
• friends-of-behat/mink-extension: ^2.7
• friends-of-behat/page-object-extension: ^0.3
• friends-of-behat/suite-settings-extension: ^1.1
• friends-of-behat/symfony-extension: ^2.6
• friends-of-behat/variadic-extension: ^1.6
• nyholm/psr7: ^1.8
• phpspec/phpspec: ^7.5
• phpstan/phpstan: ^1.12
• phpstan/phpstan-doctrine: ^1.3
• phpstan/phpstan-webmozart-assert: ^1.2
• phpunit/phpunit: ^10.5
• robertfausk/behat-panther-extension: ^1.1
• sylius-labs/coding-standard: ^4.4
• sylius-labs/suite-tags-extension: ~0.2
• sylius/sylius-rector: ^2.0
• symfony/browser-kit: ^6.4 || ^7.1
• symfony/debug-bundle: ^6.4 || ^7.1
• symfony/dotenv: ^6.4 || ^7.1
• symfony/flex: ^2.4
• symfony/http-client: ^6.4 || ^7.1
• symfony/intl: ^6.4 || ^7.1
• symfony/web-profiler-bundle: ^6.4 || ^7.1
• symfony/webpack-encore-bundle: ^2.2

MIT

• sylius
• sylius-plugin
• sylius-banner

Published on Packagist.org on 2026-09-21 14:58 UTC

README

Description

This is a Sylius Plugin that add banners to your store. The banners are fully customizable by the admin.

Features:

• Templates: Show all images or by taxon.

• Sliders: We are providing the integration with Swiper.js.

Supported versions:

Package	Version
PHP	^8.2
sylius/sylius	^2.0

Screenshots

Demo

Want a live walkthrough of this plugin? Get in touch — or browse all our Sylius plugins at odiseo.io.

Configuration

Images

The banner images are rendered through LiipImagine. By default the plugin serves them as WebP, with quality 80 for the desktop filter set and 75 for the mobile one. You can change it from your application:

# config/packages/odiseo_sylius_banner.yaml
odiseo_sylius_banner:
    images:
        format: webp # null keeps the format of the uploaded file
        quality: 80
        mobile_quality: 75

Upgrading from 2.0: previously no format or quality was declared, so the images were served in their original format with quality 100. Set format: null and quality: 100 to keep the old behaviour. The uploaded file is always stored as it is, only the rendered image changes.

Order

Banners have a position field. They are rendered from the lowest position to the highest one, using the id as a tie-breaker, and the position is editable from the admin panel. The admin grid is sorted by position as well.

Documentation

• Installation

Credits

This plugin is maintained by Odiseo. Want us to help you with this plugin or any Sylius project? Get in touch.