UPGRADING FROM v2.0.13 TO v2.0.14

Telemetry

Sylius 2.0.14 introduces anonymous telemetry to help us understand how Sylius is used and improve the platform.

What data is collected:

• Anonymous installation ID (hashed, non-reversible)
• Sylius and PHP versions, default locale
• Aggregated statistics as segments (broad ranges, not exact values):
  • Customers/products/variants count (e.g., "1K-10K", "100K-1M")
  • GMV and AOV ranges per month (e.g., "100K-500K", "50-100")

No sensitive data is ever collected - no customer information, no order details, no personal data.

Configuration:

Telemetry is enabled by default and uses a default salt for hashing the installation ID.

To disable telemetry, set the following environment variable in your .env file:

SYLIUS_TELEMETRY_ENABLED=0

To change the salt, set the SYLIUS_TELEMETRY_SALT environment variable:

SYLIUS_TELEMETRY_SALT=your-custom-salt

Database migration (optional):

This release includes an optional database migration that adds an index to improve telemetry query performance. The telemetry system works without this index, but adding it will make data collection faster, especially for stores with large order volumes.

To run the migration:

php bin/console doctrine:migrations:migrate

If you want to skip this migration:

php bin/console doctrine:migrations:version 'Sylius\Bundle\CoreBundle\Migrations\Version20251126120000' --add --no-interaction

# For PostgreSQL:
php bin/console doctrine:migrations:version 'Sylius\Bundle\CoreBundle\Migrations\Version20251126120001' --add --no-interaction

For more details, see the Telemetry documentation.

UPGRADE FROM 2.0.5 TO 2.0.6

Behat

1. The context classes have been refactored. All UI occurrences of the following step definitions have been removed:

• @When I save my changes
• @When I try to save my changes

These have been replaced by the new common context class: Sylius\Behat\Context\Ui\SaveContext identified by the id sylius.behat.context.ui.save.

If you use any of the removed methods, please update your suite configuration to include the new context class:

your_behat_profile:
    suites:
        your_suite_name:
            contexts:
                - ...
+               - sylius.behat.context.ui.save

UPGRADE FROM 2.0.2 TO 2.0.3

1. New left and right sections have been added to the following Twig hooks to improve customization:

   • sylius_admin.admin_user.create.content.form.sections
   • sylius_admin.admin_user.update.content.form.sections
   • sylius_admin.customer.create.content.form.sections
   • sylius_admin.customer.update.content.form.sections

   Hooks previously attached to the sections hook are now divided into left and right sections. This change doesn't affect to the original hook names.

   For example, the account hook previously attached to sylius_admin.admin_user.create.content.form.sections is now located in sylius_admin.admin_user.create.content.form.sections#left, but its name remains sylius_admin.admin_user.create.content.form.sections.account.

UPGRADE FROM 2.0.0 TO 2.0.1

Frontend

1. Flags have been removed from languages - it resolves all ambiguity and ensures a consistent and straightforward language selection experience. This approach reduces maintenance complexity and eliminates the risk of incorrect or misleading flag assignments.

UPGRADE FROM 1.14 TO 2.0

To start off

Even if your app is barely customized, it will require some manual adjustments before it can run again. Depending on whether you use Symfony Flex, some of these changes may be applied automatically, but it’s important to check them manually regardless.

• Packages configuration changes:

# config/packages/_sylius.yaml

imports:
...
+   - { resource: "@SyliusPayumBundle/Resources/config/app/config.yaml" }

...

sylius_payment:
    resources:
+       gateway_config:
+           classes:
+               model: App\Entity\Payment\GatewayConfig

...

sylius_payum:
    resources:
-       gateway_config:
-           classes:
-               model: App\Entity\Payment\GatewayConfig

• API firewalls have been renamed and user checkers have been configured on them with security.user_checker.chain.<firewall> service:

# config/packages/security.yaml

security:
    firewalls:
        admin:
            ...
+           user_checker: security.user_checker.chain.admin
-       new_api_admin_user:
+       api_admin:
            ...
+           user_checker: security.user_checker.chain.api_admin
-       new_api_shop_user:
+       api_shop:
            ...
+           user_checker: security.user_checker.chain.api_shop
        shop:
            ...
+           user_checker: security.user_checker.chain.shop

• Routing changes (note that these shop routes are not localized with the prefix: /{_locale} configuration entry):

Shop:

# config/routes/sylius_shop.yaml

sylius_shop_payum:
-   resource: "@SyliusShopBundle/Resources/config/routing/payum.yml"
+   resource: "@SyliusPayumBundle/Resources/config/routing/integrations/sylius_shop.yaml"

+sylius_payment_notify:
+   resource: "@SyliusPaymentBundle/Resources/config/routing/integrations/sylius.yaml"

API:

# config/routes/sylius_api.yaml

sylius_api:
    resource: "@SyliusApiBundle/Resources/config/routing.yml"
-   prefix: "%sylius.security.new_api_route%"
+   prefix: "%sylius.security.api_route%"

• Bundle configuration changes:

# config/bundles.php

<?php

return [
-   Sylius\Calendar\SyliusCalendarBundle::class => ['all' => true],
-   winzou\Bundle\StateMachineBundle\winzouStateMachineBundle::class => ['all' => true],
-   Bazinga\Bundle\HateoasBundle\BazingaHateoasBundle::class => ['all' => true],
-   JMS\SerializerBundle\JMSSerializerBundle::class => ['all' => true],
-   FOS\RestBundle\FOSRestBundle::class => ['all' => true],
-   ApiPlatform\Core\Bridge\Symfony\Bundle\ApiPlatformBundle::class => ['all' => true],
-   SyliusLabs\Polyfill\Symfony\Security\Bundle\SyliusLabsPolyfillSymfonySecurityBundle::class => ['all' => true],
+   ApiPlatform\Symfony\Bundle\ApiPlatformBundle::class => ['all' => true],
+   Sylius\TwigHooks\SyliusTwigHooksBundle::class => ['all' => true],
+   Symfony\UX\TwigComponent\TwigComponentBundle::class => ['all' => true],
+   Symfony\UX\StimulusBundle\StimulusBundle::class => ['all' => true],
+   Symfony\UX\LiveComponent\LiveComponentBundle::class => ['all' => true],
+   Symfony\UX\Autocomplete\AutocompleteBundle::class => ['all' => true],
];

• New Symfony/Messenger transports for handling payment requests have been added. Therefore, you need to add the following configuration to your .env file:

###> symfony/messenger ###
...
+ SYLIUS_MESSENGER_TRANSPORT_PAYMENT_REQUEST_DSN=sync://
+ SYLIUS_MESSENGER_TRANSPORT_PAYMENT_REQUEST_FAILED_DSN=sync://
###< symfony/messenger ###

Migrations

Doctrine migrations have been regenerated, meaning all previous migration files have been removed and their content is now in a single migration file. To apply the new migration and get rid of the old entries run migrations as usual:

    bin/console doctrine:migrations:migrate --no-interaction

PHP support

Sylius 2.0 comes with a bump of minimum supported PHP version to 8.2.

Symfony support

The support of Symfony 5.4 has been dropped. Sylius 2.0 supports both Symfony 6.4 and 7.1

Main Update

Once you’ve applied these initial changes, your app should be able to run. However, depending on the customizations you’ve made, you may need to make some additional adjustments. Carefully review the following changes and apply them to your app as necessary.

Dependencies

Replaced:

• The swiftmailer/swiftmailer dependency has been removed. Use symfony/mailer instead.

Moved:

• The sylius/theme-bundle dependency has been moved from CoreBundle to ShopBundle.

Removed:

• Removed from main composer.json:

  • payum/paypal-express-checkout-nvp
  • payum/stripe
  • stripe/stripe-php

• Removed from bundles:

  • AdminBundle:
    • twig/intl-extra
  • ApiBundle:
    • sylius/payum-bundle
  • AttributeBundle:
    • friendsofsymfony/rest-bundle
    • jms/serializer-bundle
  • ChannelBundle:
    • friendsofsymfony/rest-bundle
    • jms/serializer-bundle
  • CoreBundle:
    • sylius/payum-bundle
    • sylius/theme-bundle
    • sylius/ui-bundle
    • symfony/templating
    • jms/serializer-bundle
    • sonata-project/block-bundle
    • sylius-labs/polyfill-symfony-framework-bundle
  • CurrencyBundle:
    • friendsofsymfony/rest-bundle
    • jms/serializer-bundle
    • symfony/templating
  • InventoryBundle:
    • friendsofsymfony/rest-bundle
    • jms/serializer-bundle
    • symfony/templating
  • LocaleBundle:
    • friendsofsymfony/rest-bundle
    • jms/serializer-bundle
    • symfony/templating
  • MoneyBundle:
    • friendsofsymfony/rest-bundle
    • jms/serializer-bundle
    • symfony/templating
  • OrderBundle:
    • sylius-labs/polyfill-symfony-framework-bundle
    • symfony/templating
  • PayumBundle:
    • sylius/core
  • ProductBundle
    • friendsofsymfony/rest-bundle
    • jms/serializer-bundle
  • PromotionBundle
    • sylius/calendar
  • ShippingBundle
    • sylius/calendar
  • ShopBundle
    • twig/intl-extra
  • TaxationBundle
    • sylius/calendar
  • UiBundle
    • sonata-project/block-bundle
    • sylius-labs/polyfill-symfony-event-dispatcher
    • sylius-labs/polyfill-symfony-framework-bundle
    • symfony/templating
  • UserBundle
    • sylius-labs/polyfill-symfony-event-dispatcher
    • sylius-labs/polyfill-symfony-framework-bundle

Optional

• Winzou State Machine repositories have been moved to the suggested section of composer.json, if you still want to use them, install the following:

  • winzou/state-machine
  • winzou/state-machine-bundle

Constructors signature changes

