Das Plugin stellt die Twig-Funktion mmd_empty_category_message bereit. Sie nimmt eine Kategorie entgegen und liefert ein Nachrichtenobjekt. Bei null ist das Objekt leer.
{% set emptyMessage = mmd_empty_category_message(page.category) %}
{% if emptyMessage.hasContent() %}
{{ emptyMessage.message|sw_sanitize }}
{% endif %}
Die Vererbung und das Bild stehen nur für die Kategorie der aktuellen Kategorieseite (
page.category) zur Verfügung, denn nur dort lädt das Plugin die übergeordneten Kategorien und die Medien nach. Für andere Kategorien liefert die Funktion nur Nachricht, CSS-Klassen und Ausrichtungen, aber keine Bild-URL.
| Eigenschaft | Typ | Standard | Beschreibung |
|---|---|---|---|
message |
string | leer | HTML-Nachricht |
imageUrl |
string | leer | URL des Bildes |
cssClass |
string | leer | Bereinigte CSS-Klassen |
imageSize |
string | medium |
small, medium oder large |
imageAlign |
string | center |
left, center oder right |
textAlign |
string | center |
left, center oder right |
| Methode | Rückgabe | Beschreibung |
|---|---|---|
hasContent() |
bool | Hat Nachricht oder Bild-URL |
hasMessage() |
bool | Hat eine Nachricht |
hasImage() |
bool | Hat eine Bild-URL |
getImageMaxWidth() |
string | 150px, 250px oder 400px je nach Bildgröße |
getImageJustify() |
string | flex-start, center oder flex-end je nach Bild-Ausrichtung |
getTextAlignCss() |
string | Wert für die Text-Ausrichtung, im Zweifel center |
Das mitgelieferte Template nutzt getImageMaxWidth() und getImageJustify() nicht. Es arbeitet mit den CSS-Klassen.
Das Plugin erweitert @Storefront/storefront/component/product/listing.html.twig und überschreibt den Block element_product_listing_col_empty. In einem eigenen Theme kannst du diese Blöcke des Plugin-Templates überschreiben:
| Block | Inhalt |
|---|---|
element_product_listing_col_empty_custom |
Gesamte eigene Nachricht samt Fallback |
element_product_listing_col_empty_custom_image |
Bildbereich |
element_product_listing_col_empty_custom_message |
Textbereich |
element_product_listing_col_empty_alert |
Standardmeldung, wenn keine Nachricht hinterlegt ist |
Das Plugin liest die Zusatzfeld-Werte über die Entität Kategorie. Technische Namen der Felder stehen in der Konfiguration.