UPGRADE FROM `v1.12.X` TO `v1.13.0`

Preconditions

PHP 8.1 support

Sylius 1.13 comes with a bump of minimum PHP version to 8.1. We strongly advice to make upgrade process step by step, so it is highly recommended updating your PHP version being still on Sylius 1.12. After ensuring, that previous step succeed, you may move forward to the Sylius 1.13 update.

Symfony support

In Sylius 1.13, the minimum supported version of Symfony 6 has been bumped up to 6.4. Sylius 1.13 supports both long-term supported Symfony versions: 5.4 and 6.4.

Main update

Starting with Sylius 1.13 we provided a possibility to use the Symfony Workflow as your State Machine. To allow a smooth transition we created a new package called sylius/state-machine-abstraction, which provides a configurable abstraction, allowing you to define which adapter should be used (Winzou State Machine or Symfony Workflow) per graph. Starting with Sylius 1.13 we configure all existing Sylius' graphs to use the Symfony Workflow. At the same time, all other graphs are using Winzou State Machine as a default state machine, and must be configured manually to use the Symfony Workflow.

Configuration:
```
sylius_state_machine_abstraction:
    graphs_to_adapters_mapping:
        <graph_name>: <adapter_name>
        # e.g.
        sylius_order_checkout: symfony_workflow # available adapters: symfony_workflow, winzou_state_machine

    # we can also can the default adapter
    default_adapter: symfony_workflow # winzou_state_machine is a default value here
```
Note! Starting with Sylius 2.0 the Symfony Workflow will be the default state machine for all graphs.

A new parameter has been added to specify the validation groups for given gateway factory. If you have any custom validation groups for your factory, you need to add them to your config/packages/_sylius.yaml file. Also, if you have your own gateway factory and want to add your validation groups you can add another entry to the validation_groups configuration node. It is handled by GatewayConfigGroupsGenerator and it resolves the groups based on the passed factory name.

sylius_payum:
    gateway_config:
        validation_groups:
            paypal_express_checkout:
                - 'sylius'
                - 'sylius_paypal_express_checkout'
            stripe_checkout:
                - 'sylius'
                - 'sylius_stripe_checkout'
            your_gateway:
                - 'sylius'
                - 'your_custom_validation_group'

There have been a naw parameters added to specify the validation groups for given shipping method rule and calculator. If you have any custom validation groups for your calculator or rules, you need to add them to your config/packages/_sylius.yaml file. Also, if you have your own shipping method rule or calculator and want to add your validation groups you can add another key to the validation_groups parameter.

sylius_shipping:
    shipping_method_rule:
        validation_groups:
            total_weight_greater_than_or_equal:
                - 'sylius'
                - 'sylius_shipping_method_rule_total_weight'
            order_total_greater_than_or_equal:
                - 'sylius'
                - 'sylius_shipping_method_rule_order_total'
            your_shipping_method_rule:
                - 'sylius'
                - 'your_custom_validation_group'
    shipping_method_calculator:
        validation_groups:
            flat_rate:
                - 'sylius'
                - 'sylius_shipping_method_calculator_rate'
            per_unit_rate:
                - 'sylius'
                - 'sylius_shipping_method_calculator_rate'
            your_shipping_method_calculator:
                - 'sylius'
                - 'your_custom_validation_group'

