Zum Inhalt

Installation – Produkt-Historie

Voraussetzungen

Punkt Anforderung
Shopware-Version 6.5.x, 6.6.x oder 6.7.x
PHP ≥ 8.1
Disk-Space ca. 50–500 MB für die History-Tabelle (je nach Shop-Größe, siehe unten)
Scheduled Tasks aktiv (für tägliche regulierter_preis-Aktualisierung)
Plattenbedarf

Eine Faustregel: pro Produktänderung ca. 500–800 Bytes in der History-Tabelle. Bei einem Shop mit 10.000 Produkten und durchschnittlich 5 Änderungen pro Produkt pro Monat sind das ~25–40 MB pro Monat. Über Retention-Policy lässt sich der Bedarf begrenzen (Konfiguration).

Variante A: Über den Shopware Store

  1. Erweiterungen → Im Store → „Produkt-Historie" suchen
  2. Plan auswählen und kaufen
  3. Erweiterungen → Meine Erweiterungen → installieren und aktivieren
  4. Cache wird automatisch geräumt

Variante B: ZIP-Upload

cd /var/www/shopware/custom/plugins
unzip /pfad/zu/KommoraProduktHistorie-1.x.x.zip

cd /var/www/shopware
php bin/console plugin:refresh
php bin/console plugin:install --activate KommoraProduktHistorie
php bin/console cache:clear

Nach der Installation

  1. Im Admin Kommora → Produkt-Historie öffnen – die Tabelle ist leer (logisch, das Tracking läuft erst seit eben).
  2. Eine kleine Test-Änderung an einem Produkt machen (z.B. Preis ändern und zurücksetzen) – nach 1–2 Sekunden erscheinen 2 Einträge in der Historie.
  3. Im Storefront: PAngV-Anzeige greift erst nach 30 Tagen (vorher gibt es nicht genug Datenpunkte). Du siehst sie ab dem 31. Tag – oder Du kannst per CLI ein Bestands-Backfill machen (siehe Troubleshooting).
  4. Konfiguration anpassen falls nötig.

Bestands-Backfill für PAngV (optional)

Wenn Du das Plugin auf einem bestehenden Shop installierst, ist die Historie zunächst leer – die PAngV-Anzeige zeigt also keinen 30-Tage-Tiefstpreis bis 30 Tage Daten vorliegen.

Lösung: Initialer Snapshot des aktuellen Preises mit Datum „vor 30 Tagen":

php bin/console kommora:history:backfill --days=30

Dann hat die History zumindest einen Anker, und die regulierter_preis-Aktualisierung pflegt ab dann normal weiter.

Deinstallation

Mit Datenerhalt (Standard)

Plugin deaktivieren und entfernen. Die History-Tabellen und Custom Fields bleiben erhalten.

Mit kompletter Datenlöschung

Beim Deinstallieren das Häkchen „Daten löschen" setzen:

  • Tabelle kommora_product_history mit allen Einträgen wird gelöscht
  • Custom Field regulierter_preis wird aus allen Produkten entfernt (JSON_REMOVE auf product_translation.custom_fields)
  • Custom-Field-Set wird gelöscht
  • Einträge in system_config werden gelöscht

Scheduled Tasks

Das Plugin registriert zwei Scheduled Tasks:

Task Frequenz Wirkung
kommora.history.regulated_price_sync täglich um 03:00 (anpassbar) aktualisiert das regulierter_preis-Custom-Field auf allen Produkten anhand der 30-Tage-History
kommora.history.retention_cleanup wöchentlich (sonntags 04:00) löscht History-Einträge älter als die konfigurierte Retention (Default 365 Tage)

Beide laufen über den Shopware-Standard-Scheduler. Wenn der Scheduler nicht läuft, läuft auch der Sync nicht (= PAngV-Anzeige veraltet).

CLI-Befehle

Befehl Wirkung
bin/console kommora:history:sync-regulated-price Manuelle Auslösung der regulated-price-Aktualisierung
bin/console kommora:history:cleanup Manuelle Auslösung der Retention-Bereinigung
bin/console kommora:history:backfill --days=N Snapshot des aktuellen Preises mit Datum N Tage zurück (für Initial-Befüllung)

→ Weiter mit Konfiguration oder direkt PAngV-Anzeige einrichten.