Legacy Shop Bridge Plugin

Product Description:

The Sylius Legacy Shop Bridge Plugin allows stores built on the Sylius 1.x shop frontend to upgrade to Sylius 2.0 without rebuilding their storefront. It restores support for the classic Semantic UI templates, Template Events, and AJAX-based interactions, so your existing shop customizations continue to work on the latest Sylius version.

Sylius 2.0 modernized the shop frontend by moving from Semantic UI to Bootstrap, replacing AJAX calls with Live Components, and introducing Twig Hooks in place of Template Events. These are great improvements for new projects, but stores with deeply customized frontends face a significant effort to migrate. This plugin removes that barrier - whether you plan to migrate gradually or prefer to stay on the classic frontend permanently.

The plugin provides all the shop controllers, template rendering, and routing your 1.x storefront depends on, fully integrated with the Sylius 2.0 core. Install it, and your existing shop frontend works out of the box.

Perfect For:

• Stores with heavily customized Sylius 1.x frontends that would be too costly to rebuild
• Projects upgrading to Sylius 2.0 that want to keep their existing storefront working immediately
• Teams that prefer to stay on the classic frontend permanently because their customizations are stable and working
• Agencies managing client stores that need a safe, low-effort path to Sylius 2.0
• Projects planning a gradual migration to Bootstrap and Twig Hooks - move at your own pace

Key Features:

Legacy Shop Controllers

• Restores all shop controllers for cart, checkout, product pages, orders, account, and more.
• Locale and currency switching, contact form, user registration, and payment processing via Payum.
• AJAX endpoints and partial templates work just like in Sylius 1.x.

Template Events System

• Brings back the Sylius Template Events system for composing pages from reusable template blocks.
• Configure template blocks with priorities and context via YAML - override any section without modifying templates.

Sonata Block Support

• Restores Sonata Block integration for rendering legacy blocks within the shop frontend.
• Variable whitelisting ensures safe and predictable block rendering.

Compatibility and Migration

• Works alongside the new Sylius 2.0 frontend - you can migrate page by page at your own pace.
• Provides backward-compatible Twig filters with deprecation notices to guide future migration.
• Full routing structure for legacy shop pages, AJAX endpoints, and partial templates.

Good to Know

Third-party Sylius plugins updated for 2.0 will use Twig Hooks instead of Template Events. When using this plugin, you may need to adapt those plugins' shop views to work with the legacy Template Events system.