Class Sylius\Component\Core\Promotion\Updater\Rule\TotalOfItemsFromTaxonRuleUpdater has been deprecated, as it is no more used.
Class Sylius\Component\Core\Promotion\Updater\Rule\ContainsProductRuleUpdater has been deprecated, as it is no more used.
Class Sylius\Bundle\AdminBundle\EmailManager\OrderEmailManager and its interface Sylius\Bundle\AdminBundle\EmailManager\OrderEmailManagerInterface have been deprecated, use Sylius\Bundle\CoreBundle\Mailer\OrderEmailManager and Sylius\Bundle\CoreBundle\Mailer\OrderEmailManagerInterface instead.
Class Sylius\Bundle\AdminBundle\EmailManager\ShipmentEmailManager and its interface Sylius\Bundle\AdminBundle\EmailManager\ShipmentEmailManagerInterface have been deprecated, use Sylius\Bundle\CoreBundle\Mailer\ShipmentEmailManager and Sylius\Bundle\CoreBundle\Mailer\ShipmentEmailManagerInterface instead.
Class Sylius\Bundle\ShopBundle\EmailManager\ContactEmailManager and its interface Sylius\Bundle\ShopBundle\EmailManager\ContactEmailManagerInterface have been deprecated, use Sylius\Bundle\CoreBundle\Mailer\ContactEmailManager and Sylius\Bundle\CoreBundle\Mailer\ContactEmailManagerInterface instead.
Class Sylius\Bundle\ShopBundle\EmailManager\OrderEmailManager and its interface Sylius\Bundle\ShopBundle\EmailManager\OrderEmailManagerInterface have been deprecated, use Sylius\Bundle\CoreBundle\Mailer\OrderEmailManager and Sylius\Bundle\CoreBundle\Mailer\OrderEmailManagerInterface instead.
Class Sylius\Bundle\ProductBundle\Form\Type\ProductOptionChoiceType has been deprecated. Use Sylius\Bundle\ProductBundle\Form\Type\ProductOptionAutocompleteType instead.
Using parentId query parameter to generate slug in Sylius\Bundle\TaxonomyBundle\Controller\TaxonSlugController has been deprecated. Use the parentCode query parameter instead.
Starting with Sylius 1.13, the SyliusPriceHistoryPlugin is included. If you are currently using the plugin in your project, we recommend following the upgrade guide located here.
The Sylius\Bundle\CoreBundle\CatalogPromotion\Command\RemoveInactiveCatalogPromotion command and its handler Sylius\Bundle\CoreBundle\CatalogPromotion\CommandHandler\RemoveInactiveCatalogPromotionHandler have been deprecated. Use Sylius\Bundle\CoreBundle\CatalogPromotion\Command\RemoveCatalogPromotion command instead.
Passing Symfony\Component\Messenger\MessageBusInterface to Sylius\Bundle\CoreBundle\CatalogPromotion\Processor\CatalogPromotionRemovalProcessor as a second and third argument is deprecated.
Passing Sylius\Bundle\AdminBundle\EmailManager\OrderEmailManagerInterface to Sylius\Bundle\AdminBundle\Action\ResendOrderConfirmationEmailAction as a second argument is deprecated, use Sylius\Bundle\CoreBundle\MessageDispatcher\ResendOrderConfirmationEmailDispatcherInterface instead.
The name of the second argument of Sylius\Bundle\AdminBundle\Action\ResendOrderConfirmationEmailAction is deprecated and will be renamed to $resendOrderConfirmationEmailDispatcher.
Passing Sylius\Bundle\AdminBundle\EmailManager\ShipmentEmailManagerInterface to Sylius\Bundle\AdminBundle\Action\ResendShipmentConfirmationEmailAction as a second argument is deprecated, use Sylius\Bundle\CoreBundle\MessageDispatcher\ResendShipmentConfirmationEmailDispatcherInterface instead.
The name of the second argument of Sylius\Bundle\AdminBundle\Action\ResendShipmentConfirmationEmailAction is deprecated and will be renamed to $resendShipmentConfirmationEmailDispatcher.
Passing Sylius\Bundle\AdminBundle\EmailManager\ShipmentEmailManagerInterface to Sylius\Bundle\AdminBundle\EventListener\ShipmentShipListener as a first argument is deprecated, use Sylius\Bundle\CoreBundle\Mailer\ShipmentEmailManagerInterface instead.
Passing Sylius\Bundle\ShopBundle\EmailManager\OrderEmailManagerInterface to Sylius\Bundle\ShopBundle\EventListener\OrderCompleteListener as a first argument is deprecated, use Sylius\Bundle\CoreBundle\Mailer\OrderEmailManagerInterface instead.
Passing Sylius\Bundle\ShopBundle\EmailManager\ContactEmailManagerInterface to Sylius\Bundle\ShopBundle\Controller\ContactController as last argument is deprecated, use Sylius\Bundle\CoreBundle\Mailer\ContactEmailManagerInterface instead.
Not passing Sylius\Bundle\CoreBundle\CatalogPromotion\Announcer\CatalogPromotionRemovalAnnouncerInterface to Sylius\Bundle\CoreBundle\CatalogPromotion\Processor\CatalogPromotionRemovalProcessor as a second argument is deprecated.
Not passing Doctrine\Persistence\ObjectManager to Sylius\Component\Core\Updater\UnpaidOrdersStateUpdater as a fifth argument is deprecated.
Not passing Symfony\Component\Filesystem\Filesystem as fourth argument and parameters file path as fifth to Sylius\Bundle\CoreBundle\Installer\Setup\LocaleSetup is deprecated and will be prohibited in Sylius 2.0.
To ease customization we've introduced attributes for some services in 1.13:
- Sylius\Bundle\OrderBundle\Attribute\AsCartContext for cart contexts
- Sylius\Bundle\OrderBundle\Attribute\AsOrderProcessor for order processors
- Sylius\Bundle\ProductBundle\Attribute\AsProductVariantResolver for product variant resolvers
By default, Sylius still configures them using interfaces, but this way you cannot define a priority. If you want to define a priority, you need to set the following configuration in your _sylius.yaml file:
```
sylius_core:
    autoconfigure_with_attributes: true
```
and use one of the new attributes accordingly to the type of your class, e.g.:
```
 <?php

 declare(strict_types=1);

 namespace App\OrderProcessor;

 use Sylius\Bundle\OrderBundle\Attribute\AsOrderProcessor;
 use Sylius\Component\Order\Model\OrderInterface;
 use Sylius\Component\Order\Processor\OrderProcessorInterface;

 #[AsOrderProcessor(/*priority: 10*/)] //priority is optional
 final class OrderProcessorWithAttributeStub implements OrderProcessorInterface
 {
     public function process(OrderInterface $order): void
     {
     }
 }
```
Not passing Sylius\Component\Core\Checker\ProductVariantLowestPriceDisplayCheckerInterface to Sylius\Component\Core\Calculator\ProductVariantPriceCalculator as a first argument is deprecated.
Not passing an instance of Symfony\Component\PropertyAccess\PropertyAccessorInterface to Sylius\Bundle\CoreBundle\Validator\Constraints\HasEnabledEntityValidator as the second argument is deprecated.
Not passing an instance of Sylius\Component\Core\Payment\Remover\OrderPaymentsRemoverInterface and a collection of unprocessable order states to Sylius\Component\Core\OrderProcessing\OrderPaymentProcessor as the third and fourth arguments respectively is deprecated.
Not passing an instance of Sylius\Component\Core\Distributor\ProportionalIntegerDistributorInterface to Sylius\Component\Core\Taxation\Applicator\OrderItemsTaxesApplicator and to Sylius\Component\Core\Taxation\Applicator\OrderItemUnitsTaxesApplicator as the last argument is deprecated.
Class \Sylius\Bundle\ShopBundle\Calculator\OrderItemsSubtotalCalculator has been deprecated. Order items subtotal calculation is now available on the Order model \Sylius\Component\Core\Model\Order::getItemsSubtotal.
The way of getting variants prices based on options has been changed, as such the following services were deprecated, please use their new counterpart.
- instead of Sylius\Component\Core\Provider\ProductVariantsPricesProviderInterface use Sylius\Component\Core\Provider\ProductVariantMap\ProductVariantsMapProviderInterface
- instead of Sylius\Component\Core\Provider\ProductVariantsPricesProvider use Sylius\Component\Core\Provider\ProductVariantMap\ProductVariantsPricesMapProvider
- instead of Sylius\Bundle\CoreBundle\Templating\Helper\ProductVariantsPricesHelper use Sylius\Component\Core\Provider\ProductVariantMap\ProductVariantsPricesMapProvider
- instead of Sylius\Bundle\CoreBundle\Twig\ProductVariantsPricesExtension use Sylius\Bundle\CoreBundle\Twig\ProductVariantsMapExtension
Subsequently, the sylius_product_variant_prices twig function is deprecated, use sylius_product_variants_map instead.