1. The following constructor signatures have been changed:

   Sylius\Bundle\CoreBundle\Twig\CheckoutStepsExtension

   diffCopy

   
   use Sylius\Component\Core\Checker\OrderPaymentMethodSelectionRequirementCheckerInterface;
   use Sylius\Component\Core\Checker\OrderShippingMethodSelectionRequirementCheckerInterface;
   
       public function __construct(
   -       private readonly CheckoutStepsHelper|OrderPaymentMethodSelectionRequirementCheckerInterface $checkoutStepsHelper,
   -       private readonly ?OrderShippingMethodSelectionRequirementCheckerInterface $orderShippingMethodSelectionRequirementChecker = null,
   +       private readonly OrderPaymentMethodSelectionRequirementCheckerInterface $orderPaymentMethodSelectionRequirementChecker,
   +       private readonly OrderShippingMethodSelectionRequirementCheckerInterface $orderShippingMethodSelectionRequirementChecker,
       )
   

   Sylius\Bundle\CoreBundle\Twig\PriceExtension

   diffCopy

   
   use Sylius\Component\Core\Calculator\ProductVariantPricesCalculatorInterface;
   
       public function __construct(
   -       private readonly PriceHelper|ProductVariantPricesCalculatorInterface $helper,
   +       private readonly ProductVariantPricesCalculatorInterface $productVariantPricesCalculator,
       )
   

   Sylius\Bundle\CoreBundle\Twig\VariantResolverExtension

   diffCopy

   
   use Sylius\Component\Product\Resolver\ProductVariantResolverInterface;
   
       public function __construct(
   -       private readonly ProductVariantResolverInterface|VariantResolverHelper $helper,
   +       private readonly ProductVariantResolverInterface $productVariantResolver,
       )
   

   Sylius\Bundle\CurrencyBundle\Twig\CurrencyExtension

   diffCopy

   
       public function __construct(
   -       private ?CurrencyHelperInterface $helper = null,
       )
   

   Sylius\Bundle\InventoryBundle\Twig\InventoryExtension

   diffCopy

   use Sylius\Component\Inventory\Checker\AvailabilityCheckerInterface;
   
       public function __construct(
   -       private AvailabilityCheckerInterface|InventoryHelper $helper,
   +       private AvailabilityCheckerInterface $availabilityChecker,
       )
   

   Sylius\Bundle\LocaleBundle\Twig\LocaleExtension

   diffCopy

   use Sylius\Component\Locale\Context\LocaleContextInterface;
   use Sylius\Component\Locale\Converter\LocaleConverterInterface;
   
       public function __construct(
   -       private LocaleConverterInterface|LocaleHelperInterface $localeHelper,
   -       private ?LocaleContextInterface $localeContext = null,
   +       private LocaleConverterInterface $localeConverter,
   +       private LocaleContextInterface $localeContext,
       )
   

   Sylius\Bundle\MoneyBundle\Twig\ConvertMoneyExtension

   diffCopy

   use Sylius\Component\Currency\Converter\CurrencyConverterInterface;
   
       public function __construct(
   -       private ConvertMoneyHelperInterface|CurrencyConverterInterface $helper,
   +       private CurrencyConverterInterface $currencyConverter,
       )
   

   Sylius\Bundle\MoneyBundle\Twig\FormatMoneyExtension

   diffCopy

   use Sylius\Bundle\MoneyBundle\Formatter\MoneyFormatterInterface;
   
       public function __construct(
   -       private FormatMoneyHelperInterface|MoneyFormatterInterface $helper,
   +       private MoneyFormatterInterface $moneyFormatter,
       )
   

   Sylius\Bundle\OrderBundle\Twig\AggregateAdjustmentsExtension

   diffCopy

   use Sylius\Component\Order\Aggregator\AdjustmentsAggregatorInterface;
   
       public function __construct(
   -       private AdjustmentsAggregatorInterface|AdjustmentsHelper $adjustmentsHelper,
   +       private AdjustmentsAggregatorInterface $adjustmentsAggregator,
       )
   

   Sylius\Bundle\AdminBundle\Controller\DashboardController

   diffCopy

       public function __construct(
           private ChannelRepositoryInterface $channelRepository,
           private Environment $templatingEngine,
           private RouterInterface $router,
   -       private ?StatisticsDataProviderInterface $statisticsDataProvider = null,
       )
   

   Sylius\Bundle\AdminBundle\EventListener\AdminFilterSubscriber

   diffCopy

   - use Sylius\Bundle\UiBundle\Storage\FilterStorageInterface;
   + use Sylius\Bundle\GridBundle\Storage\FilterStorageInterface;
   
       public function __construct(private FilterStorageInterface $filterStorage)
   

   Sylius\Bundle\AdminBundle\Controller\RedirectHandler

   diffCopy

   - use Sylius\Bundle\UiBundle\Storage\FilterStorageInterface;
   + use Sylius\Bundle\GridBundle\Storage\FilterStorageInterface;
   
       public function __construct(
           private RedirectHandlerInterface $decoratedRedirectHandler,
           private FilterStorageInterface $filterStorage,
       )
   

   Sylius\Bundle\UiBundle\Twig\RedirectPathExtension

   diffCopy

   - use Sylius\Bundle\UiBundle\Storage\FilterStorageInterface;
   + use Sylius\Bundle\GridBundle\Storage\FilterStorageInterface;
   
       public function __construct(
           private FilterStorageInterface $filterStorage,
           private RouterInterface $router,
       )
   

   Sylius\Bundle\PayumBundle\Form\Extension\CryptedGatewayConfigTypeExtension

   diffCopy

   + use Sylius\Bundle\PayumBundle\Checker\PayumGatewayConfigEncryptionCheckerInterface;
   
       public function __construct(
   +       private readonly PayumGatewayConfigEncryptionCheckerInterface $encryptionChecker,
           private ?CypherInterface $cypher = null,
       )
   

   Sylius\Bundle\CoreBundle\Form\Type\Checkout\AddressType

   diffCopy

       public function __construct(
   +       private readonly AddressComparatorInterface $addressComparator,
           string $dataClass,
           array $validationGroups = []
   -       private readonly AddressComparatorInterface $addressComparator = null,
       )
   

   Sylius\Component\Core\OrderProcessing\OrderPaymentProcessor

   diffCopy

       public function __construct(
           private OrderPaymentProviderInterface $orderPaymentProvider,
   -       private string $targetState = PaymentInterface::STATE_CART,
           private OrderPaymentsRemoverInterface $orderPaymentsRemover,
           private array $unprocessableOrderStates,
   +       private string $targetState = PaymentInterface::STATE_CART,
       )
   

   Sylius\Bundle\AdminBundle\Action\ResendOrderConfirmationEmailAction

   diffCopy

   use Symfony\Component\Routing\RouterInterface;
   
       public function __construct(
           private OrderRepositoryInterface $orderRepository,
   -       private OrderEmailManagerInterface|ResendOrderConfirmationEmailDispatcherInterface $orderEmailManager,
   +       private ResendOrderConfirmationEmailDispatcherInterface $resendOrderConfirmationEmailDispatcher,
           private CsrfTokenManagerInterface $csrfTokenManager,
   -       private RequestStack|SessionInterface $requestStackOrSession,
   +       private RequestStack $requestStack,
   -       private ?RouterInterface $router = null,
   +       private RouterInterface $router,
       )
   

   Sylius\Bundle\AdminBundle\Action\ResendShipmentConfirmationEmailAction

   diffCopy

   use Sylius\Bundle\AdminBundle\EmailManager\ShipmentEmailManagerInterface;
   use Sylius\Bundle\CoreBundle\MessageDispatcher\ResendShipmentConfirmationEmailDispatcherInterface;
   
       public function __construct(
           private ShipmentRepositoryInterface $shipmentRepository,
   -       private ResendShipmentConfirmationEmailDispatcherInterface|ShipmentEmailManagerInterface $shipmentEmailManager,
   +       private ResendShipmentConfirmationEmailDispatcherInterface $resendShipmentConfirmationDispatcher,
           private CsrfTokenManagerInterface $csrfTokenManager,
   -       private RequestStack|SessionInterface $requestStackOrSession,
   +       private RequestStack $requestStack,
       )
   

   Sylius\Bundle\AdminBundle\Controller\ImpersonateUserController

   diffCopy

   use Symfony\Component\Routing\RouterInterface;
   
       public function __construct(
           private UserImpersonatorInterface $impersonator,
           private AuthorizationCheckerInterface $authorizationChecker,
           private UserProviderInterface $userProvider,
   -       ?RouterInterface $router,
   +       private RouterInterface $router,
           private string $authorizationRole,
       )
   

   Sylius\Bundle\AdminBundle\EventListener\ShipmentShipListener

   diffCopy

   use Sylius\Bundle\CoreBundle\Mailer\ShipmentEmailManagerInterface;
   
       public function __construct(
   -       private DeprecatedShipmentEmailManagerInterface|ShipmentEmailManagerInterface $shipmentEmailManager
   +       private ShipmentEmailManagerInterface $shipmentEmailManager
       )
   

   Sylius\Bundle\AttributeBundle\Form\Type\AttributeType\Configuration\SelectAttributeChoicesCollectionType

   diffCopy

   use Sylius\Component\Resource\Translation\Provider\TranslationLocaleProviderInterface;
   
       public function __construct(
   -       ?TranslationLocaleProviderInterface $localeProvider = null,
       )
   

   Sylius\Bundle\CoreBundle\CatalogPromotion\Processor\CatalogPromotionRemovalProcessor

   diffCopy

   use Sylius\Bundle\CoreBundle\CatalogPromotion\Announcer\CatalogPromotionRemovalAnnouncerInterface;
   use Symfony\Component\Messenger\MessageBusInterface;
   
       public function __construct(
           private CatalogPromotionRepositoryInterface $catalogPromotionRepository,
   -       private CatalogPromotionRemovalAnnouncerInterface|MessageBusInterface $catalogPromotionRemovalAnnouncer,
   -       private ?MessageBusInterface $eventBus = null,
   +       private CatalogPromotionRemovalAnnouncerInterface $catalogPromotionRemovalAnnouncer,
       )
   

   Sylius\Bundle\CoreBundle\Fixture\Factory\ProductExampleFactory

   diffCopy

   use Symfony\Component\Config\FileLocatorInterface;
   
       public function __construct(
           private FactoryInterface $productFactory,
           private FactoryInterface $productVariantFactory,
           private FactoryInterface $channelPricingFactory,
           private ProductVariantGeneratorInterface $variantGenerator,
           private FactoryInterface $productAttributeValueFactory,
           private FactoryInterface $productImageFactory,
           private FactoryInterface $productTaxonFactory,
           private ImageUploaderInterface $imageUploader,
           private SlugGeneratorInterface $slugGenerator,
           private RepositoryInterface $taxonRepository,
           private RepositoryInterface $productAttributeRepository,
           private RepositoryInterface $productOptionRepository,
           private RepositoryInterface $channelRepository,
           private RepositoryInterface $localeRepository,
   -       private ?RepositoryInterface $taxCategoryRepository = null,
   -       private ?FileLocatorInterface $fileLocator = null,
   +       private RepositoryInterface $taxCategoryRepository,
   +       private FileLocatorInterface $fileLocator,
       )
   

   Sylius\Bundle\CoreBundle\EventListener\PaymentPreCompleteListener

   diffCopy

       public function __construct(
   +       private OrderItemAvailabilityCheckerInterface|AvailabilityCheckerInterface $availabilityChecker,
   -       private AvailabilityCheckerInterface $availabilityChecker,
       )
   

   Sylius\Bundle\CoreBundle\Fixture\Factory\PromotionExampleFactory

   diffCopy

   use Sylius\Component\Resource\Repository\RepositoryInterface;
   
       public function __construct(
           private FactoryInterface $promotionFactory,
           private ExampleFactoryInterface $promotionRuleExampleFactory,
           private ExampleFactoryInterface $promotionActionExampleFactory,
           private ChannelRepositoryInterface $channelRepository,
   -       private ?FactoryInterface $couponFactory = null,
   -       private ?RepositoryInterface $localeRepository = null,
   +       private FactoryInterface $couponFactory,
   +       private RepositoryInterface $localeRepository,
       )
   

   Sylius\Bundle\CoreBundle\Installer\Provider\DatabaseSetupCommandsProvider

   diffCopy

   use Doctrine\Bundle\DoctrineBundle\Registry;
   use Doctrine\ORM\EntityManagerInterface;
   
       public function __construct(
   -       Registry $doctrineRegistry,
   +       EntityManagerInterface $entityManager,
       )
   

   Sylius\Bundle\CoreBundle\Installer\Setup\LocaleSetup

   diffCopy

   use Symfony\Component\Filesystem\Filesystem;
   
       public function __construct(
           private RepositoryInterface $localeRepository,
           private FactoryInterface $localeFactory,
           private string $locale,
   -       private ?Filesystem $filesystem = null,
   -       private ?string $localeParameterFilePath,
   +       private Filesystem $filesystem,
   +       private string $localeParameterFilePath,
       )
   

   Sylius\Bundle\CoreBundle\Validator\Constraints\HasEnabledEntityValidator

   diffCopy

   use Symfony\Component\PropertyAccess\PropertyAccessorInterface;
   
       public function __construct(
           private ManagerRegistry $registry,
   -       private ?PropertyAccessorInterface $accessor = null,
   +       private PropertyAccessorInterface $accessor,
       )
   

   Sylius\Bundle\ShopBundle\EventListener\OrderCompleteListener

   diffCopy

   use Sylius\Bundle\CoreBundle\Mailer\OrderEmailManagerInterface;
   use Sylius\Bundle\ShopBundle\EmailManager\OrderEmailManagerInterface as DeprecatedOrderEmailManagerInterface;
   
       public function __construct(
   -       private DeprecatedOrderEmailManagerInterface|OrderEmailManagerInterface $orderEmailManager
   +       private OrderEmailManagerInterface $orderEmailManager
       )
   

   Sylius\Bundle\ShopBundle\Controller\ContactController

   diffCopy

   use Sylius\Bundle\CoreBundle\Mailer\ContactEmailManagerInterface;
   use Sylius\Bundle\ShopBundle\EmailManager\ContactEmailManagerInterface as DeprecatedContactEmailManagerInterface;
   
       public function __construct(
           private RouterInterface $router,
           private FormFactoryInterface $formFactory,
           private Environment $templatingEngine,
           private ChannelContextInterface $channelContext,
           private CustomerContextInterface $customerContext,
           private LocaleContextInterface $localeContext,
   -       private ContactEmailManagerInterface|DeprecatedContactEmailManagerInterface $contactEmailManager,
   +       private ContactEmailManagerInterface $contactEmailManager,
       )
   

   Sylius\Component\Addressing\Matcher\ZoneMatcher

   diffCopy

   use Sylius\Component\Addressing\Repository\ZoneRepositoryInterface;
   use Sylius\Component\Resource\Repository\RepositoryInterface;
   
       public function __construct(
   -       private RepositoryInterface|ZoneRepositoryInterface $zoneRepository
   +       private ZoneRepositoryInterface $zoneRepository
       )
   

   Sylius\Component\Core\Updater\UnpaidOrdersStateUpdater

   diffCopy

   use Doctrine\Persistence\ObjectManager;
   use SM\Factory\Factory;
   use Sylius\Abstraction\StateMachine\StateMachineInterface;
   
       public function __construct(
           private OrderRepositoryInterface $orderRepository,
   -       private Factory|StateMachineInterface $stateMachineFactory,
   +       private StateMachineInterface $stateMachine,
           private string $expirationPeriod,
   -       private ?LoggerInterface $logger = null,
   -       private ?ObjectManager $orderManager = null,
   +       private LoggerInterface $logger,
   +       private ObjectManager $orderManager,
           private int $batchSize = 100,
       )
   

   Sylius\Component\Core\Calculator\ProductVariantPriceCalculator

   diffCopy

   use Sylius\Component\Core\Checker\ProductVariantLowestPriceDisplayCheckerInterface;
   
       public function __construct(
   -       private ?ProductVariantLowestPriceDisplayCheckerInterface $productVariantLowestPriceDisplayChecker = null,
   +       private ProductVariantLowestPriceDisplayCheckerInterface $productVariantLowestPriceDisplayChecker,
       )
   

   Sylius\Component\Core\Taxation\Applicator\OrderItemsTaxesApplicator

   diffCopy

   use Sylius\Component\Core\Distributor\ProportionalIntegerDistributorInterface;
   
       public function __construct(
           private CalculatorInterface $calculator,
           private AdjustmentFactoryInterface $adjustmentFactory,
           private IntegerDistributorInterface $distributor,
           private TaxRateResolverInterface $taxRateResolver,
   -       private ?ProportionalIntegerDistributorInterface $proportionalIntegerDistributor = null,
   +       private ProportionalIntegerDistributorInterface $proportionalIntegerDistributor,
       )
   

   Sylius\Component\Core\Taxation\Applicator\OrderItemUnitsTaxesApplicator

   diffCopy

   use Sylius\Component\Core\Distributor\ProportionalIntegerDistributorInterface;
   
       public function __construct(
           CalculatorInterface $calculator,
           AdjustmentFactoryInterface $adjustmentFactory,
           TaxRateResolverInterface $taxRateResolver,
   +       ProportionalIntegerDistributorInterface $proportionalIntegerDistributor,
       )
   

   Sylius\Component\Product\Resolver\DefaultProductVariantResolver

   diffCopy

       public function __construct(
   -       private ?ProductVariantRepositoryInterface $productVariantRepository = null
   +       private readonly ProductVariantRepositoryInterface $productVariantRepository
       )
   

   Sylius\Bundle\CoreBundle\EventListener\TaxonDeletionListener

   diffCopy

       public function __construct(
   -       private RequestStack|SessionInterface $requestStackOrSession,
   +       private RequestStack $requestStack,
           private ChannelRepositoryInterface $channelRepository,
           private TaxonInPromotionRuleCheckerInterface $taxonInPromotionRuleChecker,
           TaxonAwareRuleUpdaterInterface ...$ruleUpdaters,
       )
   

   Sylius\Component\Core\Cart\Context\ShopBasedCartContext

   diffCopy

      public function __construct(
          private CartContextInterface $cartContext,
          private ShopperContextInterface $shopperContext,
   -      private ?CreatedByGuestFlagResolverInterface $createdByGuestFlagResolver = null,
   +      private CreatedByGuestFlagResolverInterface $createdByGuestFlagResolver,
      )
   

   Sylius\Component\Core\Uploader\ImageUploader

   diffCopy

       public function __construct(
   -       protected FilesystemAdapterInterface|FilesystemInterface $filesystem,
   -       protected ?ImagePathGeneratorInterface $imagePathGenerator = null,
   +       protected readonly FilesystemAdapterInterface $filesystem,
   +       protected readonly ImagePathGeneratorInterface $imagePathGenerator,
       )
   

   Sylius\Component\Taxation\Resolver\TaxRateResolver

   diffCopy

       public function __construct(
           protected RepositoryInterface $taxRateRepository,
   -       protected ?TaxRateDateEligibilityCheckerInterface $taxRateDateChecker = null,
   +       protected TaxRateDateEligibilityCheckerInterface $taxRateDateChecker,
       )
   

   Sylius\Bundle\AddressingBundle\Form\Type\ZoneChoiceType

   diffCopy

       public function __construct(
           private RepositoryInterface $zoneRepository,
   -       private array $scopeTypes = []
   +       private readonly array $scopeTypes,
       )
   

   Sylius\Component\Core\OrderProcessing\OrderPricesRecalculator

   diffCopy

       public function __construct(
   -       private ProductVariantPriceCalculatorInterface|ProductVariantPricesCalculatorInterface $productVariantPriceCalculator
   +       private ProductVariantPricesCalculatorInterface $productVariantPricesCalculator
       )
   

   Sylius\Bundle\AdminBundle\Action\Account\RenderResetPasswordPageAction

   diffCopy

       public function __construct(
           private UserRepositoryInterface $userRepository,
           private FormFactoryInterface $formFactory,
   -       private FlashBagInterface|RequestStack $requestStackOrFlashBag,
   +       private RequestStack $requestStack,
           private RouterInterface $router,
           private Environment $twig,
           private string $tokenTtl,
       )
   

   Sylius\Bundle\AdminBundle\Action\Account\ResetPasswordAction

   diffCopy

       public function __construct(
           private FormFactoryInterface $formFactory,
           private ResetPasswordDispatcherInterface $resetPasswordDispatcher,
   -       private FlashBagInterface|RequestStack $requestStackOrFlashBag,
   +       private RequestStack $requestStack,
           private RouterInterface $router,
           private Environment $twig,
       )
   

   Sylius\Bundle\AdminBundle\Event\OrderShowMenuBuilderEvent

   diffCopy

       public function __construct(
           FactoryInterface $factory,
           ItemInterface $menu,
           private OrderInterface $order,
   -       private StateMachineInterface|WinzouStateMachineInterface $stateMachine,
   +       private StateMachineInterface $stateMachine,
       )
   

   Sylius\Bundle\AttributeBundle\Form\Type\AttributeValueType

   diffCopy

       public function __construct(
           string $dataClass,
           array $validationGroups,
           protected string $attributeChoiceType,
           protected RepositoryInterface $attributeRepository,
           protected RepositoryInterface $localeRepository,
           protected FormTypeRegistryInterface $formTypeRegistry,
   -       protected ?DataTransformerInterface $localeToCodeTransformer = null,
   +       protected DataTransformerInterface $localeToCodeTransformer,
       )
   

   Sylius\Bundle\CoreBundle\CatalogPromotion\Processor\CatalogPromotionRemovalProcessor

   diffCopy

       public function __construct(
           private CatalogPromotionRepositoryInterface $catalogPromotionRepository,
   -       private CatalogPromotionRemovalAnnouncerInterface|MessageBusInterface $catalogPromotionRemovalAnnouncer,
   -       private ?MessageBusInterface $eventBus = null, /** @phpstan-ignore-line */
   +       private CatalogPromotionRemovalAnnouncerInterface $catalogPromotionRemovalAnnouncer,
       )
   

   Sylius\Bundle\CoreBundle\Fixture\Factory\AdminUserExampleFactory

   diffCopy

       public function __construct(
           private FactoryInterface $userFactory,
           private string $localeCode,
   -       private ?FileLocatorInterface $fileLocator = null,
   -       private ?ImageUploaderInterface $imageUploader = null,
   -       private ?FactoryInterface $avatarImageFactory = null,
   +       private FileLocatorInterface $fileLocator,
   +       private ImageUploaderInterface $imageUploader,
   +       private FactoryInterface $avatarImageFactory,
       )
   

   Sylius\Bundle\CoreBundle\Fixture\Factory\ChannelExampleFactory

   diffCopy

       public function __construct(
           private ChannelFactoryInterface $channelFactory,
           private RepositoryInterface $localeRepository,
           private RepositoryInterface $currencyRepository,
           private RepositoryInterface $zoneRepository,
   -       ?TaxonRepositoryInterface $taxonRepository = null,
   -       ?FactoryInterface $shopBillingDataFactory = null,
   +       private TaxonRepositoryInterface $taxonRepository,
   +       private FactoryInterface $shopBillingDataFactory,
       )
   

   Sylius\Bundle\CoreBundle\Fixture\Factory\ShippingMethodExampleFactory

   diffCopy

       public function __construct(
           private FactoryInterface $shippingMethodFactory,
           private RepositoryInterface $zoneRepository,
           private RepositoryInterface $shippingCategoryRepository,
           private RepositoryInterface $localeRepository,
           private ChannelRepositoryInterface $channelRepository,
   -       private ?RepositoryInterface $taxCategoryRepository = null,
   +       private RepositoryInterface $taxCategoryRepository,
       )
   

   Sylius\Bundle\CoreBundle\Installer\Requirement\FilesystemRequirements

   diffCopy

       public function __construct(
           TranslatorInterface $translator,
           string $cacheDir,
           string $logsDir,
   -       ?string $rootDir = null
       )
   

   Sylius\Bundle\CoreBundle\Twig\CheckoutStepsExtension

   diffCopy

       public function __construct(
   -       private readonly CheckoutStepsHelper|OrderPaymentMethodSelectionRequirementCheckerInterface $checkoutStepsHelper,
   -       private readonly ?OrderShippingMethodSelectionRequirementCheckerInterface $orderShippingMethodSelectionRequirementChecker = null,
   +       private readonly OrderPaymentMethodSelectionRequirementCheckerInterface $orderPaymentMethodSelectionRequirementChecker,
   +       private readonly OrderShippingMethodSelectionRequirementCheckerInterface $orderShippingMethodSelectionRequirementChecker,
       )
   

   Sylius\Bundle\CoreBundle\Twig\PriceExtension

   diffCopy

       public function __construct(
   -       private readonly PriceHelper|ProductVariantPricesCalculatorInterface $helper
   +       private readonly ProductVariantPricesCalculatorInterface $productVariantPricesCalculator
       )
   

   Sylius\Bundle\CoreBundle\Twig\VariantResolverExtension

   diffCopy

       public function __construct(
   -       private readonly ProductVariantResolverInterface|VariantResolverHelper $helper
   +       private readonly ProductVariantResolverInterface $productVariantResolver
       )
   

   Sylius\Bundle\ProductBundle\Form\Type\ProductOptionValueChoiceType

   diffCopy

       public function __construct(
   -       ?AvailableProductOptionValuesResolverInterface $availableProductOptionValuesResolver = null
   +       private readonly AvailableProductOptionValuesResolverInterface $availableProductOptionValuesResolver
       )
   

   Sylius\Bundle\ShopBundle\Controller\ContactController

   diffCopy

       public function __construct(
           private RouterInterface $router,
           private FormFactoryInterface $formFactory,
           private Environment $templatingEngine,
           private ChannelContextInterface $channelContext,
           private CustomerContextInterface $customerContext,
           private LocaleContextInterface $localeContext,
   -       private ContactEmailManagerInterface|DeprecatedContactEmailManagerInterface $contactEmailManager,
   +       private ContactEmailManagerInterface $contactEmailManager,
       )
   

   Sylius\Bundle\ShopBundle\EventListener\OrderCompleteListener

   diffCopy

       public function __construct(
   -       private DeprecatedOrderEmailManagerInterface|OrderEmailManagerInterface $orderEmailManager
   +       private OrderEmailManagerInterface $orderEmailManager
       )
   

   Sylius\Bundle\UserBundle\Controller\SecurityController

   diffCopy

       public function __construct(
   -       private ?AuthenticationUtils $authenticationUtils = null,
   -       private ?FormFactoryInterface $formFactory = null,
   +       private AuthenticationUtils $authenticationUtils,
   +       private FormFactoryInterface $formFactory,
   +       private Environment $twig,
       )
   

   Sylius\Component\Core\Calculator\ProductVariantPriceCalculator

   diffCopy

       public function __construct(
   -       private ?ProductVariantLowestPriceDisplayCheckerInterface $productVariantLowestPriceDisplayChecker = null,
   +       private ProductVariantLowestPriceDisplayCheckerInterface $productVariantLowestPriceDisplayChecker,
       )
   

   Sylius\Component\Core\Factory\ChannelFactory

   diffCopy

       public function __construct(
           private FactoryInterface $decoratedFactory,
           private string $defaultCalculationStrategy,
   -       private ?FactoryInterface $channelPriceHistoryConfigFactory = null,
   +       private FactoryInterface $channelPriceHistoryConfigFactory,
       )
   

   Sylius\Component\Core\Promotion\Checker\Rule\ItemTotalRuleChecker

   diffCopy

       public function __construct(
   -       private ?RuleCheckerInterface $itemTotalRuleChecker = null
       )
   

   Sylius\Component\Core\Provider\TranslationLocaleProvider

   diffCopy

       public function __construct(
   -       private LocaleCollectionProviderInterface|RepositoryInterface $localeRepository,
   +       private LocaleCollectionProviderInterface $localeRepository,
           private string $defaultLocaleCode,
       )
   

   Sylius\Component\Core\Translation\TranslatableEntityLocaleAssigner

   diffCopy

       public function __construct(
           private LocaleContextInterface $localeContext,
           private TranslationLocaleProviderInterface $translationLocaleProvider,
   -       private ?CLIContextCheckerInterface $commandBasedChecker = null,
   +       private CLIContextCheckerInterface $commandBasedChecker,
       )
   

