StartseiteDokumentationPreishistorie

    Preishistorie

    Preisentwicklung transparent auf der Produktseite anzeigen

    Zur Plugin-Seite →

    Überblick

    Das Plugin erfasst automatisch die Preisentwicklung aller Produkte und zeigt den Verlauf als interaktives Diagramm auf der Produktdetailseite an. Der Kunde sieht transparent, wie sich der Preis über die letzten 6 Monate entwickelt hat.

    Die Preiserfassung erfolgt über einen Subscriber auf Produktänderungen und einen täglichen Cleanup-Task für veraltete Einträge.

    Systemvoraussetzungen

  1. •Shopware 6.7 oder höher
  2. •PHP 8.1 oder höher
  3. •MySQL 8.0 oder höher

    4. Installation

  4. 1.Plugin über den Shopware Plugin-Manager installieren oder manuell in custom/plugins/BcPriceHistory ablegen
  5. 2.Plugin im Plugin-Manager aktivieren
  6. 3.Cache leeren:
    7. php bin/console cache:clear
  7. 4.Die Datenbank-Migration für die bc_price_history-Tabelle wird automatisch ausgeführt.
  8. 5.Der Scheduled Task für die tägliche Bereinigung wird automatisch registriert.

    9. Konfiguration

    Die Plugin-Konfiguration befindet sich unter Erweiterungen > Meine Erweiterungen > BC Preishistorie > Konfiguration (config.xml).

    Allgemein:

  9. •**Plugin aktiv** (`BcPriceHistory.config.active`, Typ: `bool`, Standard: `true`): Globaler Schalter -- wenn deaktiviert, werden keine Preisänderungen erfasst und kein Diagramm angezeigt.
  10. •**Preisverlauf-Diagramm anzeigen** (`BcPriceHistory.config.showChart`, Typ: `bool`, Standard: `true`): Zeigt das Preisverlaufs-Diagramm auf der Produktdetailseite an. Die Preiserfassung läuft unabhängig davon weiter.

    11. Funktionen

    Automatische Preiserfassung

    Der ProductWriteSubscriber reagiert auf das ProductEvents::PRODUCT_WRITTEN_EVENT und erfasst Preisänderungen als bc_price_history-Einträge über den PriceHistoryService.

    Preishistorie-Chart

    Der ProductPageSubscriber reagiert auf das ProductPageLoadedEvent und stellt die Preisverlaufsdaten für das Twig-Template bereit. Das interaktive Diagramm wird über das JavaScript-Plugin BcPriceHistoryChartPlugin gerendert.

    Daten-Bereinigung

    Der PriceHistoryCleanupTask läuft täglich und entfernt veraltete Einträge. Der PriceHistoryCleanupTaskHandler führt die eigentliche Bereinigung durch.

    Events & Hooks

    Das Plugin verwendet keine eigenen Event-Klassen. Es reagiert auf folgende Shopware-Events über Subscriber:

  11. •**`ProductEvents::PRODUCT_WRITTEN_EVENT`** (`ProductWriteSubscriber`) -- Erfasst Preisänderungen bei Produktaktualisierungen.
  12. •**`ProductPageLoadedEvent`** (`ProductPageSubscriber`) -- Stellt Preisverlaufsdaten auf der Produktdetailseite bereit.

    13. Textbausteine (Snippets)

    Storefront-Snippets (src/Resources/snippet/de_DE/bc-price-history.de-DE.json):

  13. •`bc-price-history.chart.title` -- "Preisverlauf"
  14. •`bc-price-history.chart.subtitle` -- "Preisentwicklung der letzten 6 Monate"
  15. •`bc-price-history.chart.noData` -- "Für dieses Produkt liegen noch keine Preisverlaufsdaten vor."

    16. Verfügbar in DE und EN.

    Scheduled Tasks

  16. •**`bc_price_history.cleanup`** (`BcPriceHistory\ScheduledTask\PriceHistoryCleanupTask`): Wird täglich ausgeführt (Intervall: 86400 Sekunden / 24 Stunden). Bereinigt veraltete Preisverlaufseinträge. Der zugehörige Handler ist `PriceHistoryCleanupTaskHandler`.

    17. Datenbank-Tabellen

    Das Plugin erstellt folgende Datenbank-Tabelle über 1 Migration:

    | Tabelle | Entity-Name | Beschreibung |

    |---|---|---|

    | bc_price_history | bc_price_history | Preisverlaufseinträge mit Produktreferenz, Preis und Zeitstempel |

    Migration:

  17. •`Migration1743868800CreatePriceHistoryTable`

    18. Admin-Integration

    Die Konfiguration erfolgt über die Standard-Plugin-Konfiguration. Es gibt kein separates Admin-Modul.

    Der Scheduled Task ist unter Einstellungen > System > Geplante Aufgaben als bc_price_history.cleanup sichtbar und kann manuell ausgelöst werden.

    Storefront-Integration

    Das Plugin erweitert die Produktdetailseite:

    Template:

  18. •`src/Resources/views/storefront/page/content/product-detail.html.twig` -- Preisverlauf-Chart auf der Produktdetailseite

    19. JavaScript-Plugin:

  19. •`BcPriceHistoryChartPlugin` (`src/Resources/app/storefront/src/js/plugin/bc-price-history-chart.plugin.js`) -- Rendert das interaktive Preisverlaufs-Diagramm

    20. Kompiliertes JS:

  20. •`src/Resources/app/storefront/dist/storefront/js/bc-price-history/bc-price-history.js`

    21. Kompatibilität

  21. •Kompatibel mit allen anderen Plugins der Bronner B2B Suite
  22. •Kompatibel mit Standard-Shopware-Themes
  23. •Kompatibel mit Staffelpreisen und kundenspezifischen Preisen
  24. •Getestet mit Shopware 6.7.x
  25. •Unterstützt Multi-Sales-Channel

    26. FAQ

    Weitere Plugin-Dokumentationen

    B2B PlattformPreise ausblendenMindermengenzuschlagAngebotsanfragen