To add more data per variant create a service implementing the Sylius\Component\Core\Provider\ProductVariantMap\ProductVariantMapProviderInterface and tag it with sylius.product_variant_data_map_provider.
Using Guzzle 6 has been deprecated in favor of Symfony HTTP Client. If you want to still use Guzzle 6 or Guzzle 7, you need to install composer require php-http/guzzle6-adapter or composer require php-http/guzzle7-adapter depending on your Guzzle version. Subsequently, you need to register the adapter as a Psr\Http\Client\ClientInterface service as the following:
```
    services:
        Psr\Http\Client\ClientInterface:
            class: Http\Adapter\Guzzle7\Client # for Guzzle 6 use Http\Adapter\Guzzle6\Client instead
```

The constructor of Sylius\Bundle\AdminBundle\Controller\NotificationController has been changed:

    public function __construct(
-       private ClientInterface $client,
-       private MessageFactory $messageFactory,
+       private ClientInterface|DeprecatedClientInterface $client,
+       private RequestFactoryInterface|MessageFactory $requestFactory,
        private string $hubUri,
        private string $environment,
+       private ?StreamFactoryInterface $streamFactory = null,
    ) {
        ...
    }

The sylius.http_message_factory service has been deprecated. Use Psr\Http\Message\RequestFactoryInterface instead.
The sylius.http_client has become an alias to psr18.http_client service.
The sylius.payum.http_client has become a service ID of newly created Sylius\Bundle\PayumBundle\HttpClient\HttpClient.
Validation translation key sylius.review.rating.range has been replaced by sylius.review.rating.not_in_range in all places used by Sylius. The sylius.review.rating.range has been left for backward compatibility and will be removed in Sylius 2.0.
The payum/payum package has been replaced by concrete packages like payum/core, payum/offline or payum/paypal-express-checkout-nvp. If you need any other component so far provided by payum/payum package, you need to install it explicitly.
PostgreSQL migration support has been introduced. If you are using PostgreSQL, we assume that you have already created a database schema in some way. All you need to do is run migrations, which will mark all migrations created before Sylius 1.13 as executed.
Not passing an $entityManager and passing a $doctrineRegistry to Sylius\Bundle\CoreBundle\Installer\Provider\DatabaseSetupCommandsProvider constructor is deprecated and will be prohibited in Sylius 2.0.
Product variants resolving has been refactored for better extendability. The tag sylius.product_variant_resolver.default has been removed as it was never used.

