Sylius/UPGRADE-1.12.md

UPGRADE FROM v1.11.X TO v1.12.0

Main update

1. Service sylius.twig.extension.taxes has been deprecated. Use methods getTaxExcludedTotal and getTaxIncludedTotal from Sylius\Component\Core\Model\Order instead.

2. Both getCreatedByGuest and setCreatedByGuest methods were deprecated on \Sylius\Component\Core\Model\Order. Please use isCreatedByGuest instead of the first one. The latter is a part of the setCustomerWithAuthorization logic and should be used only this way.

3. Due to refactoring constructor has been changed in service src/Sylius/Bundle/ShopBundle/EventListener/OrderIntegrityChecker.php:

     public function __construct(
       private RouterInterface $router,
       - private OrderProcessorInterface $orderProcessor,
       private ObjectManager $manager
       + private OrderPromotionsIntegrityCheckerInterface $orderPromotionsIntegrityChecker 
     )
   

4. To allow administrator reset their password, add in config/packages/security.yaml file the following entry

           - { path: "%sylius.security.admin_regex%/forgotten-password", role: IS_AUTHENTICATED_ANONYMOUSLY }
   

   above

           - { path: "%sylius.security.admin_regex%", role: ROLE_ADMINISTRATION_ACCESS }
   

5. It is worth noticing that, that the following services are now included in every env starting with test keyword. If you wish to not have them, either you need to rename your env to not start with test or remove these services with complier pass.

6. The following listeners have been removed as they are not used anymore:

• Sylius\Bundle\CoreBundle\CatalogPromotion\Listener\CatalogPromotionFailedListener
• Sylius\Bundle\CoreBundle\CatalogPromotion\Listener\CatalogPromotionUpdateFailedMessageListener

7. The Sylius\Component\Promotion\Event\CatalogPromotionFailed has been removed as it is not used anymore.

8. Due to updating to Symfony 6 security file was changed to use the updated security system so you need to adjust your config/packages/security.yaml file:

   security:
       - always_authenticate_before_granting: true
       + enable_authenticator_manager: true
   

   and you need to adjust all of your firewalls like that:

        admin:
            # ...
            form_login:
                # ...
                - csrf_token_generator: security.csrf.token_manager
                + enable_csrf: true
                # ...
        new_api_admin_user:
            # ...
            - anonymous: true
            + entry_point: jwt
            # ...
            - guard:
                 # ...
            + jwt: true
   

   and also you need to adjust all of your access_control like that:

       - - { path: "%sylius.security.admin_regex%/forgotten-password", role: IS_AUTHENTICATED_ANONYMOUSLY }
   
       + - { path: "%sylius.security.admin_regex%/forgotten-password", role: PUBLIC_ACCESS }
   

Asset management changes

We updated gulp-sass plugin as well as the sass implementation we use to be compatible with most installation (node-sass is deprecated and incompatible with many systems). Therefore you need to update your code to follow this change.

1. Change the gulp-sass version you are using to ^5.1.0 (package.json file)

   - "gulp-sass": "^4.0.1",
   + "gulp-sass": "^5.1.0",
   

2. Add sass to your package.json:

   + "sass": "^1.48.0",
   

3. Follow this guide to upgrade your code when using gulp-sass this is an example:

   - import sass from 'gulp-sass';
   + import gulpSass from 'gulp-sass';
   + import realSass from 'sass';
   + const sass = gulpSass(realSass);
   

4. Library chart.js lib has been upgraded from 2.9.3 to 3.7.1. Adjust your package.json as follows:

   - "chart.js": "^2.9.3",
   + "chart.js": "^3.7.1", 
   

   - "rollup": "^0.60.2",
   + "rollup": "^0.66.2",
   

   - "rollup-plugin-uglify": "^4.0.0",
   + "rollup-plugin-uglify": "^6.0.2",
   

   Please visit 3.x Migration Guide for more information.