2. Changes across the codebase:

   diffCopy

   -   private StateMachineFactoryInterface|StateMachineInterface $stateMachineFactory,
   +   private StateMachineInterface $stateMachine,
   

   diffCopy

   -   private FactoryInterface|StateMachineInterface $stateMachineFactory,
   +   private StateMachineInterface $stateMachine,
   

   diffCopy

   -   private RequestStack|SessionInterface $requestStackOrSession,
   +   private RequestStack $requestStack,
   

   diffCopy

   + use Symfony\Component\Clock\ClockInterface;
   -   private DateTimeProviderInterface $calendar
   +   private ClockInterface $clock
   

   diffCopy

   -   private ?ProportionalIntegerDistributorInterface $proportionalIntegerDistributor = null,
   +   private ProportionalIntegerDistributorInterface $proportionalIntegerDistributor,
   

Configuration Changes

Messenger

• Removed sylius_default.bus and sylius_event.bus configurations.
  Use sylius.command_bus and sylius.event_bus for commands and events, respectively.

Sylius State Machine Abstraction

• Removed sylius_core.state_machine configuration parameter.
• Changed sylius_state_machine_abstraction.default_adapter from winzou_state_machine to symfony_workflow.

Resource

• Removed configuration nodes for resource options sylius_*.resources.**.options, such as sylius_addressing.resources.address.options.
• Removed sylius_inventory.checker configuration node.