All internal usages of service sylius.product_variant_resolver.default have been switched to Sylius\Component\Product\Resolver\ProductVariantResolverInterface, if you have been using the sylius.product_variant_resolver.default service apply this change accordingly.
Due to optimizations of the Order's grid the Sylius\Component\Core\Repository\OrderRepositoryInterface::createSearchListQueryBuilder method bas been deprecated in both the interface and the class, and replaced by Sylius\Component\Core\Repository\OrderRepositoryInterface::createCriteriaAwareSearchListQueryBuilder. Also Sylius\Component\Core\Repository\OrderRepositoryInterface::createByCustomerIdQueryBuilder has been deprecated in both the interface and the class, and replaced by Sylius\Component\Core\Repository\OrderRepositoryInterface::createByCustomerIdCriteriaAwareQueryBuilder for the same reason. Both changes affect sylius_admin_order and sylius_admin_customer_order grids configuration.
We have explicitly added relationships between product and reviews and between product and attributes in XML mappings. Because of that, the subscribers Sylius\Bundle\AttributeBundle\Doctrine\ORM\Subscriber\LoadMetadataSubscriber and Sylius\Bundle\ReviewBundle\Doctrine\ORM\Subscriber\LoadMetadataSubscriber have changed so that it does not add a relationship if one already exists. If you have overwritten or decorated it, there may be a need to update it.
Passing an instance of Sylius\Component\Resource\Translation\Provider\TranslationLocaleProviderInterface as the first argument to Sylius\Bundle\AttributeBundle\Form\Type\AttributeType\Configuration\SelectAttributeChoicesCollectionType has been deprecated.
The sylius_admin_ajax_taxon_move route has been deprecated. If you're relaying on it, consider migrating to new sylius_admin_ajax_taxon_move_up and sylius_admin_ajax_taxon_move_down routes.
Not passing a $fileLocator to Sylius\Bundle\CoreBundle\Fixture\Factory\ProductExampleFactory constructor is deprecated and will be prohibited in Sylius 2.0.
Interface Sylius\Bundle\ShopBundle\Calculator\OrderItemsSubtotalCalculatorInterface and class Sylius\Bundle\ShopBundle\Twig\OrderItemsSubtotalExtension responsible for the sylius_order_items_subtotal twig function have been deprecated and will be removed in Sylius 2.0. Use the ::getItemsSubtotal() method from the Order class instead.
The Sylius\Bundle\CoreBundle\Fixture\Factory\PaymentFixture has been deprecated. Use Sylius\Bundle\CoreBundle\Fixture\PaymentFixture instead.
Not passing a $router to Sylius\Bundle\AdminBundle\Controller\ImpersonateUserController as the fourth argument is deprecated and will be prohibited in Sylius 2.0.
The Sylius\Bundle\CoreBundle\Provider\SessionProvider has been deprecated and will be removed in Sylius 2.0.
Interface Sylius\Component\Core\Promotion\Updater\Rule\ProductAwareRuleUpdaterInterface has been deprecated and will be removed in Sylius 2.0.
Both getCreatedByGuest and setCreatedByGuest methods were deprecated on \Sylius\Component\Core\Model\OrderInterface. Please use isCreatedByGuest instead of the first one. The latter is a part of the setCustomerWithAuthorization logic and should be used only this way.
The Sylius\Bundle\ShippingBundle\Provider\Calendar and Sylius\Bundle\ShippingBundle\Provider\DateTimeProvider have been deprecated and will be removed in Sylius 2.0. Use Symfony\Component\Clock\Clock instead. Note: this class is available since Symfony 6.2.
In the sylius_payment state machine of PaymentBundle, there has been a change in the state name:
- State name change:
  - From: void
  - To: unknown
