Kargadann’s PLN Price Converter for WooCommerce

Description

Polish stores often sell abroad but keep prices and payments in Polish złoty (PLN). This plugin shows foreign customers how much a product, cart or order costs in their own currency, using the official average exchange rate published by the National Bank of Poland (NBP, tables A and B). Prices, totals and payments in your store stay in PLN — the foreign amounts are for information only.

Features

• Daily automatic rate updates from the NBP Web API — table A on business days (around 12:30 Warsaw time) and table B on Wednesdays, with automatic retries until 16:30.
• Exact amounts in the customer’s currency (2 decimal places) on product pages, product lists, cart, checkout (classic and block-based), order emails, the thank-you page and My account.
• Totals calculated from line items, including coupons, shipping, fees and VAT broken down by tax rate.
• Manual prices per currency (regular and sale) for simple products, variations and subscriptions — they take precedence over the converted price.
• Automatic currency based on the customer’s country (Cloudflare CF-IPCountry header, WooCommerce geolocation or browser language), with a currency switcher (block, shortcode [nbpx_currency_switcher] and widget).
• “PLN only” countries (Poland by default): customers from these countries see PLN only. Store administrators can always switch currencies and simulate a customer’s country for testing.
• Cache-friendly: foreign prices are loaded separately and never cached, so page caching (WP Rocket, LiteSpeed, Cloudflare, WP-Optimize…) does not mix up customers’ currencies.
• Order snapshot: the currency, rate and NBP table number are saved with every order and shown in emails and in the order screen.
• Rate anomaly protection: a large rate change between tables is held for your approval.
• An “i” icon next to the foreign price explains the rate, the NBP table and that payment is made in PLN.
• Compatible with HPOS, the block-based cart and checkout, WooCommerce Subscriptions and email template builders such as YayMail.

Requirements

• WooCommerce 9.0 or later with the store currency set to PLN. With any other store currency the plugin disables foreign prices and shows a notice.
• PHP 8.1 or later.

Source code

All PHP, JavaScript and CSS code is included in the plugin in its original, readable and unminified form — there is no build step. The only generated files are translations: languages/*.mo and languages/*.json are compiled from the included languages/*.po files with WP-CLI (wp i18n make-mo and wp i18n make-json).

Disclaimer

This plugin is not affiliated with, endorsed by or sponsored by Narodowy Bank Polski (National Bank of Poland) or WooCommerce. Exchange rates are taken from the public NBP Web API. Foreign currency amounts are for information only; the store owner is responsible for prices, invoicing and compliance with applicable law.

External services

This plugin connects to the NBP Web API (Narodowy Bank Polski — National Bank of Poland) to download the official average exchange rates of foreign currencies. This is required for the plugin to work.

• What is requested: the latest exchange rate tables A and B, from https://api.nbp.pl/api/exchangerates/tables/A/ and https://api.nbp.pl/api/exchangerates/tables/B/.
• When: right after activation, once a day on business days around 12:30 (Warsaw time) with retries until 16:30, and when an administrator clicks Fetch rates now.
• What is sent: a standard HTTPS GET request from your server with the user agent NbpExchangeRate/<version>. No personal data, no customer data and no store address are sent. As with any web request, NBP receives your server’s IP address.
• Service documentation and terms: https://api.nbp.pl/en.html (NBP’s privacy policy is linked from that page).

No other external services are contacted. Country detection uses the CF-IPCountry header that Cloudflare adds to requests (if you enable it), WooCommerce’s local geolocation database, or the browser language — the plugin itself does not send visitor data anywhere.