Leere Kategorie Nachrichten: Erweiterbarkeit

Twig-Funktion mmd_empty_category_message, Rückgabeobjekt, Template-Blöcke zum Überschreiben und Hinweise für eigene Themes.

English Version

Zurück zur Übersicht

Erweiterbarkeit

Twig-Funktion

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.

Rückgabeobjekt

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.

Template überschreiben

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.