In the sylius_payment state machine of PaymentBundle, a new state authorized has been introduced, along with a new transition:
- Transition authorize:
  - From states: [new, processing]
  - To state: authorized
Due to that the following transitions have been updated:
- Transition complete:
  - From states: [new, processing, authorized]
  - To state: completed
- Transition fail:
  - From states: [new, processing, authorized]
  - To state: failed
- Transition cancel:
  - From states: [new, processing, authorized]
  - To state: cancelled
- Transition void:
  - From states: [new, processing, authorized]
  - To state: unknown

The sylius_payment state machine of CoreBundle has been updated to allow failing an authorized payment:

    fail:
-       from: [new, processing]
+       from: [new, processing, authorized]
        to: failed

Change in the Sylius\Bundle\CoreBundle\Fixture\Factory\PromotionExampleFactory constructor: Added the $localeRepository argument to the constructor of the PromotionExampleFactory class. Not passing an instance of RepositoryInterface for the locale entity repository in $localeRepository was marked as deprecated and will be prohibited in Sylius 2.0.
The Regex constraint has been removed from Sylius\Component\Addressing\Model\Country in favour of the Country constraint. Due to that, it's translation message sylius.country.code.regex was also removed.
The redirectToCartSummary protected method of Sylius\Bundle\OrderBundle\Controller\OrderController has been deprecated as it was never used and will be removed in Sylius 2.0.
Interface Sylius\Component\Promotion\Generator\PromotionCouponGeneratorInstructionInterface has been refactored and is now deprecated. It now extends a new interface Sylius\Component\Promotion\Generator\PromotionCouponGeneratorInstructionReadInterface, which contains only getter methods.
- If your services or custom implementations previously relied on PromotionCouponGeneratorInstructionInterface for read operations, you should now use PromotionCouponGeneratorInstructionReadInterface for better clarity and separation of concerns.
- This change is backward compatible as long as your implementations or services were using only the getter methods from PromotionCouponGeneratorInstructionInterface. However, if you also utilized setter methods, you should continue using PromotionCouponGeneratorInstructionInterface.
A new parameter has been added to specify the validation groups for a given promotion action. If you have any custom validation groups for your promotion action, you need to add them to your config/packages/_sylius.yaml file. Additionally, if you have your own promotion action and want to add your validation groups, you can add another key to the promotion_action.validation_groups parameter. This is handled by Sylius\Bundle\PromotionBundle\Validator\PromotionActionGroupValidator and it resolves the groups based on the type of the passed promotion action.
```
sylius_promotion:
    promotion_action:
        validation_groups:
            order_percentage_discount:
                - 'sylius'
                - 'sylius_promotion_action_order_percentage_discount'
            shipping_percentage_discount:
                - 'sylius'
                - 'sylius_promotion_action_shipping_percentage_discount'
            your_promotion_action:
                - 'sylius'
                - 'your_custom_validation_group'
```
Along with this update, constraints have been removed from specific action form types. The affected form types include:
- Sylius\Bundle\PromotionBundle\Form\Type\Action\FixedDiscountConfigurationType
- Sylius\Bundle\PromotionBundle\Form\Type\Action\PercentageDiscountConfigurationType
- Sylius\Bundle\PromotionBundle\Form\Type\Action\UnitFixedDiscountConfigurationType
- Sylius\Bundle\PromotionBundle\Form\Type\Action\UnitPercentageDiscountConfigurationType
The constraints previously defined in these forms are now in src/Sylius/Bundle/CoreBundle/Resources/config/validation/PromotionAction.xml and managed via the new validation groups parameters in the configuration.
A new parameter has been added to specify the validation groups for a given promotion rule. If you have any custom validation groups for your promotion rule, you need to add them to your config/packages/_sylius.yaml file. Additionally, if you have your own promotion rule and want to add your validation groups, you can add another key to the promotion_rule.validation_groups parameter. This is handled by Sylius\Bundle\PromotionBundle\Validator\PromotionRuleGroupValidator and it resolves the groups based on the type of the passed promotion rule.
```
sylius_promotion:
    promotion_rule:
        validation_groups:
            cart_quantity:
                - 'sylius'
                - 'sylius_promotion_rule_cart_quantity'
            customer_group:
                - 'sylius'
                - 'sylius_promotion_rule_customer_group'
            your_promotion_rule:
                - 'sylius'
                - 'your_custom_validation_group'
```
Along with this update, constraints have been removed from specific rule form types. The affected form types include:
- Sylius\Bundle\CoreBundle\Form\Type\Promotion\Rule\ContainsProductConfigurationType
- Sylius\Bundle\CoreBundle\Form\Type\Promotion\Rule\NthOrderConfigurationType
- Sylius\Bundle\PromotionBundle\Form\Type\Rule\CartQuantityConfigurationType
- Sylius\Bundle\PromotionBundle\Form\Type\Rule\ItemTotalConfigurationType
The constraints previously defined in these forms are now in src/Sylius/Bundle/CoreBundle/Resources/config/validation/PromotionRule.xml and managed via the new validation groups parameters in the configuration.
The Sylius\Component\Addressing\Repository\ZoneRepositoryInterface and Sylius\Bundle\AddressingBundle\Repository\ZoneRepository were added. If you created a custom Zone repository, you should update it to extend the Sylius\Bundle\AddressingBundle\Repository\ZoneRepository