Autoconfiguration

• Removed sylius_core.autoconfigure_with_attributes and sylius_order.autoconfigure_with_attributes.
  Use the following attributes instead of interfaces for autoconfiguration:
  • Sylius\Bundle\OrderBundle\Attribute\AsCartContext
  • Sylius\Bundle\OrderBundle\Attribute\AsOrderProcessor

User Resetting Pin

• Removed sylius_user.resources.{name}.user.resetting.pin configuration parameter.
  Due to that the related logic has also been removed, this includes:
  • reset_password_pin email
  • Sylius\Bundle\UserBundle\Controller\UserController::requestPasswordResetPinAction method
  • sylius.{user_type}_user.pin_generator.password_reset services
  • sylius.{user_type}_user.pin_uniqueness_checker.password_reset services

Parameter Removals and Renaming

• Removed:
  • sylius.mongodb_odm.repository.class
  • sylius.phpcr_odm.repository.class
  • sylius.mailer.templates
• Renamed:
  • sylius.message.admin_user_create.validation_groups to sylius_admin.command_handler.create_admin_user.validation_groups

File Relocations

• The state machine configurations of PaymentBundle have been moved and renamed:

Winzou state machine:

- `@SyliusPaymentBundle/Resources/config/app/state_machine.yml`
+ `@SyliusPaymentBundle/Resources/config/app/state_machine/sylius_payment.yaml`

