Omnibus Directive - price tracking

Die Omnibus-Richtlinie (EU 2019/2161) gilt in Polen seit dem 1. Januar 2023. Bei jeder Preissenkung müssen Sie den niedrigsten Preis der letzten 30 Tage anzeigen. Das Plugin verfolgt automatisch die Preishistorie und zeigt diese Information bei Aktionen an.

Wie die Preisverfolgung funktioniert

Das Plugin speichert jede Preisänderung eines Produkts (einschließlich Varianten) in der Datenbank. Wenn ein Produkt “im Angebot” ist, berechnet das Plugin den niedrigsten Preis der letzten 30 Tage und zeigt ihn den Kunden an.

Die Verfolgung beginnt nach dem Aktivieren des Moduls. Wenn ein Produkt noch keine Preishistorie hat, wird eine Platzhaltermeldung angezeigt.

Konfiguration

Gehen Sie zu WooCommerce > Einstellungen > Polski > Omnibus und konfigurieren Sie die verfügbaren Optionen.

Verfolgungszeitraum

Option	Beschreibung	Standardwert
days	Anzahl der Tage rückwirkend zur Berechnung des niedrigsten Preises	30
prune_after_days	Nach wie vielen Tagen alte Historieneinträge gelöscht werden	90

prune_after_days steuert die Größe der Datenbanktabelle. Ein Wert von 90 bedeutet, dass Daten, die älter als 90 Tage sind, automatisch gelöscht werden.

Steuern

Option	Beschreibung	Standardwert
include_tax	Ob der angezeigte Omnibus-Preis die Mehrwertsteuer enthalten soll	true

Stellen Sie dies gemäß Ihren WooCommerce-Preiseinstellungen ein. Wenn die Preise im Shop Bruttopreise sind, lassen Sie true.

Anzeigeorte

Option	Beschreibung	Standardwert
display_on_sale_only	Nur bei Produkten im Angebot anzeigen	true
show_on_single	Einzelproduktseite	true
show_on_loop	Produktliste (Kategorie, Shop)	false
show_on_related	Ähnliche Produkte	false
show_on_cart	Warenkorb	false

Aktivieren Sie es mindestens auf der Produktseite (show_on_single). In der Produktliste (show_on_loop) nimmt es mehr Platz ein, aber einige Auslegungen der Vorschriften verlangen dies.

Regulärer Preis

Option	Beschreibung	Standardwert
show_regular_price	Auch den regulären Preis neben dem Omnibus-Preis anzeigen	false

Textvorlage

Option	Beschreibung	Standardwert
display_text	Vorlage für die angezeigte Meldung	Niedrigster Preis der letzten {days} Tage vor der Senkung: {price}
no_history_text	Text, wenn keine Preishistorie vorliegt	Keine Daten zum vorherigen Preis verfügbar

Verfügbare Variablen in der Vorlage display_text:

• {price} - niedrigster Preis im angegebenen Zeitraum
• {days} - Anzahl der Tage (Standard 30)
• {date} - Datum des niedrigsten Preises
• {regular_price} - regulärer Produktpreis (vor der Aktion)

Vorlagenbeispiele

Niedrigster Preis der letzten {days} Tage vor der Senkung: {price}

Niedrigster Preis der letzten {days} Tage: {price} (regulärer Preis: {regular_price})

Omnibus: {price} (vom {date})

Berechnungsmethode des Preises

Option	Beschreibung	Standardwert
price_count_from	Ab wann die 30 Tage gezählt werden	sale_start

Verfügbare Werte:

• sale_start - ab dem Startdatum der Aktion (von UOKiK empfohlen)
• current_date - ab dem aktuellen Datum

Variable Produkte

Option	Beschreibung	Standardwert
variable_tracking	Verfolgungsmethode für Varianten	per_variation

Verfügbare Werte:

• per_variation - separate Verfolgung für jede Variante (empfohlen)
• parent_only - Verfolgung nur des Preises des übergeordneten Produkts

per_variation liefert genauere Daten, da jede Variante einen anderen Preis und eine andere Aktionshistorie haben kann.

Shortcode

Verwenden Sie den Shortcode [polski_omnibus_price], um die Information zum niedrigsten Preis an beliebiger Stelle der Website anzuzeigen.

Grundlegende Verwendung

[polski_omnibus_price]

Zeigt den Omnibus-Preis für das aktuelle Produkt an.

Mit Parametern

[polski_omnibus_price product_id="456" days="30"]

Shortcode-Parameter

Parameter	Beschreibung	Standardwert
product_id	Produkt-ID	Aktuelles Produkt
days	Anzahl der Tage	Wert aus den Einstellungen

Beispiel für die Verwendung in einer PHP-Vorlage

echo do_shortcode('[polski_omnibus_price product_id="' . $product_id . '"]');

Automatische Historienbereinigung

WP-Cron entfernt täglich Preishistorieneinträge, die älter als prune_after_days sind. Die Datenbanktabelle wächst nicht unbegrenzt.

Um die Bereinigung manuell zu erzwingen, können Sie WP-CLI verwenden:

wp cron event run polski_omnibus_prune

Konformität mit den UOKiK-Richtlinien

UOKiK-Richtlinien:

1. Die Information zum niedrigsten Preis muss bei jeder Ankündigung einer Preissenkung angezeigt werden
2. Der Referenzzeitraum sind 30 Tage vor Anwendung der Preissenkung
3. Bei Produkten, die kürzer als 30 Tage verkauft werden - geben Sie den niedrigsten Preis seit dem Datum der Markteinführung an
4. Bei leicht verderblichen Produkten - kann der Zeitraum verkürzt werden

Das Plugin wendet diese Richtlinien standardmäßig an. Die Option price_count_from auf sale_start zählt ab dem Startdatum der Aktion, gemäß den Empfehlungen von UOKiK.

Fehlerbehebung

Der Omnibus-Preis wird nicht angezeigt Prüfen Sie, ob das Produkt in WooCommerce einen Angebotspreis eingestellt hat. Bei aktivierter Option display_on_sale_only erscheint die Meldung nur während einer aktiven Aktion.

Es wird eine Meldung über fehlende Historie angezeigt Die Preisverfolgung beginnt nach dem Aktivieren des Moduls. Warten Sie auf eine Preisänderung oder speichern Sie das Produkt erneut, um den ersten Historieneintrag hinzuzufügen.

Der Omnibus-Preis ist gleich dem Angebotspreis Dies ist korrektes Verhalten, wenn das Produkt in den letzten 30 Tagen keinen niedrigeren Preis hatte.

Nächste Schritte

• Probleme melden: GitHub Issues
• Diskussionen und Fragen: GitHub Discussions

Diese Seite dient ausschließlich zu Informationszwecken und stellt keine Rechtsberatung dar. Konsultieren Sie vor der Umsetzung einen Anwalt. Polski for WooCommerce ist Open-Source-Software (GPLv2), die ohne Gewährleistung bereitgestellt wird.