Konfigurationsreferenz
Jede Einstellung, die Listing Interrupter bereitstellt, in der Reihenfolge, in der der Admin sie zeigt. Die Feldbeschreibungen sind die Hilfetexte aus dem Plugin — es ist die maßgebliche Quelle dafür.
Plugin-Einstellungen
Das Plugin hat keine shopweiten Einstellungen und keine Einstellungsseite — unter Erweiterungen → Meine Erweiterungen gibt es dafür keine Aktion Konfigurieren. Alles wird je Kachel unter Marketing → Listing Interrupter eingestellt.
Kachel — Tab „Inhalt"
Karte „Allgemein"
| Feld | Typ | Standard | Beschreibung |
|---|---|---|---|
| Name | Text, erforderlich | — | Interner Name in der Liste — für Kunden nicht sichtbar. |
| Aktiv | Schalter | An | Wird angezeigt, sobald die Verfügbarkeitsregel zutrifft |
Karte „Inhalt"
Jedes Feld dieser Karte ist übersetzbar: Wechseln Sie die Shop-Sprache in der Kopfleiste, um eine andere Sprache zu texten. Auf Tablet und Mobil kann jedes Feld zusätzlich eine Geräte-Überschreibung tragen — siehe Geräte-Überschreibungen.
| Feld | Typ | Standard | Beschreibung |
|---|---|---|---|
| Hintergrundbild | Medium | — | Das Hintergrundbild der Kachel. Uploads landen im Ordner Listing Interrupter Media, der Versionen in 400/800/1920 px erzeugt, damit die Storefront je Gerät die passende Größe ausliefert. |
| Badge-Zeile (optional) | Text, übersetzbar | — | Kleine Zeile über der Überschrift, z. B. SALE oder NEU. |
| Überschrift | Text, übersetzbar | — | Die Hauptzeile, die Kunden auf der Kachel lesen. |
| Unterzeile (optional) | Text, übersetzbar | — | Optionale Zusatzzeile unter der Überschrift. |
| CTA-Text | Text, übersetzbar | — | Button-Beschriftung, z. B. Jetzt shoppen. |
| Link öffnet in | Gleicher Tab / Neuer Tab | Gleicher Tab | Link im gleichen oder in einem neuen Tab öffnen. |
| Link-Typ | URL / Kategorie / Produkt | — | Legt fest, ob die Kachel auf eine URL, Kategorie oder ein Produkt verlinkt. |
| Ziel-URL | URL | — | Vollständige Ziel-URL, die die Kachel öffnet. (Link-Typ: URL) |
| Kategorie | Kategorieauswahl | — | Kategorie, auf die die Kachel verlinkt. (Link-Typ: Kategorie) |
| Produkt | Produktauswahl | — | Produkt, auf das die Kachel verlinkt. (Link-Typ: Produkt) |
Karte „Erscheinungsbild"
| Feld | Typ | Standard | Beschreibung |
|---|---|---|---|
| Textfarbe | Farbwähler (Hex) | #ffffff | Farbe von Kacheltext und Button-Beschriftung. |
| Hintergrundfarbe | Farbwähler (Hex) | — | Einfarbige Fläche, wenn kein Hintergrundbild gesetzt ist. |
| Overlay | Kein / Dunkler Verlauf · 40 % / Einfarbig dunkel | Kein | Dunkelt das Hintergrundbild ab, damit der Text lesbar bleibt. |
| Inhaltsausrichtung | Links / Mitte / Rechts | Links | Horizontale Ausrichtung des Textblocks der Kachel. |
| Vertikale Ausrichtung | Oben / Mittig / Unten | Mittig | Vertikale Ausrichtung des Textblocks der Kachel. |
| Ecken | Schalter (Abgerundete Ecken) | An | Rundet die Ecken der Kachel passend zum Theme ab. |
Live-Vorschau
Nur zur Ansicht. Zeigt die Kachel mit Ihrer Storefront-Schriftart und ihrer konfigurierten Breite und zeichnet sich bei jedem Tastendruck neu. Sie folgt dem Geräteumschalter und zeigt damit die aufgelöste Kachel für das Gerät, das Sie bearbeiten. Den genauen Raster-Kontext finden Sie im Tab Platzierung.
Kachel — Tab „Platzierung"
Karte „Wo sie erscheint"
| Feld | Typ | Standard | Beschreibung |
|---|---|---|---|
| Kategorien | Kategoriebaum, Mehrfachauswahl | — | Kategorielisten, in denen die Kachel erscheinen kann. Eine Kachel ohne Kategorie wird nirgends angezeigt. |
| Verkaufskanäle | Mehrfachauswahl | — | Eine Kachel ohne Verkaufskanal wird nirgends angezeigt. |
| Verfügbarkeitsregeln (optional) | Regel-Mehrfachauswahl | — | Regeln decken Zielgruppe und Zeitraum ab — Kundengruppen, Warenkorbwert oder einen Zeitraum über die native Datumsbedingung. Die Kachel wird nur angezeigt, wenn jede ausgewählte Regel zutrifft (weitere hinzufügen, um weiter einzugrenzen). Leer lassen, um die Kachel für alle anzuzeigen. |
Karte „Platzierung pro Gerät"
| Feld | Typ | Standard | Beschreibung |
|---|---|---|---|
| Gerät | Desktop / Tablet / Mobil | Desktop | Welches Gerät Sie bearbeiten. Wird nicht gespeichert — es wählt aus, welche Werte die Karte bearbeitet. |
| Sichtbar auf | Schalter | An | Kachel auf diesem Gerät ausblenden, ohne sie zu löschen. |
| Position | Durch Ziehen der Kachel auf der Fläche | 1 | Der Rasterslot, den die Kachel belegt, ab 1 gezählt. |
| Breite | Durch Ziehen des rechten Kachelrands | 1 Zelle | Wie viele Produktzellen die Kachel belegt, oder eine ganze Zeile. |
| Anzeigen auf Seiten | Text | 1 | Exakt (2), Bereich (1-5), offen (3- oder -2). Leer = alle Seiten; neue Kacheln starten auf Seite 1. Gilt für alle Geräte. |
Die Auswahlfelder unter Vorschau (Verkaufskanal, Kategorie, Seite anzeigen) sind reine Bearbeitungshilfen. Sie werden nie an der Kachel gespeichert.
Syntax des Seitenbereichs
| Wert | Seiten, auf denen die Kachel erscheint |
|---|---|
| (leer) | Alle Seiten |
2 | Nur Seite 2 |
1-5 | Seite 1 bis 5 |
3- | Seite 3 und alle folgenden |
-2 | Seite 1 und 2 |
Alles andere wird beim Speichern abgewiesen mit Kein gültiger Seitenbereich. Nutzen Sie eine Zahl (2), einen Bereich (1-5) oder einen offenen Bereich (3- oder -2).
Werte der Breite
| Gespeicherter Wert | Bedeutung | Verdrängte Produktzellen |
|---|---|---|
"1" … "N" | So viele Produktzellen breit, gedeckelt auf die Spaltenzahl des Geräts | Ebenso viele |
"row" | Ganze Zeile — die Kachel bekommt eine eigene Zeile | Keine |
Ein unbekannter Wert fällt auf eine Zelle zurück.
Geräte-Überschreibungen
Tablet und Mobil erben von Desktop, bis ein Feld über das Kettensymbol entsperrt wird.
| Feld | Je Gerät überschreibbar | Übersetzt |
|---|---|---|
| Hintergrundbild | Ja | Nein |
| Badge-Zeile | Ja | Ja |
| Überschrift | Ja | Ja |
| Unterzeile | Ja | Ja |
| CTA-Text | Ja | Ja |
| Textfarbe | Ja | Nein |
| Hintergrundfarbe | Ja | Nein |
| Overlay | Ja | Nein |
| Position | Ja | Nein |
| Breite | Ja (Desktop + Tablet; Mobil ist einspaltig) | Nein |
| Sichtbar auf Gerät | Ja | Nein |
| Link, Ausrichtung, Ecken | Nein — geräteübergreifend | Nein |
| Anzeigen auf Seiten | Nein — gilt für alle Geräte | Nein |
Für die Verdrängung zählt nur die Desktop-Breite. Siehe Konzepte.
Berechtigungen
Registriert unter Einstellungen → Benutzer & Berechtigungen, Kategorie Inhalte, Schlüssel ssd_listing_interrupter.
| Rolle | Erlaubt | Schließt ein |
|---|---|---|
| Betrachter | Kacheln und ihre Zuweisungen lesen; Kategorien, Regeln, Verkaufskanäle, Produkte und Medien lesen | — |
| Bearbeiter | Kacheln, Übersetzungen und alle Zuweisungen ändern | Betrachter |
| Ersteller | Kacheln anlegen (genutzt von Interrupter erstellen und Duplizieren) | Betrachter, Bearbeiter |
| Löscher | Kacheln löschen | Betrachter |
Routen des Admin-Moduls
| Route | Pfad | Erforderliche Rolle |
|---|---|---|
| Liste | #/ssd/listing/interrupter/list | Betrachter |
| Detail | #/ssd/listing/interrupter/detail/:id | Betrachter |
| Anlegen | #/ssd/listing/interrupter/create | Ersteller |
Navigationseintrag: Marketing → Listing Interrupter.
Entitätsreferenz
Entität ssd_listing_interrupter, über die Admin API erreichbar unter /api/ssd-listing-interrupter.
| Feld | Typ | Hinweise |
|---|---|---|
id | UUID | Primärschlüssel |
name | string | Erforderlich; durchsuchbar |
type | string | Erforderlich; banner |
active | bool | |
priority | int | Reihenfolge, wenn sich Kacheln einen Slot teilen; höher zuerst. Wird beim Anlegen auf 1 gesetzt und ist im Admin nicht editierbar — Änderung über die Admin API |
position | int | Erforderlich; Rasterslot ab 1 |
span | string | Erforderlich; "1"…"N" oder "row" |
pageRange | string, nullable | Ausdruck für den Seitenbereich; null = alle Seiten |
visibility | json | {mobile, tablet, desktop} als Booleans |
viewportOverrides | json, nullable | {tablet?, mobile?} → {mediaId?, span?, position?, styles?}; sprachunabhängig |
link | json, nullable | {type: url|category|product, value, newTab} |
styles | json | {textColor, bgColor, overlayColor, alignment, verticalAlignment, rounded} |
mediaId | UUID, nullable | Hintergrundbild |
headline | string, übersetzt | |
subline | string, übersetzt | |
ctaText | string, übersetzt | |
badgeText | string, übersetzt | |
viewportContentOverrides | json, übersetzt, nullable | {tablet?, mobile?} → {headline?, subline?, ctaText?, badgeText?} |
createdAt / updatedAt | datetime |
Verknüpfungen
| Verknüpfung | Ziel | Zuordnungstabelle |
|---|---|---|
categories | category | ssd_listing_interrupter_category |
salesChannels | sales_channel | ssd_listing_interrupter_sales_channel |
rules | rule | ssd_listing_interrupter_rule |
media | media | — (Fremdschlüssel media_id) |
translations | ssd_listing_interrupter_translation | — |
Das Löschen einer Kachel entfernt kaskadierend ihre Zuweisungen zu Kategorien, Verkaufskanälen und Regeln.
Theme-Anbindung
Die Storefront-Kachel liest eine SCSS-Variable, die Ihr Theme überschreiben kann:
| Variable | Standard | Wirkung |
|---|---|---|
$ssd-listing-interrupter-border-radius | 8px | Eckenradius, wenn Abgerundete Ecken aktiv ist |
Das Plugin nutzt bewusst nicht Bootstraps .rounded-Hilfsklasse: Das Shopware-Storefront-Theme liefert $enable-rounded: false aus, wodurch die Option wirkungslos wäre.
Wirkungsbereich in der Storefront
Kacheln werden innerhalb des CMS-Elements Produktlisting ausgespielt — also auf Kategorielistenseiten. Suchergebnis- und Herstellerseiten sind nicht abgedeckt.
Kompatibilität
| Shopware | ~6.7.0 (Core + Storefront) |
| Plugin-Version | 2.0.0 |