Opis
WPNest Price History for WooCommerce gives WooCommerce stores automatic compliance with the EU Omnibus directive (Directive 2019/2161, in force across the EU since May 2022, in Poland from January 2023).
The plugin records every price change in your store with a timestamp and renders the legally required notice — „Najniższa cena z 30 dni przed obniżką: X” — under the price on every product page where a discount is announced.
Key features (Free)
- Automatic price capture — every change made via admin, REST API, WP-CLI, CSV import, or programmatic save is recorded with timestamp.
- Daily snapshot failsafe — a cron job ensures every published product has at least one history row per 24h, even when capture hooks miss.
- 30-day-low calculation — uses the legally correct „Omnibus” method (lookback from the moment the current sale started). A „Rolling” alternative is available for stores that prefer it.
- Configurable label — the notice text is fully customizable per language.
- Display options — single product page (required), shop loop, cart line items.
- Variable products — per-variation tracking with frontend handler that updates the notice when a variation is selected.
- Custom CSS — paste your own styles for the notice without editing files.
- Per-product mini-chart in the admin product edit screen.
- WP-CLI support —
snapshot,cleanup,backfill. - Backfill on activation — seeds the history table with current prices so the 30-day window is never empty.
- Cleanup cron — automatically removes entries older than the retention window (default 90 days).
- Cache — transient-based (12h TTL) with automatic invalidation on every price change.
- Compatible with HPOS (WooCommerce custom order tables).
Compliance basis
This plugin implements requirements from:
- EU Directive 2019/2161 („Omnibus”) — applicable across all EU member states.
- Polish Ustawa o informowaniu o cenach towarów i usług, art. 4 ust. 2 — domestic transposition, in force since 1 January 2023.
UOKiK (the Polish Office of Competition and Consumer Protection) actively monitors compliance and may impose fines of up to 10% of annual revenue. The most commonly flagged violation is „price gymnastics” — artificially inflating the regular price shortly before a sale to make the discount appear larger.
Pro version
A Pro extension is available with additional features for shops that want to go beyond the legal minimum: public price history chart on product pages, Omnibus violation detector, compliance dashboard, webhooks (Slack/Discord), CSV export for audit, tamper-proof hash chain, white-label, and more. See https://wpnest.pl/sklep/prawo-i-formalnosci/wpnest-price-history-pro/ for details.
Third-Party Libraries
This plugin bundles the following libraries:
- Chart.js v4.5.1 — MIT License, https://www.chartjs.org/ — used to render the per-product price history chart in the admin product edit screen.
- chartjs-adapter-date-fns v3.0.0 (bundle including date-fns) — MIT License, https://github.com/chartjs/chartjs-adapter-date-fns — date adapter required by Chart.js v3+ for time-scale axes on the price history chart.
Zrzuty ekranu
Instalacja
- Upload the plugin folder to
/wp-content/plugins/or install via the Plugins screen. - Activate the plugin through the „Plugins” screen in WordPress.
- Go to WooCommerce Price History to configure settings.
- The plugin starts capturing prices immediately. The backfill process seeds existing products in the background — typically completes within minutes for shops up to 10k products.
Najczęściej zadawane pytania
-
Does this plugin work with variable products?
-
Yes. Each variation has its own price history. The notice on the single product page updates automatically when a customer selects a different variation.
-
Does it work with theme overrides of single-product.php?
-
Yes. The plugin uses the
woocommerce_get_price_htmlfilter as its primary integration point, which fires whenever any code calls$product->get_price_html(). This works in both standard themes and custom themes that bypasswoocommerce_single_product_summary. -
What if my theme renders prices via wc_price() directly (not get_price_html())?
-
In that rare case, you can call
do_action('woocommerce_single_product_summary')from your theme template, or use the includedomnibus-notice.phptemplate override mechanism. -
Will my historical data be deleted when I uninstall the plugin?
-
No, by default. The history table is treated as regulatory-grade data. To explicitly delete it on uninstall, enable „Delete data on uninstall” in the plugin settings.
-
How does the daily cleanup cron decide what to delete?
-
Entries older than the configured retention window (default 90 days) are deleted by
wpnest_ph_cleanupcron. The retention window is configurable down to a minimum of 30 days. -
I see „Najniższa cena: X” but X equals the current sale price — is that wrong?
-
This usually means you’ve recently activated the plugin and there’s no historical data yet from before the current sale. The plugin falls back to the rolling window when no pre-sale snapshot exists. Once you accumulate ~31 days of history, the Omnibus method kicks in.
Recenzje
Wtyczka nie ma jeszcze żadnej recenzji.
Kontrybutorzy i deweloperzy
„WPNest Price History for WooCommerce” jest oprogramowaniem open source. Poniższe osoby miały wkład w rozwój wtyczki.
Zaangażowani
Przetłumacz wtyczkę “WPNest Price History for WooCommerce” na swój język.
Interesuje cię rozwój wtyczki?
Przeglądaj kod, sprawdź repozytorium SVN lub czytaj dziennik rozwoju przez RSS.
Rejestr zmian
1.0.3
- Fixed: the per-product admin price history chart did not render after the Chart.js 4.x upgrade because Chart.js v3+ no longer bundles a date adapter. Added the
chartjs-adapter-date-fnsUMD bundle (MIT, includes date-fns inline) as a dependency of the chart script. - Fixed: chart points were not drawn even when axes rendered, because
parsing: falsewas paired with raw MySQL DATETIME strings as thexvalue. Pre-convert each row’scaptured_at(UTC) to a millisecond timestamp before pushing into the dataset. - Disclosed the bundled
chartjs-adapter-date-fnsin the „Third-Party Libraries” section.
1.0.2
- Hardened custom CSS sanitization:
sanitize_textarea_field()plus blacklist of CSS-level attack vectors (expression, javascript:, vbscript:, @import, behavior, -moz-binding). - Refactored transient cache key construction to make the
wpnest_ph_low_prefix unambiguous to static analyzers. - Fixed: per-product cache invalidation now correctly clears transients for both calculation methods (previous version only cleared entries that no longer existed under that key).
- Hardened plugin action link:
esc_url()andesc_html__()on the Settings link, matching the Pro link pattern. - Documented why the Omnibus notice output is echoed without an outer
wp_kses_post()wrap (would strip thedata-variation-lowsJSON attribute needed by the variation handler) — all values are still escaped internally. - Synced Chart.js enqueue version string with the bundled file (4.5.1).
- Disclosed bundled Chart.js library in readme.txt.
1.0.1
- Renamed plugin slug to
wpnest-price-history-for-woocommerceand display name to „WPNest Price History for WooCommerce” per WordPress.org review feedback. - Added
Requires Plugins: woocommerceheader for WordPress 6.5+ dependency declaration. - Hardened custom CSS output:
wp_strip_all_tags()now applied at output in addition to sanitize-on-save. - Updated bundled Chart.js to 4.5.1.
1.0.0
- Initial release.
- Automatic price capture via
woocommerce_update_productandwoocommerce_update_product_variationhooks. - Daily snapshot failsafe cron.
- Omnibus and Rolling calculation methods.
- Configurable retention window with cleanup cron.
- Variable product support with per-variation tracking.
- Customizable notice label and position.
- Custom CSS field.
- Per-product mini-chart in admin.
- WP-CLI commands.
- HPOS compatible.