LowestPriceHistory — Preishistorie & Niedrigstpreis¶

Extension for Magento 2¶

Bedienungsanleitung¶

CopeX GmbH
Web: https://copex.io
Email: office@copex.io

Inhaltsverzeichnis¶

Abschnitt	Seite
1 Voraussetzungen	2
2 Konfiguration	2
2.1 Allgemeine Einstellungen	2
2.2 Anzeige-Einstellungen	3
2.3 Bereinigung	4
2.4 Cron-Aktualisierung	4
3 Funktionen	5
3.1 Preishistorie-Erfassung	5
3.2 Niedrigstpreis-Anzeige im Frontend	5
3.3 Admin-Übersicht Preishistorie	6
4 Konsolenbefehle	6
5 Fehlerbehandlung	7

1 Voraussetzungen¶

Magento 2.3 oder höher (kompatibel mit 2.4)
PHP 8.1 oder höher
Hyvä Theme oder Luma Theme
Empfohlen für EU-Omnibus-Richtlinie: Verpflichtende Anzeige des niedrigsten Preises der letzten 30 Tage bei beworbenen Preissenkungen

2 Konfiguration¶

Die Konfiguration des Moduls finden Sie im Magento 2 Backend unter Shops > Konfiguration > Price History.

2.1 Allgemeine Einstellungen¶

Navigieren Sie zu Shops > Konfiguration > Price History > Allgemein.

Aktiviert — Hauptschalter für das gesamte Modul (Ja / Nein). Bei Deaktivierung werden keine Preisänderungen mehr gespeichert und die Anzeige im Frontend wird ausgeblendet.

2.2 Anzeige-Einstellungen¶

Navigieren Sie zu Shops > Konfiguration > Price History > Anzeigeeinstellungen.

Dieser Bereich ist nur sichtbar, wenn das Modul unter Allgemein aktiviert ist.

Anzeige auf — Bestimmt, auf welchen Seiten der Niedrigstpreis angezeigt wird:
Nirgends — Kein Frontend-Anzeige
Produktdetailseite — Nur auf einzelnen Produktseiten
Produktdetailseite & Kategorie — Auf Produktseiten und in Kategorielisten
Anzeigemodus — Steuert, für welche Produkte der Niedrigstpreis eingeblendet wird:
Nur bei reduzierten Produkten — Anzeige nur wenn der aktuelle Preis niedriger als der reguläre Preis ist
Bei allen Produkten — Anzeige unabhängig vom aktuellen Preis
Niedrigstpreis der letzten x Tage anzeigen — Anzahl der Tage, für die der Niedrigstpreis berechnet wird. Standardwert: 30. Für EU-Omnibus-Konformität empfiehlt sich der Wert 30.
Vorherigen Niedrigstpreis anzeigen — Wenn der aktuelle Preis bereits der niedrigste Preis der letzten x Tage ist, wird stattdessen der vorherige Niedrigstpreis angezeigt (Ja / Nein).

2.3 Bereinigung¶

Navigieren Sie zu Shops > Konfiguration > Price History > Bereinigung.

Dieser Bereich ist nur sichtbar, wenn das Modul unter Allgemein aktiviert ist.

Automatische Bereinigung der Preishistorie — Aktiviert die automatische Bereinigung alter Preishistorie-Einträge (Ja / Nein).
Bereinigungszeitraum in Tagen — Einträge älter als dieser Wert werden automatisch gelöscht. Standardwert: 90 Tage. Nur sichtbar wenn die automatische Bereinigung aktiviert ist.

2.4 Cron-Aktualisierung¶

Navigieren Sie zu Shops > Konfiguration > Price History > Cron-Aktualisierung.

Dieser Bereich ist nur sichtbar, wenn das Modul unter Allgemein aktiviert ist.

Preise per Cron aktualisieren — Aktiviert einen täglichen Cron-Job, der alle Produktpreise in der Preishistorie aktualisiert (Ja / Nein). Nützlich bei Verwendung von Katalogpreisregeln, da diese Preisänderungen nicht immer einen Produktspeicher-Event auslösen. Verursacht zusätzliche Serverressourcen.

3 Funktionen¶

3.1 Preishistorie-Erfassung¶

Das Modul erfasst Preisänderungen automatisch in folgenden Situationen:

