## UPGRADE FROM `2.0.0` TO `2.0.1`

* Renamed `Sylius\Bundle\ThemeBundle\Configuration\Test\TestThemeConfigurationManager` service to `Sylius\Bundle\ThemeBundle\Configuration\Test\TestThemeConfigurationManagerInterface`

## UPGRADE FROM `1.x` TO `2.0`

### Theme structure

* Theme structure has been modified to better imitate Symfony application structure:

    * **Templates:**
    
        * `THEME/views/` replaced with `THEME/templates/`
        * `THEME/AcmeBundle/views/` replaced with `THEME/templates/bundles/AcmeBundle/`
        
    * **Translations:**
    
        * `THEME/AcmeBundle/translations/` merged to `THEME/translations/`
        * It is not possible now to define translations for a given bundle (and it has never been, they were merged behind the scenes)
        
    * **Assets:**
    
        * `THEME/AcmeBundle/public/` replaced with `THEME/public/bundles/acme/`
        * It replicates the way in which assets are loaded (`{{ asset('bundles/acme/asset.jpg') }}`)

* You can still use the old theme structure by enabling `sylius_theme.legacy_mode` setting:

    ```yaml
    sylius_theme:
        legacy_mode: true
    ```
  
    However, it is deprecated as of ThemeBundle 2.0 and will be removed in ThemeBundle 3.0.

### Referencing templates

* Removed support for bundle notation while referencing templates:
   
    * `::template.html.twig` replaced with `template.html.twig`
    * `:Directory/Subdirectory:template.html.twig` replaced with `Directory/Subdirectory/template.html.twig`
    * `AcmeBundle:Dir/Subdir:template.html.twig` replaced with `@Acme/Dir/Subdir/template.html.twig`

* Removed support for resource-based notation while referencing templates:

    * `@AcmeBundle/Resources/views/template.html.twig` replaced with `@Acme/template.html.twig`

### Theming assets

* In ThemeBundle v1, only the bundle assets could be customised with a theme. In ThemeBundle v2, all assets can be themed.

### Services

* Renamed the following services:

    * `sylius.collector.theme` replaced with `Sylius\Bundle\ThemeBundle\Collector\ThemeCollector`
    * `sylius.theme.asset.assets_installer` replaced with `Sylius\Bundle\ThemeBundle\Asset\Installer\AssetsInstaller`
    * `sylius.theme.asset.path_resolver` replaced with `Sylius\Bundle\ThemeBundle\Asset\PathResolverInterface`
    * `sylius.theme.filesystem` replaced with `Sylius\Bundle\ThemeBundle\Filesystem\FilesystemInterface`
    * `sylius.theme.finder_factory` replaced with `Sylius\Bundle\ThemeBundle\Factory\FinderFactoryInterface`
    * `sylius.theme.form.type.theme_choice` replaced with `Sylius\Bundle\ThemeBundle\Form\Type\ThemeChoiceType`
    * `sylius.theme.form.type.theme_name_choice` replaced with `Sylius\Bundle\ThemeBundle\Form\Type\ThemeNameChoiceType`
    * `sylius.theme.locator.application_resource` replaced with `Sylius\Bundle\ThemeBundle\Twig\Locator\ApplicationTemplateLocator`
    * `sylius.theme.locator.bundle_resource` replaced with `Sylius\Bundle\ThemeBundle\Twig\Locator\BundleTemplateLocator` and `Sylius\Bundle\ThemeBundle\Twig\Locator\NamespacedTemplateLocator`
    * `sylius.theme.locator.resource` replaced with `Sylius\Bundle\ThemeBundle\Twig\Locator\TemplateLocatorInterface`
    * `sylius.theme.templating.locator` replaced with `Sylius\Bundle\ThemeBundle\Twig\Locator\TemplateLocatorInterface`
    * `sylius.theme.translation.files_finder` replaced with `Sylius\Bundle\ThemeBundle\Translation\Finder\TranslationFilesFinderInterface`
    * `sylius.theme.translation.loader_provider` replaced with `Sylius\Bundle\ThemeBundle\Translation\Provider\Loader\TranslatorLoaderProviderInterface`
    * `sylius.theme.translation.resource_provider` replaced with `Sylius\Bundle\ThemeBundle\Translation\Provider\Resource\TranslatorResourceProviderInterface`
    
* Deprecated the following services:

    * `sylius.context.theme` superseded by `Sylius\Bundle\ThemeBundle\Context\SettableThemeContext` instead
    * `sylius.factory.theme_author` superseded by `Sylius\Bundle\ThemeBundle\Factory\ThemeAuthorFactoryInterface` instead
    * `sylius.factory.theme_screenshot` superseded by `Sylius\Bundle\ThemeBundle\Factory\ThemeScreenshotFactoryInterface` instead
    * `sylius.factory.theme` superseded by `Sylius\Bundle\ThemeBundle\Factory\ThemeFactoryInterface` instead
    * `sylius.repository.theme` superseded by `Sylius\Bundle\ThemeBundle\Repository\ThemeRepositoryInterface` instead
    * `sylius.theme.circular_dependency_checker` superseded by `Sylius\Bundle\ThemeBundle\Loader\CircularDependencyCheckerInterface` instead
    * `sylius.theme.configuration.processor` superseded by `Sylius\Bundle\ThemeBundle\Configuration\ConfigurationProcessorInterface` instead
    * `sylius.theme.configuration.provider` superseded by `Sylius\Bundle\ThemeBundle\Configuration\ConfigurationProviderInterface` instead
    * `sylius.theme.configuration` superseded by `Sylius\Bundle\ThemeBundle\Configuration\ThemeConfiguration` instead
    * `sylius.theme.context.settable` superseded by `Sylius\Bundle\ThemeBundle\Context\SettableThemeContext` instead
    * `sylius.theme.hierarchy_provider` superseded by `Sylius\Bundle\ThemeBundle\HierarchyProvider\ThemeHierarchyProviderInterface` instead
    * `sylius.theme.loader` superseded by `Sylius\Bundle\ThemeBundle\Loader\ThemeLoaderInterface` instead

* Removed the following services:

    * `sylius.theme.hydrator`
    * `sylius.theme.templating.cache.clearer`
    * `sylius.theme.templating.cache.warmer`
    * `sylius.theme.templating.file_locator`