Symfony workflow:

- `@SyliusPaymentBundle/Resources/config/workflow/state_machine.yaml`
+ `@SyliusPaymentBundle/Resources/config/app/workflow/sylius_[resource].yaml`

Zone Validation Groups

• Added a new parameter to specify validation groups for zones.
  Configure custom validation groups for zone members in config/packages/_sylius.yaml.
  Example:

  yamlCopy

  sylius_addressing:
    zone_member:
      validation_groups:
        country:
          - 'sylius'
          - 'sylius_zone_member_country'
        zone:
          - 'sylius'
          - 'sylius_zone_member_zone'
  

LiipImagineBundle Default Resolver and Loader

• Changed the default resolver and loader names for LiipImagineBundle from default to sylius_image (reference).
  To modify these defaults, configure cache and/or data_loader parameters under the liip_imagine key.

Grids

The experimental entities filter has been removed. It has been replaced by the generic entity one.

sylius_grid:
    grids:
        # ...
        sylius_admin_catalog_promotion:
            # ...
            filters:
                channel:
-                   type: entities
+                   type: entity
                    label: sylius.ui.channel
                    form_options:
                        class: "%sylius.model.channel.class%"
                    options:
-                       field: product.channels.id
+                       fields: [product.channels.id]

Password Encoder & Salt

The encoder and salt have been removed from the User entities. The password hasher configured on Symfony security configuration is in use instead.

This "encoder" is configured via the Symfony security password hasher.

For example:

# config/packages/security.yaml
security:
    # ...

    password_hashers:
        Sylius\Component\User\Model\UserInterface: argon2i

Also, check if you have an encoder configured in the sylius_user package configuration.

sylius_user:
    # ...

    encoder: plaintext # Remove this line

    # ...
    resources:
        oauth:
            user:
                encoder: false # Remove this line
                classes: Sylius\Component\User\Model\UserOAuth

Check your user hashed passwords in your production database. In modern Symfony projects, the hasher name is stored along with the password.

Example: $argon2i$v=19$m=65536,t=4,p=1$VVJuMnpUUWhRY1daN1ppMA$2Tx6l3I+OUx+PUPn+vZz1jI3Z6l6IHh2kpG0NdpmYWE

If some of your users do not have the hasher name stored in the password field you may need to configure the "migrate_from" option by following the documentation: https://symfony.com/doc/current/security/passwords.html#configure-a-new-hasher-using-migrate-from

Note: If your app never changed the hasher name configuration, you don't need to configure this "migrate_from" configuration.

Routes

• The following routes have been removed:
  • sylius_admin_dashboard_statistics
  • sylius_admin_ajax_all_product_variants_by_codes
  • sylius_admin_ajax_all_product_variants_by_phrase
  • sylius_admin_ajax_customer_group_by_code
  • sylius_admin_ajax_customer_groups_by_phrase
  • sylius_admin_ajax_find_product_options
  • sylius_admin_ajax_generate_product_slug
  • sylius_admin_ajax_generate_taxon_slug
  • sylius_admin_ajax_product_by_code
  • sylius_admin_ajax_product_by_name_phrase
  • sylius_admin_ajax_product_index
  • sylius_admin_ajax_product_options_by_phrase
  • sylius_admin_ajax_products_by_phrase
  • sylius_admin_ajax_product_variants_by_codes
  • sylius_admin_ajax_product_variants_by_phrase
  • sylius_admin_ajax_taxon_by_code
  • sylius_admin_ajax_taxon_by_name_phrase
  • sylius_admin_ajax_taxon_leafs
  • sylius_admin_ajax_taxon_root_nodes
  • sylius_admin_dashboard_statistics
  • sylius_admin_get_attribute_types
  • sylius_admin_get_payment_gateways
  • sylius_admin_get_product_attributes
  • sylius_admin_partial_address_log_entry_index
  • sylius_admin_partial_catalog_promotion_show
  • sylius_admin_partial_channel_index
  • sylius_admin_partial_customer_latest
  • sylius_admin_partial_customer_show
  • sylius_admin_partial_order_latest
  • sylius_admin_partial_order_latest_in_channel
  • sylius_admin_partial_product_show
  • sylius_admin_partial_promotion_show
  • sylius_admin_partial_taxon_show
  • sylius_admin_partial_taxon_tree
  • sylius_admin_render_attribute_forms
  • sylius_shop_ajax_cart_add_item
  • sylius_shop_ajax_cart_item_remove
  • sylius_shop_ajax_user_check_action
  • sylius_shop_partial_cart_summary
  • sylius_shop_partial_cart_add_item
  • sylius_shop_partial_channel_menu_taxon_index
  • sylius_shop_partial_product_association_show
  • sylius_shop_partial_product_index_latest
  • sylius_shop_partial_product_review_latest
  • sylius_shop_partial_product_show_by_slug
  • sylius_shop_partial_taxon_index_by_code
  • sylius_shop_partial_taxon_show_by_slug

Services, classes and interfaces changes

Container

In Sylius 2.0, we have changed the visibility of services to private by default. This change enhances the performance and maintainability of the application and also follows Symfony's best practices for service encapsulation.

Exceptions:

• Services required by Symfony to be public (e.g., controllers, event listeners) remain public.
• Services used in ResourceController must be public as they are accessed directly from the container.

Classes and Interfaces

1. Removed

