UPGRADE-2.0.md

UPGRADE FROM 1.x to 2.0

Template variables injection

Interface change for View parameters providers

\Lolautruche\EzCoreExtraBundle\Templating\ViewParameterProviderInterface was deprecated in v1.1 in favor of \Lolautruche\EzCoreExtraBundle\View\ViewParameterProviderInterface. The old interface has been removed. All view parameter providers now must implement the new one.

Themes

Themes are no longer part of EzCoreExtraBundle. This feature has been extracted to ezsystems/ezplatform-design-engine.

Config migration

Design declaration, fallback and selection for a SiteAccess

Important: For new configuration to work, you MUST install ezsystems/ezplatform-design-engine.

Before

ez_core_extra:
    design:
        list:
            my_design: [theme1, theme2]
            
    system:
        my_siteaccess:
            design: my_design

After

ezdesign:
    design_list:
        my_design: [theme1, theme2]

ezpublish:
    # ...
    system:
        my_siteaccess:
            design: my_design

PHPStorm support

Before

ez_core_extra:
    phpstorm:

        # Activates PHPStorm support
        enabled:              '%kernel.debug%'

        # Path where to store PHPStorm configuration file for additional Twig namespaces (ide-twig.json).
        twig_config_path:     '%kernel.root_dir%/..'

After

ezdesign:
    phpstorm:

        # Activates PHPStorm support
        enabled:              '%kernel.debug%'

        # Path where to store PHPStorm configuration file for additional Twig namespaces (ide-twig.json).
        twig_config_path:     '%kernel.root_dir%/..'

Additional templates override paths

Before

ez_core_extra:
    design:
        override_paths:
            - "%kernel.root_dir%/another_override_directory"
            - "/some/other/directory"

After

ezdesign:
    templates_override_paths:
        - "%kernel.root_dir%/another_override_directory"
        - "/some/other/directory"

Assets pre-resolution

Before

# ezplatform_prod.yml
ez_core_extra:
    # Force runtime resolution
    # Default value is '%kernel.debug%'
    disable_assets_pre_resolution: true

After

# ezplatform_prod.yml
ezdesign:
    # Force runtime resolution
    # Default value is '%kernel.debug%'
    disable_assets_pre_resolution: true