UPGRADE-2.x.md

UPGRADE 2.x

UPGRADE FROM 2.x to 2.x

If you are using this bundle with "gedmo/doctrine-extensions", you MUST to specify the translatable listener service name in the configuration.

Before:

# config/packages/sonata_translation.yaml

sonata_translation:
    gedmo:
      enabled: true

After:

# config/packages/sonata_translation.yaml

sonata_translation:
    gedmo:
        enabled: true
        # in case you are using stof/doctrine-extensions-bundle
        translatable_listener_service: stof_doctrine_extensions.listener.translatable

UPGRADE FROM 2.1 to 2.7

Added support for sonata-project/block-bundle ^4.0

If you are using sonata-project/block-bundle, you MUST declare explicitly the dependency with this package on your composer.json in order to avoid unwanted upgrades.

There is a minimal BC break on LocaleSwitcherBlockService. If you are extending this class (keep in mind that it's marked as final and cannot be extended on 4.0) you SHOULD add return type declarations to execute() and configureSettings().

UPGRADE FROM 2.0 to 2.1

Tests

All files under the Tests directory are now correctly handled as internal test classes. You can't extend them anymore, because they are only loaded when running internal tests. More information can be found in the composer docs.

Deprecated traits

The Sonata\TranslationBundle\Traits\Translatable class is deprecated. Use Sonata\TranslationBundle\Traits\TranslatableTrait instead.

The Sonata\TranslationBundle\Traits\PersonalTranslatable class is deprecated. Use Sonata\TranslationBundle\Traits\PersonalTranslatableTrait instead.