¶ Leere Kategorie Nachrichten
Individuelle "Keine Produkte"-Texte und Bilder pro Kategorie für Shopware 6.7 mit optionaler Vererbung von Elternkategorien.
¶ Features
| Feature | Beschreibung |
|---|---|
| Individuelle Nachrichten | HTML-Nachrichten pro Kategorie wenn keine Produkte vorhanden sind |
| Kategorie-Bilder | Optionale Bilder (z.B. trauriges Smiley) für leere Kategorien |
| Bildgrößen-Steuerung | Klein (150px), Mittel (250px) oder Groß (400px) |
| Flexible Ausrichtung | Separate Bild- und Text-Ausrichtung (links, mittig, rechts) |
| CSS-Klassen | Eigene CSS-Klassen für individuelles Styling |
| Eltern-Vererbung | Optional Nachrichten von übergeordneten Kategorien erben |
| Mehrsprachig | Deutsche und englische Übersetzungen enthalten |
¶ Anforderungen
- Shopware 6.7.x
- PHP 8.2+
¶ Installation
¶ Via Shopware Store (empfohlen)
Die Installation über den Shopware Store wird empfohlen. Nach dem Download kannst du das Plugin direkt aus dem Backend installieren.
¶ Via Composer
composer require mmd/sw67-empty-category
bin/console plugin:install --activate MmdEmptyCategory
bin/console cache:clear
¶ Manuelle Installation
- Plugin von GitHub herunterladen
- Nach
custom/plugins/MmdEmptyCategoryentpacken - Ausführen:
bin/console plugin:refresh
bin/console plugin:install --activate MmdEmptyCategory
bin/console cache:clear
¶ Konfiguration
¶ Leere Kategorie Nachrichten einrichten
- Navigiere zu Kataloge > Kategorien im Admin
- Wähle eine Kategorie aus
- Scrolle zum Bereich Zusatzfelder
- Finde die Feldgruppe Leere Kategorie
¶ Verfügbare Felder
| Feld | Beschreibung |
|---|---|
| Nachricht | HTML-Text der angezeigt wird wenn keine Produkte vorhanden sind |
| Bild | Optionales Bild (z.B. ein trauriges Smiley) |
| Bildgröße | Klein (150px), Mittel (250px), Groß (400px) |
| Bild-Ausrichtung | Links, Mitte, Rechts |
| Text-Ausrichtung | Links, Mitte, Rechts |
| CSS-Klassen | Zusätzliche CSS-Klassen für eigenes Styling |
| Von Eltern erben | Nachricht der übergeordneten Kategorie nutzen wenn keine eigene definiert |
¶ Anwendungsfälle
¶ Beispiel 1: Saisonale Kategorie
Eine "Weihnachts-Specials" Kategorie die außerhalb der Saison leer ist:
Nachricht:
<h3>Demnächst verfügbar!</h3>
<p>Unsere Weihnachts-Specials sind ab November erhältlich. Schau bald wieder vorbei!</p>
Bild: Ein festliches Platzhalterbild
Bildgröße: Groß
Text-Ausrichtung: Mitte
¶ Beispiel 2: Vorübergehend ausverkauft
Eine Kategorie in der Produkte temporär nicht verfügbar sind:
Nachricht:
<p>Alle Produkte in dieser Kategorie sind derzeit ausverkauft.
Wir arbeiten daran, den Bestand aufzufüllen - bitte schau bald wieder vorbei!</p>
CSS-Klasse: alert-warning
¶ Beispiel 3: Kategorie-Hierarchie mit Vererbung
Elternkategorie "Elektronik" mit Nachricht:
<p>In dieser Kategorie sind derzeit keine Produkte verfügbar.</p>
Kindkategorien "Smartphones", "Tablets", "Laptops" alle mit Von Eltern erben: Ja
Ergebnis: Alle Kindkategorien zeigen die Nachricht der Elternkategorie ohne individuelle Konfiguration.
¶ Vererbungs-System
Wenn "Von Eltern erben" aktiviert ist und keine eigene Nachricht definiert:
- Das Plugin prüft ob die aktuelle Kategorie eine eigene Nachricht hat
- Falls nicht, traversiert es den Kategoriebaum nach oben
- Nutzt die erste Elternkategorie mit definierter Nachricht
- Maximale Vererbungstiefe: 10 Ebenen (verhindert Endlosschleifen)
¶ Vererbungs-Regeln
- Eine Kategorie mit eigener Nachricht zeigt immer diese Nachricht
- Vererbung erfolgt nur wenn keine eigene Nachricht gesetzt ist UND Von Eltern erben aktiviert ist
- Die Suche stoppt bei der ersten Elternkategorie die eine Nachricht definiert hat
¶ Styling
¶ Eingebaute CSS-Klassen
Das Plugin gibt strukturiertes HTML aus das du stylen kannst:
<div class="mmd-empty-category-message deine-custom-klasse">
<div class="mmd-empty-category-image-wrapper">
<img class="mmd-empty-category-image" ...>
</div>
<div class="mmd-empty-category-text">
Dein Nachrichteninhalt
</div>
</div>
¶ Eigenes Styling Beispiel
Füge dies zum SCSS deines Themes hinzu:
.mmd-empty-category-message {
padding: 2rem;
background: #f8f9fa;
border-radius: 8px;
text-align: center;
.mmd-empty-category-image {
margin-bottom: 1rem;
}
.mmd-empty-category-text {
color: #666;
h3 {
color: #333;
margin-bottom: 0.5rem;
}
}
}
¶ Technische Details
¶ Twig-Funktion
Das Plugin stellt eine Twig-Funktion für eigene Template-Nutzung bereit:
{% set emptyMessage = mmd_empty_category_message(category) %}
{% if emptyMessage.hasContent() %}
{{ emptyMessage.message|sw_sanitize }}
{% endif %}
¶ Verfügbare Methoden
| Methode | Rückgabe | Beschreibung |
|---|---|---|
hasContent() |
bool | Hat Nachricht oder Bild |
hasMessage() |
bool | Hat Textnachricht |
hasImage() |
bool | Hat Bild-URL |
getImageMaxWidth() |
string | CSS max-width Wert |
getImageJustify() |
string | CSS justify-content Wert |
getTextAlignCss() |
string | CSS text-align Wert |
¶ Eigenschaften
| Eigenschaft | Typ | Beschreibung |
|---|---|---|
message |
string | HTML-Nachrichteninhalt |
imageUrl |
string | Media-URL |
cssClass |
string | Bereinigte CSS-Klassen |
imageSize |
string | small, medium, large |
imageAlign |
string | left, center, right |
textAlign |
string | left, center, right |
¶ Sicherheit
- XSS-Schutz: CSS-Klassen werden bereinigt um Injection zu verhindern
- HTML-Bereinigung: Nachrichten werden mit
sw_sanitizeFilter gerendert - Bild-URLs: Nur Media Manager URLs werden akzeptiert
¶ Lizenz
Dieses Plugin ist unter der GNU General Public License v3 veröffentlicht.
Siehe LICENSE für Details.
¶ Support
Bei Fragen, Problemen oder Beiträgen:
Markus Michalski
E-Mail: support@markus-michalski.net
GitHub: markus-michalski/shopware6-empty-category-67