The constructor of Sylius\Component\Addressing\Matcher\ZoneMatcher has been changed:

use Sylius\Component\Addressing\Repository\ZoneRepositoryInterface;
use Sylius\Component\Resource\Repository\RepositoryInterface;

    public function __construct(
-       private RepositoryInterface $zoneRepository,
+       private RepositoryInterface|ZoneRepositoryInterface $zoneRepository,
    )

Moved classes from Command to Console\Command. The Command namespace is deprecated for console command classes and will be removed in Sylius 2.0. List of affected classes:
- \Sylius\Bundle\OrderBundle\Command\RemoveExpiredCartsCommand to \Sylius\Bundle\OrderBundle\Console\Command\RemoveExpiredCartsCommand
- \Sylius\Bundle\PromotionBundle\Command\GenerateCouponsCommand to \Sylius\Bundle\PromotionBundle\Console\Command\GenerateCouponsCommand
- \Sylius\Bundle\UiBundle\Command\DebugTemplateEventCommand to \Sylius\Bundle\UiBundle\Console\Command\DebugTemplateEventCommand
- \Sylius\Bundle\UserBundle\Command\AbstractRoleCommand to \Sylius\Bundle\UserBundle\Console\Command\AbstractRoleCommand
- \Sylius\Bundle\UserBundle\Command\DemoteUserCommand to \Sylius\Bundle\UserBundle\Console\Command\DemoteUserCommand
- \Sylius\Bundle\UserBundle\Command\PromoteUserCommand to \Sylius\Bundle\UserBundle\Console\Command\PromoteUserCommand
- \Sylius\Bundle\CoreBundle\Command\Model\PluginInfo to \Sylius\Bundle\CoreBundle\Console\Command\Model\PluginInfo
- \Sylius\Bundle\CoreBundle\Command\AbstractInstallCommand to \Sylius\Bundle\CoreBundle\Console\Command\AbstractInstallCommand
- \Sylius\Bundle\CoreBundle\Command\CancelUnpaidOrdersCommand to \Sylius\Bundle\CoreBundle\Console\Command\CancelUnpaidOrdersCommand
- \Sylius\Bundle\CoreBundle\Command\CheckRequirementsCommand to \Sylius\Bundle\CoreBundle\Console\Command\CheckRequirementsCommand
- \Sylius\Bundle\CoreBundle\Command\InformAboutGUSCommand to \Sylius\Bundle\CoreBundle\Console\Command\InformAboutGUSCommand
- \Sylius\Bundle\CoreBundle\Command\InstallAssetsCommand to \Sylius\Bundle\CoreBundle\Console\Command\InstallAssetsCommand
- \Sylius\Bundle\CoreBundle\Command\InstallCommand to \Sylius\Bundle\CoreBundle\Console\Command\InstallCommand
- \Sylius\Bundle\CoreBundle\Command\InstallDatabaseCommand to \Sylius\Bundle\CoreBundle\Console\Command\InstallDatabaseCommand
- \Sylius\Bundle\CoreBundle\Command\InstallSampleDataCommand to \Sylius\Bundle\CoreBundle\Console\Command\InstallSampleDataCommand
- \Sylius\Bundle\CoreBundle\Command\JwtConfigurationCommand to \Sylius\Bundle\CoreBundle\Console\Command\JwtConfigurationCommand
- \Sylius\Bundle\CoreBundle\Command\SetupCommand to \Sylius\Bundle\CoreBundle\Console\Command\SetupCommand
- \Sylius\Bundle\CoreBundle\Command\ShowAvailablePluginsCommand to \Sylius\Bundle\CoreBundle\Console\Command\ShowAvailablePluginsCommand
In version 2.0 introduces a significant restructuring of our class system to enhance efficiency and clarity. The changes are as follows:
- Message will be migrated to Command.
- MessageDispatcher will be migrated to CommandDispatcher.
- MessageHandler will be migrated to CommandHandler.
- Example: Within the Sylius\Bundle\CoreBundle, the MessageHandler\OrderHandler class will be migrated to CommandHandler\OrderHandler. This pattern will be mirrored across other bundles in the system.
The behavior of the sylius:install:setup command has changed, because Sylius\Bundle\CoreBundle\Installer\Setup\LocaleSetup has been updated. Now, it automatically replaces the existing locale parameter in the configuration with the one provided for the store.
A new parameter has been added to specify the validation groups for a given catalog promotion scope. If you have any custom validation groups for your catalog promotion scope, you need to add them to your config/packages/_sylius.yaml file. Additionally, if you have your own catalog promotion scope and want to add your validation groups, you can add another key to the catalog_promotion_scope.validation_groups parameter. This is handled by Sylius\Bundle\PromotionBundle\Validator\CatalogPromotionScopeGroupValidator and it resolves the groups based on the type of the passed catalog promotion scope.
```
sylius_promotion:
    catalog_promotion_scope:
        validation_groups:
            for_products:
                - 'sylius'
                - 'sylius_catalog_promotion_scope_for_products'
            for_taxons:
                - 'sylius'
                - 'sylius_catalog_promotion_scope_for_taxons'
            your_scope:
                - 'sylius'
                - 'your_custom_validation_group'
```
Along with this update, constraints have been removed from specific rule form types. The affected form types include:
- Sylius\Bundle\CoreBundle\Form\Type\CatalogPromotionScope\ForProductsScopeConfigurationType
- Sylius\Bundle\CoreBundle\Form\Type\CatalogPromotionScope\ForTaxonsScopeConfigurationType
- Sylius\Bundle\CoreBundle\Form\Type\CatalogPromotionScope\ForVariantsScopeConfigurationType
The constraints previously defined in these forms are now in src/Sylius/Bundle/CoreBundle/Resources/config/validation/CatalogPromotionScope.xml and managed via the new validation groups parameters in the configuration.
A new parameter has been added to specify the validation groups for a given catalog promotion action. If you have any custom validation groups for your catalog promotion action, you need to add them to your config/packages/_sylius.yaml file. Additionally, if you have your own catalog promotion action and want to add your validation groups, you can add another key to the catalog_promotion_action.validation_groups parameter. This is handled by Sylius\Bundle\PromotionBundle\Validator\CatalogPromotionActionGroupValidator and it resolves the groups based on the type of the passed catalog promotion action.
```
sylius_promotion:
    catalog_promotion_action:
        validation_groups:
            percentage_discount:
                - 'sylius'
                - 'sylius_catalog_promotion_action_percentage_discount'
            fixed_discount:
                - 'sylius'
                - 'sylius_catalog_promotion_action_fixed_discount'
            your_action:
                - 'sylius'
                - 'your_custom_validation_group'
```
Along with this update, constraints have been removed from specific rule form types. The affected form types include:
- Sylius\Bundle\PromotionBundle\Form\Type\CatalogPromotionAction\FixedDiscountActionConfigurationType
- Sylius\Bundle\PromotionBundle\Form\Type\CatalogPromotionAction\PercentageDiscountActionConfigurationType
The constraints previously defined in these forms are now in src/Sylius/Bundle/PromotionBundle/Resources/config/validation/CatalogPromotionAction.xml and src/Sylius/Bundle/CoreBundle/Resources/config/validation/CatalogPromotionAction.xml and are managed via the new validation groups parameters in the configuration.
Since catalog promotion action and scope validations have been rewritten to be more inline with symfony, the previous abstraction has been deprecated. This includes:
- Sylius\Bundle\PromotionBundle\Validator\CatalogPromotionAction\ActionValidatorInterface
- Sylius\Bundle\PromotionBundle\Validator\CatalogPromotionScope\ScopeValidatorInterface
- Sylius\Bundle\PromotionBundle\Validator\CatalogPromotionActionValidator
- Sylius\Bundle\PromotionBundle\Validator\CatalogPromotionScopeValidator
Class Sylius\Component\Promotion\Checker\Rule\CartQuantityRuleChecker has been deprecated. Use Sylius\Component\Core\Promotion\Checker\Rule\CartQuantityRuleChecker instead.
Class Sylius\Component\Promotion\Checker\Rule\ItemTotalRuleChecker has been deprecated. Use Sylius\Component\Core\Promotion\Checker\Rule\ItemTotalRuleChecker instead.
The first parameter of the constructor in the \Sylius\Component\Core\Promotion\Checker\Rule\ItemTotalRuleChecker class has been deprecated and will be removed in version 2.0.
The service definition for sylius.promotion_rule_checker.item_total has been updated. The class has been changed from Sylius\Component\Promotion\Checker\Rule\ItemTotalRuleChecker to Sylius\Component\Core\Promotion\Checker\Rule\ItemTotalRuleChecker.