Auslöser	Beschreibung
Produktspeicherung im Backend	Jede manuelle Preisänderung an einem Produkt wird sofort in die Preishistorie gespeichert.
Produktspeicherung über API	Preisänderungen via REST/GraphQL API werden ebenfalls erfasst.
Magento-Katalogimport	Nach einem CSV-Import werden die neuen Preise automatisch in die Preishistorie übernommen.
Cron-Job (optional)	Bei aktiviertem Cron werden täglich alle Produktpreise überprüft und aktualisiert.

Das Modul speichert nur Preisänderungen, d.h. wenn sich der Preis eines Produkts nicht geändert hat, wird kein neuer Eintrag erstellt (Deduplizierungslogik).

Sowohl Sonderpreise als auch Tier-Preise (Gruppenpreise) werden berücksichtigt. Es wird jeweils der niedrigste der verfügbaren Preise gespeichert.

3.2 Niedrigstpreis-Anzeige im Frontend¶

Auf konfigurierten Seiten wird unterhalb des Produktpreises der niedrigste Preis des konfigurierten Zeitraums angezeigt. Die Ausgabe ist gemäß EU-Omnibus-Richtlinie formatiert:

In der Frontend-Ansicht steht die Niedrigstpreis-Information unmittelbar bei der Preisdarstellung auf der Produktseite (und optional in Kategorien).

Dadurch ist für Kundinnen und Kunden transparent nachvollziehbar, welcher niedrigste Preis im betrachteten Zeitraum gegolten hat. Wenn für ein Produkt noch keine ausreichende Historie vorliegt oder die Anzeige im Backend eingeschränkt wurde, wird an dieser Position kein Wert ausgegeben.

Niedrigster Preis der letzten 30 Tage: €XX,XX

Die Anzeige berücksichtigt: - Den konfigurierten Betrachtungszeitraum (z.B. 30 Tage) - Die aktuelle Kundengruppe (z.B. Wholesale-Kunden sehen Gruppenpreise) - Den aktuellen Website-Scope - Den gewählten Anzeigemodus (nur bei Rabatt oder immer)

Für gruppierte Produkte werden die Niedrigstpreise aller enthaltenen Produkte zusammengefasst.

3.3 Admin-Übersicht Preishistorie¶

Navigieren Sie zu Katalog > Preishistorie (oder direkt über die URL copex_lowestpricehistory/lowestpricehistory/index).

Die Admin-Übersicht zeigt alle gespeicherten Preishistorie-Einträge mit:

Produkt-SKU
Preis
Kundengruppe
Website
Erstellungsdatum

Über Massenaktionen können ausgewählte Einträge gelöscht werden, um die Datenbank bei Bedarf manuell zu bereinigen.

4 Konsolenbefehle¶

Das Modul stellt zwei Konsolenbefehle für manuelle Operationen bereit:

# Alle Produktpreise in die Preishistorie aktualisieren
# Nützlich nach einem Dritt-Anbieter-Import (z.B. techdivision/import)
php bin/magento copex:lowestpricehistory:update

# Alte Preishistorie-Einträge manuell bereinigen
php bin/magento copex:lowestpricehistory:clean

Der update-Befehl ist besonders dann sinnvoll, wenn externe Import-Tools verwendet werden, die keinen Standard-Magento-Produktspeicher-Event auslösen.

5 Fehlerbehandlung¶

Niedrigstpreis wird nicht angezeigt — Prüfen Sie, ob das Modul unter Shops > Konfiguration > Price History > Allgemein aktiviert ist. Prüfen Sie außerdem die Einstellungen unter Anzeigeeinstellungen (Anzeige auf, Anzeigemodus).
Preishistorie enthält keine Einträge — Stellen Sie sicher, dass nach der Aktivierung des Moduls mindestens eine Preisänderung gespeichert oder der Konsolenbefehl copex:lowestpricehistory:update ausgeführt wurde.
Cron-Job läuft nicht — Stellen Sie sicher, dass der Magento-Cron korrekt konfiguriert ist (bin/magento cron:run). Prüfen Sie unter Shops > Konfiguration > Price History > Cron-Aktualisierung, ob die Option aktiviert ist.

Lizenz¶

Proprietär — CopeX GmbH. Eine Lizenz pro produktiver Magento-Instanz. Test- und Entwicklungsumgebungen benötigen keine zusätzliche Lizenz.