Fehlerbehebung

Diese Seite sammelt die am häufigsten gesehenen Probleme. Wenn sich Ihr Badge fehlverhält, arbeiten Sie zuerst den passenden Abschnitt durch.

Badge erscheint nicht im Storefront

Prüfen Sie, der Reihe nach:

Plugin ist aktiviert — Einstellungen → Plugins → Produkt-Badges → Allgemein → Plugin aktivieren.
Badge ist aktiv — das Badge wurde nicht deaktiviert.
Mindestens eine Platzierung ist konfiguriert (Detailseite ODER Listingseite). Ein Badge mit beiden Platzierungen auf Ausgeblendet rendert nie.
Das Active-from-/Active-to-Fenster schließt die aktuelle Zeit ein.
Die Verkaufskanal-Einschränkung schließt den aktuellen Storefront ein (oder ist leer).
Regeln treffen alle für den aktuellen Kunden-/Warenkorb-Kontext zu. Testen Sie zuerst ohne angehängte Regeln, um das Problem einzugrenzen.
Zuweisung — für Standard-Badges muss das Produkt in der Zuweisung sein (direkt, per Kategorie, per Hersteller oder per Stream).
Cache — leeren Sie den Shopware-HTTP-Cache (bin/console cache:clear).

Für automatische Typen prüfen Sie auch die zugrundeliegende Bedingung:

Rabatt — hat das Produkt Listenpreis > Verkaufspreis?
Neu — liegt das Erscheinungsdatum (oder das Erstellungsdatum bei aktivem Fallback) im konfigurierten Fenster?
Ausverkauft — ist der effektive Bestand ≤ 0 im gewählten Bestandsprüfungsmodus?
Topseller — ist der Shopware-„Topseller”-Boolean am Produkt wahr?

„Produkt-Badges”-Menü erscheint nicht nach der Installation

Bestätigen Sie, dass das Plugin unter Erweiterungen → Meine Erweiterungen aktiviert ist.
Leeren Sie den Admin-Cache: bin/console cache:clear.
Hartes Neuladen des Admins (Strg+Umschalt+R), damit der Browser das neue Bundle holt.
Wenn Sie die Administration selbst bauen, führen Sie den Administration-Build erneut aus.
Prüfen Sie, dass Ihre Benutzerrolle Zugriff auf die neuen ACL-Schlüssel hat.

Zwei Badges kämpfen um denselben Slot

Verwenden Sie die Priorität — niedrigere Zahl gewinnt. Vergrößern Sie den Prioritätsabstand zwischen Badges, damit die Reihenfolge eindeutig ist.

Wenn weiterhin beide Badges rendern, prüfen Sie den Wert Max. Badges für den Seitenkontext. Max. Badges auf 1 zu setzen macht den Slot zum Einzelgewinner — nur das Badge mit der höchsten Priorität rendert.

Styling wird nicht angewandt

Häufigste Ursache ist die Vererbungsreihenfolge — ein Wert auf einer spezifischeren Ebene überschreibt das, was Sie woanders gesetzt haben. Gehen Sie durch:

Überschreibt das Badge selbst das Feld? Räumen Sie es am Badge auf, damit es durchfällt.
Unterscheidet sich der Slot-Default vom globalen Standard? Vergleichen Sie beide.
Übernimmt der Platzierungs-Default die Vorrangstellung (nur relevant für Nicht-Overlay-Platzierungen)?

Siehe Styling-Überblick für die volle Auflösungskette.

Eckband läuft über das Bild hinaus

Erhöhen Sie den Max. Eckversatz am Slot oder kürzen Sie den Badge-Text — typischerweise ergeben 1 bis 3 Wörter die beste Eckband-Form. Siehe Eckband-Badges.

Shopwares „Neu”-/„Topseller”-/„Rabatt”-Labels werden weiterhin angezeigt

Sie haben ein Plugin-Badge desselben Typs konfiguriert, aber Shopwares schlichte Labels rendern weiterhin daneben. Schalten Sie Standard-Shopware-Badges ausblenden in der globalen Konfiguration, um sie zu unterdrücken. Siehe Standard-Shopware-Badges ausblenden.

„Neu”-Badge erscheint nie

Stellen Sie sicher, dass das Produkt ein Erscheinungsdatum gesetzt hat, oder
Aktivieren Sie den „Neu”-Badge-Fallback in der globalen Konfiguration, damit das Plugin auf das Erstellungsdatum zurückfällt.

Siehe Neu-Badges.

Badge erscheint auf einer Variante, aber nicht auf dem Elternteil (oder umgekehrt)

Für den Typ Ausverkauft wird dies durch den Bestandsprüfungsmodus gesteuert. Wechseln Sie den Modus (nur Produkt / Eltern einschließen) getrennt für Detail- und Listingseiten. Siehe Ausverkauft-Badges.

Für andere Typen folgen Badges dem Standard-Produkt-/Varianten-Rendering von Shopware — stellen Sie sicher, dass die Zuweisung die richtige Entität einschließt.

Storefront zeigt nach einer Änderung weiterhin altes Badge-Styling

Shopware cacht den Storefront-HTML aggressiv. Nach dem Bearbeiten eines Badges:

Leeren Sie den HTTP-Cache: bin/console cache:clear.
Wenn Sie einen Reverse Proxy (Varnish / Cloudflare) verwenden, purgen Sie ihn ebenfalls.
Hart neu laden der Storefront-Seite (Strg+Umschalt+R).

CMS-Layouts zeigen keine Badges

Badges rendern nur in CMS-Elementen, wenn das Layout eines der vier unterstützten Elemente verwendet (Bildergalerie, Kaufbox, Produktbox, Produkt-Slider). Eigenes Twig, das diese Elemente umgeht, erhält die Badge-Integration nicht — siehe CMS-Integration.

Wo zuerst nachsehen

Einstellungen → Plugins → Produkt-Badges → Allgemein — prüfen Sie Plugin aktivieren und Standard-Shopware-Badges ausblenden.
Badge-Formular → Sichtbarkeits-Tab — prüfen Sie Verkaufskanäle, Regeln, Daten.
Badge-Formular → Zuweisungs-Tabs — für Standard-Badges verifizieren, dass das Produkt tatsächlich enthalten ist.
Live-Vorschau — schalten Sie das Vorschau-Panel um, um zu bestätigen, dass das Badge so aussieht wie erwartet.