• Sylius\Bundle\ApiBundle\EventListener\PostgreSQLDriverExceptionListener
• Sylius\Bundle\ProductBundle\Controller\ProductSlugController
• Sylius\Bundle\CoreBundle\Twig\FilterExtension
• Sylius\Bundle\CoreBundle\DependencyInjection\Compiler\LiipImageFiltersPass
• Sylius\Bundle\GridBundle\Doctrine\PHPCRODM\DataSource
• Sylius\Bundle\GridBundle\Doctrine\PHPCRODM\Driver
• Sylius\Bundle\GridBundle\Doctrine\PHPCRODM\ExpressionBuilder
• Sylius\Bundle\GridBundle\Doctrine\PHPCRODM\ExpressionBuilderInterface
• Sylius\Bundle\GridBundle\Doctrine\PHPCRODM\ExpressionVisitor
• Sylius\Bundle\GridBundle\Doctrine\PHPCRODM\ExtraComparison
• Sylius\Bundle\ResourceBundle\DependencyInjection\Driver\Doctrine\DoctrineODMDriver
• Sylius\Bundle\ResourceBundle\DependencyInjection\Driver\Doctrine\DoctrinePHPCRDriver
• Sylius\Bundle\ResourceBundle\Doctrine\ODM\MongoDB\DocumentRepository
• Sylius\Bundle\ResourceBundle\Doctrine\ODM\MongoDB\TranslatableRepository
• Sylius\Bundle\ResourceBundle\Doctrine\ODM\PHPCR\DocumentRepository
• Sylius\Bundle\ResourceBundle\Doctrine\ODM\PHPCR\EventListener\DefaultParentListener
• Sylius\Bundle\ResourceBundle\Doctrine\ODM\PHPCR\EventListener\NameFilterListener
• Sylius\Bundle\ResourceBundle\Doctrine\ODM\PHPCR\EventListener\NameResolverListener
• Sylius\Bundle\ResourceBundle\Doctrine\ODM\PHPCR\Form\Builder\DefaultFormBuilder
• Sylius\Bundle\ResourceBundle\EventListener\ODMMappedSuperClassSubscriber
• Sylius\Bundle\ResourceBundle\EventListener\ODMRepositoryClassSubscriber
• Sylius\Bundle\ResourceBundle\EventListener\ODMTranslatableListener
• Sylius\Bundle\AddressingBundle\Controller\ProvinceController
• Sylius\Bundle\AdminBundle\Controller\NotificationController
• Sylius\Bundle\AdminBundle\Twig\NotificationWidgetExtension
• Sylius\Bundle\CoreBundle\Templating\Helper\CheckoutStepsHelper
• Sylius\Bundle\CoreBundle\Templating\Helper\PriceHelper
• Sylius\Bundle\CoreBundle\Templating\Helper\VariantResolverHelper
• Sylius\Bundle\CurrencyBundle\Templating\Helper\CurrencyHelper
• Sylius\Bundle\CurrencyBundle\Templating\Helper\CurrencyHelperInterface
• Sylius\Bundle\InventoryBundle\Templating\Helper\InventoryHelper
• Sylius\Bundle\LocaleBundle\Templating\Helper\LocaleHelper
• Sylius\Bundle\LocaleBundle\Templating\Helper\LocaleHelperInterface
• Sylius\Bundle\MoneyBundle\Templating\Helper\ConvertMoneyHelper
• Sylius\Bundle\MoneyBundle\Templating\Helper\ConvertMoneyHelperInterface
• Sylius\Bundle\MoneyBundle\Templating\Helper\FormatMoneyHelper
• Sylius\Bundle\MoneyBundle\Templating\Helper\FormatMoneyHelperInterface
• Sylius\Bundle\OrderBundle\Templating\Helper\AdjustmentsHelper
• Sylius\Bundle\ProductBundle\Controller\ProductAttributeController
• Sylius\Bundle\UserBundle\Security\UserLogin
• Sylius\Bundle\UserBundle\Security\UserLoginInterface
• Sylius\Bundle\UserBundle\Security\UserPasswordHasher
• Sylius\Bundle\UserBundle\Security\UserPasswordHasherInterface
• Sylius\Component\User\Security\Generator\UniquePinGenerator
• Sylius\Bundle\AdminBundle\Controller\Dashboard\StatisticsController
• Sylius\Bundle\AdminBundle\Form\Extension\CatalogPromotionActionTypeExtension
• Sylius\Bundle\AdminBundle\Form\Extension\CatalogPromotionScopeTypeExtension
• Sylius\Bundle\AdminBundle\Menu\CustomerShowMenuBuilder
• Sylius\Bundle\AdminBundle\Menu\OrderShowMenuBuilder
• Sylius\Bundle\AdminBundle\Menu\ProductFormMenuBuilder
• Sylius\Bundle\AdminBundle\Menu\ProductUpdateMenuBuilder
• Sylius\Bundle\AdminBundle\Menu\ProductVariantFormMenuBuilder
• Sylius\Bundle\AdminBundle\Menu\PromotionUpdateMenuBuilder
• Sylius\Bundle\AdminBundle\Provider\StatisticsDataProvider
• Sylius\Bundle\ApiBundle\ApiPlatform\Bridge\Symfony\Routing\CachedRouteNameResolver
• Sylius\Bundle\ApiBundle\ApiPlatform\Bridge\Symfony\Routing\RouteNameResolver
• Sylius\Bundle\ApiBundle\ApiPlatform\Factory\MergingExtractorResourceMetadataFactory
• Sylius\Bundle\ApiBundle\Exception\ChannelCannotBeRemoved
• Sylius\Bundle\ApiBundle\Exception\PaymentMethodCannotBeRemoved
• Sylius\Bundle\ApiBundle\Exception\ProductAttributeCannotBeRemoved
• Sylius\Bundle\ApiBundle\Exception\ProductCannotBeRemoved
• Sylius\Bundle\ApiBundle\Exception\ProductVariantCannotBeRemoved
• Sylius\Bundle\ApiBundle\Exception\PromotionCannotBeRemoved
• Sylius\Bundle\ApiBundle\Exception\PromotionCouponCannotBeRemoved
• Sylius\Bundle\ApiBundle\Exception\ProvinceCannotBeRemoved
• Sylius\Bundle\ApiBundle\Exception\ShippingMethodCannotBeRemoved
• Sylius\Bundle\ApiBundle\Exception\TaxonCannotBeRemoved
• Sylius\Bundle\ApiBundle\Exception\ZoneCannotBeRemoved
• Sylius\Bundle\ApiBundle\Validator\ResourceApiInputDataPropertiesValidator
• Sylius\Bundle\ApiBundle\EventListener\PostgreSQLDriverExceptionListener
• Sylius\Bundle\ApiBundle\DataTransformer\CommandAwareInputDataTransformer
• Sylius\Bundle\ApiBundle\DataTransformer\CommandDataTransformerInterface
• Sylius\Bundle\CoreBundle\Console\Command\Model\PluginInfo
• Sylius\Bundle\CoreBundle\Form\Extension\CountryTypeExtension
• Sylius\Bundle\CoreBundle\Form\Extension\CustomerTypeExtension
• Sylius\Bundle\CoreBundle\Form\Extension\LocaleTypeExtension
• Sylius\Bundle\CoreBundle\Form\Type\Grid\Filter\EntitiesFilterType
• Sylius\Bundle\CoreBundle\Form\EventSubscriber\AddUserFormSubscriber
• Sylius\Bundle\CoreBundle\Twig\StateMachineExtension
• Sylius\Component\Core\Grid\Filter\EntitiesFilter
• Sylius\Component\Core\Dashboard\DashboardStatistics
• Sylius\Component\Core\Dashboard\DashboardStatisticsProvider
• Sylius\Component\Core\Dashboard\Interval
• Sylius\Component\Core\Dashboard\SalesDataProvider
• Sylius\Component\Core\Dashboard\SalesSummary
• Sylius\Component\Core\Dashboard\SalesSummaryInterface
• Sylius\Bundle\PayumBundle\Action\Paypal\ExpressCheckout\ConvertPaymentAction
• Sylius\Bundle\PayumBundle\Controller\PayumController
• Sylius\Bundle\PayumBundle\Form\Type\PaypalGatewayConfigurationType
• Sylius\Bundle\PayumBundle\Form\Type\StripeGatewayConfigurationType
• Sylius\Bundle\UiBundle\ContextProvider\DefaultContextProvider
• Sylius\Bundle\UiBundle\Registry\TemplateBlock
• Sylius\Bundle\UiBundle\Registry\TemplateBlockRegistry
• Sylius\Bundle\UiBundle\Renderer\DelegatingTemplateEventRenderer
• Sylius\Bundle\UiBundle\Renderer\TwigTemplateBlockRenderer
• Sylius\Bundle\UiBundle\Storage\FilterStorageInterface
• Sylius\Bundle\UiBundle\Twig\SortByExtension
• Sylius\Bundle\UiBundle\Twig\TemplateEventExtension
• Sylius\Bundle\UiBundle\Twig\TestFormAttributeExtension
• Sylius\Bundle\UiBundle\Twig\TestHtmlAttributeExtension
• Sylius\Bundle\PromotionBundle\Validator\CatalogPromotionAction\ActionValidatorInterface
• Sylius\Bundle\PromotionBundle\Validator\CatalogPromotionScope\ScopeValidatorInterface
• Sylius\Component\Core\Promotion\Updater\Rule\TotalOfItemsFromTaxonRuleUpdater
• Sylius\Bundle\AdminBundle\EmailManager\OrderEmailManager
• Sylius\Bundle\AdminBundle\EmailManager\ShipmentEmailManager
• Sylius\Bundle\ShopBundle\EmailManager\OrderEmailManager
• Sylius\Bundle\ProductBundle\Form\Type\ProductOptionChoiceType
• Sylius\Component\Core\Promotion\Updater\Rule\ProductAwareRuleUpdaterInterface
• Sylius\Component\Promotion\Checker\Rule\CartQuantityRuleChecker
• Sylius\Bundle\CoreBundle\CatalogPromotion\Command\RemoveInactiveCatalogPromotion
• Sylius\Bundle\CoreBundle\Provider\SessionProvider
• Sylius\Component\Core\SyliusLocaleEvents
• Sylius\Bundle\ShopBundle\Twig\OrderTaxesTotalExtension

1. Renamed

1. Moved

Services and Aliases

1. Removed

