Twig Macros

Thu, 13 Mar 2025 00:00:00 +0000

Eine Einsteiger-Anleitung zu Twig Macros

Was sind Twig Macros?

Twig Macros sind wiederverwendbare Funktionen innerhalb von Twig-Templates. Sie helfen dabei, Code zu vereinfachen, indem sie Wiederholungen reduzieren und die Wartbarkeit verbessern – ähnlich wie Funktionen in Programmiersprachen.

Ein Macro definieren

Ein Twig Macro wird mit dem Tag {% macro %} definiert. Es kann, genau wie eine Funktion, Parameter entgegennehmen.

1
2
3


{% macro button(text, url, class) %}
 <a href="{{ url }}" class="btn {{ class }}">{{ text }}</a>
{% endmacro %}

Dieses Macro erzeugt eine Button-Komponente, die mehrfach mit unterschiedlichen Werten wiederverwendet werden kann.

Macros im selben Template verwenden

Auch innerhalb der Datei, in der das Macro definiert ist, muss es zuerst importiert werden. {% import _self as macros %} macht die eigenen Macros unter dem Namespace macros verfügbar:

1
2
3


{% import _self as macros %}

{{ macros.button('Click me', 'https://example.com', 'btn-primary') }}

Der frühere Aufruf über {{ _self.button(...) }} ist seit Twig 2.11 veraltet und funktioniert in Twig 3 (und damit in aktuellen Symfony-/Shopware-Versionen) nicht mehr.

Macros in einer separaten Datei speichern

Für eine bessere Organisation können Macros in einer separaten Datei (z. B. macros.twig) gespeichert und bei Bedarf importiert werden.

1
2
3


{% import 'macros.twig' as macros %}

{{ macros.button('Learn More', 'https://example.com', 'btn-secondary') }}

Vorteile von Twig Macros

Code-Wiederverwendung: Vermeidet das Duplizieren gleicher Strukturen.
Bessere Lesbarkeit: Hält Templates sauberer und strukturierter.
Einfache Wartung: Macros einmal aktualisieren und die Änderungen überall übernehmen.

Shopware 6 Subscriber Beispiel

Tue, 21 Jan 2025 00:00:00 +0000

Pfad: MyTheme/src/Subscriber/ProductListingSubscriber.php

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22


<?php

namespace MyTheme\Subscriber;

use Shopware\Core\Content\Product\Events\ProductListingCriteriaEvent;
use Symfony\Component\EventDispatcher\EventSubscriberInterface;

class ProductListingSubscriber implements EventSubscriberInterface
{
 public static function getSubscribedEvents(): array
 {
 return [
 ProductListingCriteriaEvent::class => 'onProductListingCriteria',
 ];
 }

 public function onProductListingCriteria(ProductListingCriteriaEvent $event): void
 {
 $criteria = $event->getCriteria();
 $criteria->addAssociation('properties');
 }
}

Pfad: src/Resources/config/services.xml

 1
 2
 3
 4
 5
 6
 7
 8
 9
10


<?xml version="1.0" ?>
<container xmlns="http://symfony.com/schema/dic/services"
 xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
 xsi:schemaLocation="http://symfony.com/schema/dic/services http://symfony.com/schema/dic/services/services-1.0.xsd">
 <services>
 <service id="MyTheme\Subscriber\ProductListingSubscriber" public="true">
 <tag name="kernel.event_subscriber"/>
 </service>
 </services>
</container>

Nicht vergessen, den Cache zu leeren :)

Symfony on besserentwickeln.de