Директива Omnibus - відстеження цін
Директива Omnibus (EU 2019/2161) діє в Польщі з 1 січня 2023. При кожній знижці потрібно показати найнижчу ціну за останні 30 днів. Плагін автоматично відстежує історію цін та відображає цю інформацію при акціях.
Як працює відстеження цін
Section titled “Як працює відстеження цін”Плагін записує кожну зміну ціни продукту (включаючи варіанти) в базу даних. Коли продукт “у акції”, плагін обчислює найнижчу ціну за 30 днів та показує її клієнтам.
Відстеження починається після увімкнення модуля. Якщо продукт ще не має історії цін, відображається замінне повідомлення.

Налаштування
Section titled “Налаштування”Перейдіть до WooCommerce > Ustawienia > Polski > Omnibus та налаштуйте доступні опції.
Період відстеження
Section titled “Період відстеження”| Опція | Опис | Значення за замовчуванням |
|---|---|---|
days | Кількість днів назад для обчислення найнижчої ціни | 30 |
prune_after_days | Через скільки днів видаляти старі записи з історії | 90 |
prune_after_days контролює розмір таблиці в базі даних. Значення 90 означає, що дані старіші за 90 днів автоматично видаляються.
Податки
Section titled “Податки”| Опція | Опис | Значення за замовчуванням |
|---|---|---|
include_tax | Чи відображати ціну Omnibus з ПДВ | true |
Встановіть відповідно до налаштувань цін у WooCommerce. Якщо ціни в магазині брутто, залиште true.
Місця відображення
Section titled “Місця відображення”| Опція | Опис | Значення за замовчуванням |
|---|---|---|
display_on_sale_only | Відображати лише при продуктах у акції | true |
show_on_single | Сторінка окремого продукту | true |
show_on_loop | Список продуктів (категорія, магазин) | false |
show_on_related | Пов’язані продукти | false |
show_on_cart | Кошик | false |
Увімкніть щонайменше на сторінці продукту (show_on_single). На списку продуктів (show_on_loop) займає більше місця, але деякі інтерпретації закону цього вимагають.
Регулярна ціна
Section titled “Регулярна ціна”| Опція | Опис | Значення за замовчуванням |
|---|---|---|
show_regular_price | Відображати також регулярну ціну поряд з ціною Omnibus | false |
Шаблон тексту
Section titled “Шаблон тексту”| Опція | Опис | Значення за замовчуванням |
|---|---|---|
display_text | Шаблон відображуваного повідомлення | Najniższa cena z {days} dni przed obniżką: {price} |
no_history_text | Текст коли немає історії цін | Brak danych o wcześniejszej cenie |
Доступні змінні у шаблоні display_text:
{price}- найнижча ціна за даний період{days}- кількість днів (за замовчуванням 30){date}- дата найнижчої ціни{regular_price}- регулярна ціна продукту (до акції)
Приклади шаблонів
Section titled “Приклади шаблонів”Najniższa cena z {days} dni przed obniżką: {price}Najniższa cena z ostatnich {days} dni: {price} (cena regularna: {regular_price})Omnibus: {price} (z dnia {date})Спосіб обчислення ціни
Section titled “Спосіб обчислення ціни”| Опція | Опис | Значення за замовчуванням |
|---|---|---|
price_count_from | З якої дати рахувати 30 днів | sale_start |
Доступні значення:
sale_start- від дати початку акції (рекомендовано UOKiK)current_date- від поточної дати
Варіантні продукти
Section titled “Варіантні продукти”| Опція | Опис | Значення за замовчуванням |
|---|---|---|
variable_tracking | Спосіб відстеження варіантів | per_variation |
Доступні значення:
per_variation- окреме відстеження кожного варіанту (рекомендовано)parent_only- відстеження лише ціни батьківського продукту
per_variation дає точніші дані, бо кожен варіант може мати іншу ціну та історію знижок.
Шорткод
Section titled “Шорткод”Використовуйте шорткод [polski_omnibus_price] для відображення найнижчої ціни в будь-якому місці сайту.
Базове використання
Section titled “Базове використання”[polski_omnibus_price]Відображає ціну Omnibus для поточного продукту.
З параметрами
Section titled “З параметрами”[polski_omnibus_price product_id="456" days="30"]Параметри шорткоду
Section titled “Параметри шорткоду”| Параметр | Опис | Значення за замовчуванням |
|---|---|---|
product_id | ID продукту | Поточний продукт |
days | Кількість днів | Значення з налаштувань |
Приклад використання у PHP-шаблоні
Section titled “Приклад використання у PHP-шаблоні”echo do_shortcode('[polski_omnibus_price product_id="' . $product_id . '"]');Автоматичне очищення історії
Section titled “Автоматичне очищення історії”WP-Cron щодня видаляє записи історії цін, старіші за prune_after_days. Таблиця в базі даних не росте без обмежень.
Щоб вручну запустити очищення, використайте WP-CLI:
wp cron event run polski_omnibus_pruneВідповідність вимогам UOKiK
Section titled “Відповідність вимогам UOKiK”Вказівки UOKiK:
- Інформація про найнижчу ціну повинна відображатися при кожному оголошенні про знижку
- Референсний період - 30 днів перед застосуванням знижки
- Для продуктів, що продаються менше 30 днів - вказуйте найнижчу ціну з дня введення у продаж
- Для продуктів, що швидко псуються - можливе скорочення періоду
Плагін за замовчуванням дотримується цих вказівок. Опція price_count_from на sale_start рахує від дати початку акції, згідно з рекомендаціями UOKiK.
Вирішення проблем
Section titled “Вирішення проблем”Ціна Omnibus не відображається
Перевірте, чи продукт має акційну ціну у WooCommerce. При увімкненій опції display_on_sale_only повідомлення з’явиться лише при активній акції.
Відображається повідомлення про відсутність історії Відстеження цін починається після увімкнення модуля. Зачекайте на зміну ціни або збережіть продукт повторно, щоб додати перший запис в історії.
Ціна Omnibus така ж, як акційна ціна Це правильна поведінка, якщо продукт не мав нижчої ціни протягом останніх 30 днів.
Подальші кроки
Section titled “Подальші кроки”- Повідомлення про проблеми: GitHub Issues
- Обговорення та запитання: GitHub Discussions