• sylius.event_subscriber.odm_mapped_super_class
• sylius.event_subscriber.odm_repository_class
• sylius.grid_driver.doctrine.phpcrodm
• sylius.listener.api_postgresql_driver_exception_listener
• sylius.security.password_hasher
• sylius.security.user_login
• Sylius\Bundle\UserBundle\Security\UserLoginInterface
• Sylius\Component\User\Security\UserPasswordHasherInterface
• sylius.controller.admin.notification
• Sylius\Buxndle\AdminBundle\Form\Extension\CatalogPromotionActionTypeExtension
• sylius.controller.admin.dashboard.statistics
• Sylius\Bundle\AdminBundle\Form\Extension\CatalogPromotionScopeTypeExtension
• sylius.admin.menu_builder.customer.show
• sylius.admin.menu_builder.order.show
• sylius.admin.menu_builder.product_form
• sylius.admin.menu_builder.product_variant_form
• sylius.admin.menu_builder.promotion.update
• Sylius\Bundle\AdminBundle\Provider\StatisticsDataProviderInterface
• Sylius\Bundle\ApiBundle\ApiPlatform\ApiResourceConfigurationMerger
• api_platform.route_name_resolver.cached
• api_platform.route_name_resolver
• api_platform.metadata.resource.metadata_factory.yaml
• Sylius\Bundle\ApiBundle\ApiPlatform\Metadata\Merger\LegacyResourceMetadataMerger
• Sylius\Bundle\ApiBundle\ApiPlatform\ResourceMetadataPropertyValueResolver
• Sylius\Bundle\ApiBundle\Controller\GetAddressLogEntryCollectionAction
• Sylius\Bundle\ApiBundle\Controller\GetOrderAdjustmentsAction
• Sylius\Bundle\ApiBundle\Controller\UploadAvatarImageAction
• Sylius\Bundle\ApiBundle\Controller\UploadProductImageAction
• Sylius\Bundle\ApiBundle\Controller\UploadTaxonImageAction
• Sylius\Bundle\ApiBundle\DataPersister\AddressDataPersister
• Sylius\Bundle\ApiBundle\DataPersister\AdminUserDataPersister
• Sylius\Bundle\ApiBundle\DataPersister\ChannelDataPersister
• Sylius\Bundle\ApiBundle\DataPersister\CountryDataPersister
• Sylius\Bundle\ApiBundle\DataPersister\CustomerDataPersister
• Sylius\Bundle\ApiBundle\DataPersister\LocaleDataPersister
• Sylius\Bundle\ApiBundle\DataPersister\MessengerDataPersister
• Sylius\Bundle\ApiBundle\DataPersister\PaymentMethodDataPersister
• Sylius\Bundle\ApiBundle\DataPersister\ProductAttributeDataPersister
• Sylius\Bundle\ApiBundle\DataPersister\ProductDataPersister
• Sylius\Bundle\ApiBundle\DataPersister\ProductTaxonDataPersister
• Sylius\Bundle\ApiBundle\DataPersister\ProductVariantDataPersister
• Sylius\Bundle\ApiBundle\DataPersister\PromotionCouponDataPersister
• Sylius\Bundle\ApiBundle\DataPersister\PromotionDataPersister
• Sylius\Bundle\ApiBundle\DataPersister\ShippingMethodDataPersister
• Sylius\Bundle\ApiBundle\DataPersister\TranslatableDataPersister
• Sylius\Bundle\ApiBundle\DataPersister\ZoneDataPersister
• Sylius\Bundle\ApiBundle\DataProvider\AccountResetPasswordItemDataProvider
• Sylius\Bundle\ApiBundle\DataProvider\AdminOrderItemAdjustmentsSubresourceDataProvider
• Sylius\Bundle\ApiBundle\DataProvider\AdminResetPasswordItemDataProvider
• Sylius\Bundle\ApiBundle\DataProvider\ChannelAwareItemDataProvider
• Sylius\Bundle\ApiBundle\DataProvider\ChannelsCollectionDataProvider
• Sylius\Bundle\ApiBundle\DataProvider\CustomerItemDataProvider
• Sylius\Bundle\ApiBundle\DataProvider\OrderAdjustmentsSubresourceDataProvider
• Sylius\Bundle\ApiBundle\DataProvider\OrderItemAdjustmentsSubresourceDataProvider
• Sylius\Bundle\ApiBundle\DataProvider\OrderItemItemDataProvider
• Sylius\Bundle\ApiBundle\DataProvider\OrderItemUnitItemDataProvider
• Sylius\Bundle\ApiBundle\DataProvider\PaymentItemDataProvider
• Sylius\Bundle\ApiBundle\DataProvider\PaymentMethodsCollectionDataProvider
• Sylius\Bundle\ApiBundle\DataProvider\ProductAttributesSubresourceDataProvider
• Sylius\Bundle\ApiBundle\DataProvider\ProductItemDataProvider
• Sylius\Bundle\ApiBundle\DataProvider\ShipmentItemDataProvider
• Sylius\Bundle\ApiBundle\DataProvider\ShippingMethodsCollectionDataProvider
• Sylius\Bundle\ApiBundle\DataProvider\VerifyCustomerAccountItemDataProvider
• Sylius\Bundle\ApiBundle\Filter\Doctrine\PromotionCouponPromotionFilter
• Sylius\Bundle\ApiBundle\Filter\PaymentMethodFilter
• Sylius\Bundle\ApiBundle\Filter\ShippingMethodFilter
• Sylius\Bundle\ApiBundle\QueryHandler\GetAddressLogEntryCollectionHandler
• Sylius\Bundle\ApiBundle\Serializer\FlattenExceptionNormalizer
• Sylius\Bundle\ApiBundle\SerializerContextBuilder\ReadOperationContextBuilder
• Sylius\Bundle\ApiBundle\Validator\Constraints\AccountVerificationTokenEligibilityValidator
• Sylius\Bundle\ApiBundle\Validator\ResourceInputDataPropertiesValidatorInterface
• Sylius\Bundle\ApiBundle\DataTransformer\ChannelCodeAwareInputCommandDataTransformer
• sylius.api.data_transformer.command_aware_input_data_transformer
• Sylius\Bundle\ApiBundle\DataTransformer\LocaleCodeAwareInputCommandDataTransformer
• Sylius\Bundle\ApiBundle\DataTransformer\LoggedInCustomerEmailAwareCommandDataTransformer
• Sylius\Bundle\ApiBundle\DataTransformer\LoggedInCustomerEmailIfNotSetAwareCommandDataTransformer
• Sylius\Bundle\ApiBundle\DataTransformer\LoggedInShopUserIdAwareCommandDataTransformer
• Sylius\Bundle\ApiBundle\DataTransformer\OrderTokenValueAwareInputCommandDataTransformer
• Sylius\Bundle\ApiBundle\DataTransformer\ShipmentIdAwareInputCommandDataTransformer
• Sylius\Bundle\ApiBundle\DataTransformer\SubresourceIdAwareCommandDataTransformer
• api_platform.action.post_item
• Sylius\Bundle\CoreBundle\Console\Command\ShowAvailablePluginsCommand
• sylius.form.extension.type.country
• sylius.form.extension.type.customer
• sylius.form.extension.type.locale
• sylius.grid_filter.entities
• sylius.dashboard.statistics_provider
• Sylius\Component\Core\Dashboard\SalesDataProviderInterface
• sylius.payum_action.paypal_express_checkout.convert_payment
• sylius.controller.payum
• sylius.form.type.gateway_configuration.stripe
• Sylius\Bundle\UiBundle\Console\Command\DebugTemplateEventCommand
• Sylius\Bundle\UiBundle\ContextProvider\ContextProviderInterface
• Sylius\Bundle\UiBundle\DataCollector\TemplateBlockDataCollector
• Sylius\Bundle\UiBundle\DataCollector\TemplateBlockRenderingHistory
• Sylius\Bundle\UiBundle\DataCollector\TraceableTemplateBlockRenderer
• Sylius\Bundle\UiBundle\DataCollector\TraceableTemplateEventRenderer
• Sylius\Bundle\UiBundle\Registry\TemplateBlockRegistryInterface
• Sylius\Bundle\UiBundle\Renderer\HtmlDebugTemplateBlockRenderer
• Sylius\Bundle\UiBundle\Renderer\HtmlDebugTemplateEventRenderer
• Sylius\Bundle\UiBundle\Renderer\TemplateBlockRendererInterface
• Sylius\Bundle\UiBundle\Renderer\TemplateEventRendererInterface
• Sylius\Bundle\UiBundle\Storage\FilterStorage
• Sylius\Bundle\UiBundle\Twig\LegacySonataBlockExtension
• sylius.twig.extension.template_event
• Sylius\Bundle\PromotionBundle\Validator\CatalogPromotionActionValidator
• Sylius\Bundle\PromotionBundle\Validator\CatalogPromotionScopeValidator
• Sylius\Component\Promotion\Generator\PromotionCouponGeneratorInstructionInterface
• sylius.promotion_rule_updater.total_of_items_from_taxon
• Sylius\Component\Core\Promotion\Updater\Rule\ContainsProductRuleUpdater
• Sylius\Bundle\AdminBundle\EmailManager\OrderEmailManagerInterface
• sylius.email_manager.shipment
• Sylius\Bundle\AdminBundle\EmailManager\ShipmentEmailManagerInterface
• Sylius\Bundle\ShopBundle\EmailManager\ContactEmailManagerInterface
• sylius.email_manager.contact
• sylius.email_manager.order
• Sylius\Bundle\ShopBundle\EmailManager\OrderEmailManagerInterface
• sylius.form.type.product_option_choice
• Sylius\Bundle\ShopBundle\Calculator\OrderItemsSubtotalCalculatorInterface
• sylius.calculator.order_items_subtotal
• Sylius\Bundle\CoreBundle\CatalogPromotion\CommandHandler\RemoveInactiveCatalogPromotionHandler
• sylius.http_message_factory
• sylius.twig.extension.taxes

1. Renamed

1. Replaced

1. Definition location changed

• The Sylius\Bundle\PromotionBundle\Form\Type\CatalogPromotionAction\PercentageDiscountActionConfigurationType was moved to the CoreBundle from PromotionBundle.
• The Sylius\Bundle\PromotionBundle\Form\Type\CatalogPromotionScopeType was moved from the CoreBundle to the PromotionBundle.

Class changes

1. Added Sylius\Component\Order\Context\ResettableCartContextInterface, which extends Sylius\Component\Order\Context\CartContextInterface and Symfony\Contracts\Service\ResetInterface.

2. Replaced sylius/calendar with symfony/clock. All instances of Sylius\Calendar\Provider\DateTimeProviderInterface are now replaced by Symfony\Component\Clock\ClockInterface.

Affected classes: - Sylius\Bundle\CoreBundle\CatalogPromotion\Announcer\CatalogPromotionAnnouncer - Sylius\Bundle\CoreBundle\MessageHandler\Admin\Account\RequestResetPasswordEmailHandler - Sylius\Bundle\CoreBundle\PriceHistory\Logger\PriceChangeLogger - Sylius\Bundle\CoreBundle\PriceHistory\Remover\ChannelPricingLogEntriesRemover - Sylius\Bundle\ShippingBundle\Assigner\ShippingDateAssigner - Sylius\Bundle\PromotionBundle\Criteria\DateRange - Sylius\Bundle\ApiBundle\Applicator\ArchivingShippingMethodApplicator - Sylius\Bundle\ApiBundle\CommandHandler\Account\RequestResetPasswordTokenHandler - Sylius\Bundle\ApiBundle\CommandHandler\Account\VerifyCustomerAccountHandler - Sylius\Component\Taxation\Checker\TaxRateDateEligibilityChecker

1. The \Serializable interface has been removed from Sylius\Component\User\Model\UserInterface.

New and Updated Repository Classes

New Repositories

• Addressing:

  • Sylius\Bundle\AddressingBundle\Doctrine\ORM\AddressRepository
  • Sylius\Bundle\AddressingBundle\Doctrine\ORM\CountryRepository
  • Sylius\Bundle\AddressingBundle\Doctrine\ORM\ProvinceRepository
  • Sylius\Bundle\AddressingBundle\Doctrine\ORM\ZoneMemberRepository

• Attribute:

  • Sylius\Bundle\AttributeBundle\Doctrine\ORM\AttributeRepository
  • Sylius\Bundle\AttributeBundle\Doctrine\ORM\AttributeTranslationRepository
  • Sylius\Bundle\AttributeBundle\Doctrine\ORM\AttributeValueRepository

• Product:

  • Sylius\Bundle\ProductBundle\Doctrine\ORM\ProductAssociationRepository
  • Sylius\Bundle\ProductBundle\Doctrine\ORM\ProductAssociationTypeTranslationRepository
  • Sylius\Bundle\ProductBundle\Doctrine\ORM\ProductAttributeRepository
  • Sylius\Bundle\ProductBundle\Doctrine\ORM\ProductAttributeTranslationRepository
  • Sylius\Bundle\ProductBundle\Doctrine\ORM\ProductOptionTranslationRepository
  • Sylius\Bundle\ProductBundle\Doctrine\ORM\ProductOptionValueRepository
  • Sylius\Bundle\ProductBundle\Doctrine\ORM\ProductOptionValueTranslationRepository
  • Sylius\Bundle\ProductBundle\Doctrine\ORM\ProductTranslationRepository
  • Sylius\Bundle\ProductBundle\Doctrine\ORM\ProductVariantTranslationRepository

• Currency:

  • Sylius\Bundle\CurrencyBundle\Doctrine\ORM\CurrencyRepository

Repository Inheritance Changes

