Important

You are browsing upcoming documentation for version 7.0 of OroCommerce, scheduled for release in 2026. Read the documentation for version 6.1 (the latest LTS version) to get up-to-date information.

See our Release Process documentation for more information on the currently supported and upcoming releases.

Old Themes

Purpose of Legacy Theme Detection

Adding new functionality to an existing theme can accidentally break views or other features of the legacy (old) theme. To avoid such issues, it is important to identify whether the current theme is a legacy theme or inherits from it. This allows you to apply changes conditionally, ensuring that backward compatibility is maintained and that the expected behavior of the old theme is preserved.

How to use OldThemeProvider to Detect Legacy Theme:

1. Inject ``OldThemeProvider`` into your service

   services:
       my_custom.service:
           class: 'Acme\Bundle\MyBundle\Service\MyCustomService'
           arguments:
               - '@oro_layout.old_theme_provider'
               - ['default_51', 'default_50', 'default_60']
   

2. Check if the current Theme is a legacy theme

   namespace Acme\Bundle\MyBundle\Service;
   
   use Oro\Component\Layout\Extension\Theme\Model\OldThemeProvider;
   
   class MyCustomService
   {
       public function __construct(
           private readonly OldThemeProvider $oldThemeProvider,
           private array $oldThemes,
       ) {
       }
   
       public function doSomething(): void
       {
           if ($this->oldThemeProvider->isOldTheme($this->oldThemes)) {
               return;
           }
           ...
       }
   }
   

Note

The method isOldTheme(array $themeNames): bool returns true if the current theme matches or inherits from any themes in the provided array. This is useful when applying layout logic or rendering adjustments specific to particular theme versions.

Note

For more details, see the implementation in the \Oro\Component\Layout\Extension\Theme\Model\OldThemeProvider.