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 
     )
   

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.