• Addressing:

  • Sylius\Bundle\CoreBundle\Doctrine\ORM\AddressRepository now extends Sylius\Bundle\AddressingBundle\Doctrine\ORM\AddressRepository.
  • Sylius\Component\Core\Repository\AddressRepositoryInterface now implements Sylius\Component\Addressing\Repository\AddressRepositoryInterface.

• Attribute:

  • Sylius\Bundle\CoreBundle\Doctrine\ORM\AttributeRepository now extends Sylius\Bundle\AttributeBundle\Doctrine\ORM\AttributeRepository.
  • Sylius\Component\Product\Repository\ProductAttributeValueRepositoryInterface now implements Sylius\Component\Attribute\Repository\AttributeValueRepositoryInterface.

• Product:

  • Sylius\Bundle\CoreBundle\Doctrine\ORM\ProductAssociationRepository now extends Sylius\Bundle\ProductBundle\Doctrine\ORM\ProductAssociationRepository.

User Model Updates

• Removed fields and corresponding methods for:
  • locked
  • expiresAt
  • credentialsExpireAt
• These changes affect the ShopUser and AdminUser models, and any custom user type extending the Sylius\Component\User\Model\User model, as well as the relevant columns in the database tables.

Service Aliases

• Aliases introduced in Sylius 1.14 have now become the primary service IDs in Sylius 2.0. The old service IDs have been removed, and all references must be updated accordingly:

The old service IDs are no longer available in Sylius 2.0. Please ensure your configurations and service references use the new service IDs.

• The following services had new aliases added in Sylius 1.14. In Sylius 2.0, these aliases have become the primary service IDs, and the old service IDs remain as aliases:

Architecture changes

• The Normalizer and Denormalizer in ApiBundle have been reorganized into subdirectories, moving from Sylius\Bundle\ApiBundle\Serializer to Sylius\Bundle\ApiBundle\Serializer\Normalizer and Sylius\Bundle\ApiBundle\Serializer\Denormalizer.

• The SerializerContextBuilder classes in ApiBundle have been moved to the Sylius\Bundle\ApiBundle\Serializer\ContextBuilder subdirectory.

• The Filter, QueryCollectionExtension, and QueryItemExtension classes in ApiBundle have been reorganized into separate sections (admin, shop, common) based on their usage context, and grouped by resources.

• The Message directory has been renamed to Command. Following this change, MessageHandler has been renamed to CommandHandler, and MessageDispatcher has been renamed to CommandDispatcher.

• AdminBundle now contains base form types for every resource. Use these as an extension point for admin customizations instead the ones from CoreBundle or other minor bundles. Similarly, use form types from ShopBundle for the Shop context.

Payment method gateways

• Stripe and Paypal Express Checkout gateways have been removed. The only remaining by default gateway in core is offline. Use sylius plugins for the gateways of your choosing.

Theming

• Channel's themeName form field existence is made optional and depends on ShopBundle presence.
• The Sylius\Bundle\CoreBundle\Theme\ChannelBasedThemeContext has been moved to the Sylius\Bundle\ShopBundle\Theme\ChannelBasedThemeContext.

Frontend

• Unused, legacy node packages have been removed, while the required ones have been updated to newer versions. To ensure a smooth transition, it is recommended to delete the node_modules directory and reinstall the packages.
• The recommended Node.js versions are 20 or 22, as support for version 18 has been dropped.
• use_webpack option was removed from the sylius_ui configuration, and the Webpack has become the only module bundler provided by Sylius.
• use_webpack twig global variable was removed. Webpack is always used now, and there is no need to check for it.
• Image sizes have been simplified and standardized for both the Admin and Shop Bundle.
• Some Twig extension services have been moved from the UiBundle to the new Twig Extra package

KNP Menu

• Aliases for the knp_menu.menu_builder tags introduced in Sylius 1.14 are now the only valid menu builder tags in Sylius 2.0:

Transition from SemanticUI to Bootstrap

• All CSS classes of SemanticUI have been replaced with Bootstrap classes.
• JavaScript components relying on Semantic UI have been rewritten to utilize Bootstrap's JavaScript plugins.
• Customized CSS has been replaced by Bootstrap's utility classes.

Removal of jQuery

Most of the existing JavaScript has been replaced by SymfonyUX with Stimulus, which includes live components. This change led to the removal of jQuery and a significant reduction of custom JavaScript in the project. Check out the documentation for more information here.

Abandoning partial routes

All partial routes rendered in templates have been removed and replaced by rendering Twig components.

Sylius Twig Hooks

Twig Hooks are a robust and powerful alternative to the Sonata Block Events and the old Sylius Template Events systems.

Removal of Sonata Blocks

Sonata Blocks have been fully removed as they were not actively maintained/supported for a long time.

Evolving Sylius Template Events to Twig Hooks

Sylius Twig Hooks is a new generation of template customization and extension, providing:

• Built-in support for Twig templates, Twig Components, and Symfony Live Components.
• Adjustability and autoprefixing hooks.
• A configurable and easily manageable system for hookables.
• A priority mechanism to control rendering order.
• Simple enable/disable options for each hook.

1. Key Improvements in Sylius Twig Hooks

Improved Structure

• Hooks

Previously, all template events were configured in a single, monolithic events.yaml file, making it difficult to navigate and maintain:

/app
    /config
        /app
            /events.yaml

With Twig Hooks, the configuration has been reorganized into smaller, more manageable files. Each file corresponds to a specific part of the application, enhancing clarity and maintainability:

/app
    /config
        /app
            /twig_hooks
                /product
                    /create.yaml
                    /update.yaml
                    /index.yaml
                    /show.yaml

• Templates

The structure of the template directories has also been improved. Previously, templates were organized in a less intuitive way, with some structures inconsistent with the template event definitions:

/resources
    /views
        /AdminUser
        /Crud
        /Product
            /Form
            /_avatarImage.html.twig
            /_form.html.twig

Now, the templates are organized in a more consistent manner, with all templates grouped by resource and aligned with hook naming conventions:

/templates
    /product
        /form
            /sections
                /translations
                    description.html.twig
                    meta_description.html.twig
                    meta_keywords.html.twig
                    name.html.twig
                    short_description.html.twig
                    slug.html.twig
                /translations.html.twig
        /show
    /shared
    /another_resource

1. Detailed Comparison: Old vs. New configurations

Old configuration (Template Events)

The previous approach grouped all event blocks within events.yaml, which led to a cluttered and hard-to-manage configuration:

sylius_ui:
    events:
        sylius.admin.index:
            blocks:
                before_header_legacy:
                    template: "@SyliusAdmin/Crud/Block/_legacySonataEvent.html.twig"
                    priority: 25
                    context:
                        postfix: index.before_header
                header:
                    template: "@SyliusAdmin/Crud/Index/_header.html.twig"
                    priority: 20
                after_header_legacy:
                    template: "@SyliusAdmin/Crud/Block/_legacySonataEvent.html.twig"
                    priority: 15
                    context:
                        postfix: index.after_header
                content:
                    template: "@SyliusAdmin/Crud/Index/_content.html.twig"
                    priority: 10
                after_content:
                    template: "@SyliusAdmin/Crud/Block/_legacySonataEvent.html.twig"
                    priority: 5
                    context:
                        postfix: index.after_content

New configuration (Twig Hooks)

The new system organizes hooks by specific parts of the application, simplifying customization and improving readability:

sylius_twig_hooks:
    hooks:
        'sylius_admin.common.index':
            sidebar:
                template: '@SyliusAdmin/shared/crud/common/sidebar.html.twig'
                priority: 200
            navbar:
                template: '@SyliusAdmin/shared/crud/common/navbar.html.twig'
                priority: 100
            content:
                template: '@SyliusAdmin/shared/crud/common/content.html.twig'
                priority: 0

        'sylius_admin.common.index.content':
            flashes:
                template: '@SyliusAdmin/shared/crud/common/content/flashes.html.twig'
                priority: 300
            header:
                template: '@SyliusAdmin/shared/crud/common/content/header.html.twig'
                priority: 200
            grid:
                template: '@SyliusAdmin/shared/crud/index/content/grid.html.twig'
                priority: 100
            footer:
                template: '@SyliusAdmin/shared/crud/common/content/footer.html.twig'
                priority: -100

        'sylius_admin.common.index.content.header':
            breadcrumbs:
                template: '@SyliusAdmin/shared/crud/index/content/header/breadcrumbs.html.twig'
                priority: 100
            title_block:
                template: '@SyliusAdmin/shared/crud/common/content/header/title_block.html.twig'
                priority: 0

        'sylius_admin.common.index.content.header.title_block':
            title:
                template: '@SyliusAdmin/shared/crud/common/content/header/title_block/title.html.twig'
                priority: 100
            actions:
                template: '@SyliusAdmin/shared/crud/common/content/header/title_block/actions.html.twig'
                priority: 0

        'sylius_admin.common.index.content.grid':
            filters:
                template: '@SyliusAdmin/shared/crud/index/content/grid/filters.html.twig'
                priority: 200
            data_table:
                template: '@SyliusAdmin/shared/crud/index/content/grid/data_table.html.twig'
                priority: 100
            no_data_block:
                template: '@SyliusAdmin/shared/crud/index/content/grid/no_results.html.twig'
                priority: 0

        'sylius_admin.common.index.content.grid.no_results':
            image:
                template: '@SyliusAdmin/shared/crud/index/content/grid/no_results/image.html.twig'
                priority: 300
            title:
                template: '@SyliusAdmin/shared/crud/index/content/grid/no_results/title.html.twig'
                priority: 200
            subtitle:
                template: '@SyliusAdmin/shared/crud/index/content/grid/no_results/subtitle.html.twig'
                priority: 100
            action:
                template: '@SyliusAdmin/shared/crud/index/content/grid/no_results/action.html.twig'
                priority: 0

Twig Hooks cover both the admin and shop areas comprehensively, ensuring consistency across the entire application. AdminBundle hooks start with the sylius_admin prefix, while ShopBundle hooks start with the sylius_shop prefix.

For more information visit the Sylius Stack.

Testing Suite

• The sylius.behat.api_security has been replaced by sylius.behat.api_admin_security and sylius.behat.api_shop_security services.
• We removed Psalm, the PHPStan is now the only static analysis tool used in the project.