Customizing Templates
Sylius provides two primary template types: Shop and Admin templates. Additionally, you can create custom templates to meet your specific needs.
Why Customize Templates?
The main reason for modifying existing templates is to implement a unique layout that aligns with your brand. Even if you stick to Sylius's default layout, you might need minor adjustments to fulfill specific business requirements, such as adding a logo.
Template Customization Methods
There are three ways to customize Sylius templates:
Overriding Templates This is done in the
templates/bundles
directory of your project, allowing you to modify templates entirely, the Symfony way.Using Twig Hooks This approach lets you add custom blocks without duplicating entire templates, making it ideal for plugins.
Implementing Sylius Themes Themes allow different designs for multiple channels within a Sylius instance. Although it requires a few additional steps, themes offer enhanced flexibility.
Customizing Templates via Overriding
To determine the template you need to override:
Navigate to the desired page.
In the Symfony toolbar, click on the route. The profiler will display the path in Request Attributes under
_sylius
.
Shop Template Example: Login Page Customization
Default login template:
@SyliusShopBundle/login.html.twig
Override path:
templates/bundles/SyliusShopBundle/login.html.twig
Copy the original template to your path and customize it as needed. Example:
Clear the cache if changes aren't visible: php bin/console cache:clear
Customizing Templates via Twig Hooks
#TODO by Development Team
Twig Hooks: theory
How to locate Twig Hooks?
How to use Twig Hooks for customizations?
Customizing Templates via Sylius Themes
Read more in the Themes documentation in The Book and the bundle's documentation on GitHub.
Global Twig variables
Each of the Twig templates in Sylius is provided with the sylius
variable, that comes from the ShopperContext.
The ShopperContext is composed of ChannelContext
, CurrencyContext
, LocaleContext
and CustomerContext
. Therefore it has access to the current channel, currency, locale, and customer.
The variables available in Twig are:
Twig variable | ShopperContext method name |
sylius.channel | getChannel() |
sylius.currencyCode | getCurrencyCode() |
sylius.localeCode | getLocaleCode() |
sylius.customer | getCustomer() |
How to use these Twig variables?
You can check for example what is the current channel by dumping the sylius.channel
variable.
Thatโs it, this will dump the content of the current Channel object.
Last updated