Troubleshooting – Produkt-Historie¶

PAngV-Anzeige erscheint nicht im Storefront¶

Häufigster Fall: Plugin ist installiert, Storefront zeigt aber keinen 30-Tage-Tiefstpreis.

Checkliste¶

Plugin aktiv? Erweiterungen → Meine Erweiterungen → Produkt-Historie aktiviert?
Konfig: PAngV-Anzeige aktiv – ja? Plus, „Anzeigen nur bei Aktion" prüfen – Default ist ein, d.h. die Anzeige erscheint NUR wenn ein Listenpreis (Streichpreis) gesetzt ist.
Mindestens eine Preisänderung in den letzten 30 Tagen vorhanden? Ohne Änderungen ist der 30-Tage-Tiefstpreis gleich dem aktuellen Preis – nichts zu zeigen.
regulierter_preis-Sync gelaufen? bin/console kommora:history:sync-regulated-price manuell ausführen.
Cache leeren nach Sync: bin/console cache:clear
Custom Field am Produkt prüfen: Admin → Produkt → Tab „Custom Fields" → kommora_regulated_price sollte einen Wert haben.

Wenn das Custom Field leer ist¶

Konfig „Custom-Field-Schreiben aktiv" auf ein
Manuell synchronisieren: CLI-Befehl oben
Bei Erfolg: prüfen ob „bei Preisänderung sofort synchen" auf ein

Wenn das Custom Field gefüllt ist, aber Storefront leer¶

Theme-Override prüfen: hat Dein Theme das Buy-Widget oder den Listing-Card stark umgebaut?
Storefront-Cache leeren (CSRF-/HTTP-Cache + Browser-Cache)
Bei Custom Themes ggf. Snippet kommora.history.pangv.label nicht gefunden? Snippet-Set prüfen.

Storefront zeigt rohen Snippet-Key statt Text¶

Symptom: Im Storefront erscheint kommora.history.pangv.label statt „Niedrigster Preis der letzten 30 Tage…".

Ursache: Storefront-Snippets sind nicht eingelesen.

Fix:

php bin/console plugin:refresh
php bin/console cache:clear
bin/build-storefront.sh

Wenn das nicht hilft: Snippets manuell registrieren über Einstellungen → Shop → Textbausteine und prüfen ob kommora.history.pangv.label als Snippet erscheint.

Liste zeigt zu wenige Einträge¶

Symptom: Du erwartest viele History-Einträge, siehst aber nur wenige.

Filter in der Liste prüfen – sind welche aktiv (Feldname, Datum)? Auf „Zurücksetzen" klicken.
„Tracking aktiv" in der Konfig auf ein?
„Tracking auch bei Import / API" – falls Deine Änderungen aus Import oder API kommen, könnten diese deaktiviert sein.
Retention – wenn Du sie auf z.B. 30 Tage gesetzt hast, sind ältere Einträge bereits gelöscht.
Welche Felder werden getrackt – möglicherweise hast Du das gewünschte Feld gar nicht in der Tracking-Liste.

Rollback funktioniert nicht / wird abgewiesen¶

Browser-Konsole (F12) offen: gibt es eine Fehlermeldung?
HTTP-Status der Rollback-Anfrage: 403 = ACL-Problem (User braucht kommora_product_history:update).
Produkt existiert noch? Wenn der Rollback ein Produkt-Feld verändern will, das Produkt aber gelöscht wurde, scheitert er. Wieso ist der Eintrag dann noch da? → die History bleibt auch bei Produktlöschung; Rollback macht semantisch keinen Sinn.
Konflikt mit DAL-Validierung: wenn ein Pflichtfeld auf einen leeren Alt-Wert zurückgesetzt werden soll, kann die DAL die Schreiboperation ablehnen.

Sync-Job läuft nicht automatisch¶

Scheduled Tasks aktiv? bin/console scheduled-task:list → kommora.history.regulated_price_sync muss active sein.
Scheduler überhaupt am laufen? Auf Production typischerweise via systemd oder Cron * * * * * php bin/console scheduled-task:run.
Logs: var/log/prod-*.log nach kommora.history durchsuchen – gibt es Fehlermeldungen?

DAL-Fehler beim Plugin-Start: „Unknown column …created_at"¶

Bei 1.0.0 ohne Patch konnte beim ersten search() ein DAL-Crash auftreten weil die Tabelle keine created_at/updated_at hatte.

Fix: auf 1.0.1+ updaten. Die ProductHistoryDefinition überschreibt jetzt defaultFields() und gibt ein leeres Array zurück – damit fragt DAL diese Spalten nicht mehr an.

Performance: Produkt-Detail-Seite sehr langsam mit Tab „Historie"¶

Symptom: bei Produkten mit sehr vielen History-Einträgen (mehrere hundert) lädt der Tab merklich langsam.

Tipps:

Tab-Filter auf einen einzelnen Feldname setzen – reduziert die Datenmenge sofort
Retention verkürzen – wenn Du nur die letzten 3 Monate brauchst, alles ältere automatisch löschen lassen
Detail-Logging in der Konfig auf „nur Diff" stellen – kleinere Einträge

Preisverlauf-Chart leer¶

Symptom: Im Tab „Historie" der Chart bleibt leer.

Mindestens 2 Preis-Einträge nötig – ein Chart aus einem Datenpunkt ist sinnlos
Chart zeigt nur Preis-Felder (price.*), keine anderen Felder
Bei sehr alten Daten außerhalb der Retention: Chart kann nur die noch vorhandenen Einträge zeigen

Hilfe holen¶

E-Mail an support@kommora.de mit:

Shopware- und Plugin-Version
Welcher Pfad/Workflow nicht funktioniert
Aus var/log/prod-*.log die Fehlermeldungen rund um den Zeitpunkt
Screenshot der Plugin-Konfig
Bei Storefront-Themen: Theme-Name und welche Anpassungen Du am Buy-Widget gemacht hast