Sylius Mailer email configuration keys in the src/Sylius/Bundle/CoreBundle/Resources/config/app/sylius/sylius_mailer.yml file have been changed:

Deprecated:

sylius_mailer:
    emails:
       account_verification_token:
           subject: sylius.emails.user.verification_token.subject

New:

sylius_mailer:
    emails:
        account_verification:         
            subject: sylius.email.user.account_verification.subject

Translation keys in the Sylius\Bundle\CoreBundle\Resources\translations\messages.en.yml under the sylius.email key have been changed:

Deprecated:

sylius:
    email:  
        verification_token:
            hello: 'Hello'
            message: 'Verify your account with token: '
            subject: 'Email address verification'
            to_verify_your_email_address: 'To verify your email address - click the link below'
            verify_your_email_address: 'Verify your email address'

New:

sylius:
    email:
        user:
            account_verification:
                greeting: 'Hello'
                message: 'Verify your account with token: '
                statement: 'Verify your email address'
                strategy: 'To verify your email address - click the link below'
                subject: 'Email address verification'

1 Extracted the section responsible for the ShopBundle from @SyliusCore/Email/accountVerification.html.twig and relocated it to @SyliusShop/Email/verification.html.twig.

35 KiB Raw Blame History

UPGRADE FROM v1.12.X TO v1.13.0

Preconditions

PHP 8.1 support

Symfony support

Main update

35 KiB

Raw Blame History

UPGRADE FROM `v1.12.X` TO `v1.13.0`