waaz/sylius-hero-plugin

Hero plugin for Sylius - Manage hero sections with slides/blocks.

dev-main 2026-01-19 15:29 UTC

Requires

• php: ^8.1
• sylius/sylius: ~1.14.0

Requires (Dev)

• behat/behat: ^3.6.1
• dbrekelmans/bdi: ^1.1
• dmore/behat-chrome-extension: ^1.3
• dmore/chrome-mink-driver: ^2.7
• friends-of-behat/mink: ^1.8
• friends-of-behat/mink-browserkit-driver: ^1.4
• friends-of-behat/mink-debug-extension: ^2.0.0
• friends-of-behat/mink-extension: ^2.4
• friends-of-behat/page-object-extension: ^0.3
• friends-of-behat/suite-settings-extension: ^1.0
• friends-of-behat/symfony-extension: ^2.1
• friends-of-behat/variadic-extension: ^1.3
• phpspec/phpspec: ^7.2
• phpstan/extension-installer: ^1.0
• phpstan/phpstan: ^1.8.1
• phpstan/phpstan-doctrine: 1.3.69
• phpstan/phpstan-strict-rules: ^1.3.0
• phpstan/phpstan-webmozart-assert: ^1.2.0
• phpunit/phpunit: ^10.5
• polishsymfonycommunity/symfony-mocker-container: ^1.0
• robertfausk/behat-panther-extension: ^1.1
• sylius-labs/coding-standard: ^4.2
• sylius-labs/suite-tags-extension: ^0.2
• symfony/browser-kit: ^5.4 || ^6.4
• symfony/debug-bundle: ^5.4 || ^6.4
• symfony/dotenv: ^5.4 || ^6.4
• symfony/flex: ^2.4
• symfony/intl: ^5.4 || ^6.4
• symfony/web-profiler-bundle: ^5.4 || ^6.4

Conflicts

• symfony/framework-bundle: 6.2.8

MIT

• sylius
• slider
• hero
• sylius-plugin

README

Plugin Sylius pour créer et gérer des sections Hero avec des slides/blocks.

Installation

composer require waaz/sylius-hero-plugin

Après l'installation, exécutez les migrations :

bin/console doctrine:migrations:migrate

Configuration des routes

Pour activer les routes du plugin, ajoutez-les dans votre fichier config/routes.yaml :

waaz_sylius_hero_shop:
    resource: "@WaazSyliusHeroPlugin/config/shop_routing.yml"
    prefix: /{_locale}
    requirements:
        _locale: ^[a-z]{2}(?:_[A-Z]{2})?$

waaz_sylius_hero_admin:
    resource: "@WaazSyliusHeroPlugin/config/admin_routing.yml"
    prefix: /admin

Utilisation

Administration

1. Accédez à l'administration Sylius
2. Dans le menu, vous trouverez "Héros"
3. Créez un nouveau Hero avec un code unique (ex: homepage)
4. Ajoutez des blocks (slides) à votre Hero :
   • Image (obligatoire)
   • Titre (optionnel)
   • Bouton avec texte et URL (optionnel)
   • Position pour l'ordre d'affichage
   • Canal (optionnel, pour filtrer par channel Sylius)
   • Activé/Désactivé

Frontend

Pour afficher un Hero dans un template Twig, utilisez le contrôleur :

{{ render(path('waaz_sylius_hero_shop_hero_index_by_code', {'code': 'homepage'})) }}

Pour utiliser un template personnalisé, passez le paramètre template :

{{ render(path('waaz_sylius_hero_shop_hero_index_by_code', {
    'code': 'homepage',
    'template': '@YourBundle/Shop/hero_custom.html.twig'
})) }}

Personnalisation des templates

Pour personnaliser l'affichage, surchargez le template dans votre application :

templates/bundles/WaazSyliusHeroPlugin/Shop/hero.html.twig

Le template reçoit la variable hero avec :

• hero.code : Le code du Hero
• hero.blocks : Collection des blocks (slides)
  • block.image.path : Chemin de l'image
  • block.title : Titre (optionnel)
  • block.buttonText : Texte du bouton (optionnel)
  • block.buttonUrl : URL du bouton (optionnel)
  • block.buttonTargetBlank : Ouvrir dans un nouvel onglet (optionnel)

Configuration

Le filtre d'image Imagine est configuré automatiquement :

• Filtre : waaz_sylius_hero_shop_hero_image
• Taille : 1920 × 793 px