Title: Kargadann’s PLN Price Converter for WooCommerce
Author: kargadann
Published: October 13, 2026
Last modified: October 13, 2026
---
Search plugins
# Kargadann’s PLN Price Converter for WooCommerce
By [kargadann](https://profiles.wordpress.org/kargadann/)
[Download](https://downloads.wordpress.org/plugin/kargadanns-pln-price-converter.1.0.0.zip)
* [Details](https://wordpress.org/plugins/kargadanns-pln-price-converter/#description)
* [Reviews](https://wordpress.org/plugins/kargadanns-pln-price-converter/#reviews)
* [Installation](https://wordpress.org/plugins/kargadanns-pln-price-converter/#installation)
* [Development](https://wordpress.org/plugins/kargadanns-pln-price-converter/#developers)
[Support](https://wordpress.org/support/plugin/kargadanns-pln-price-converter/)
## 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/`. 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.
## Screenshots
[⌊Product page: price in PLN with the amount in EUR and the "i" icon explaining
the NBP rate and that payment is made in PLN.⌉⌊Product page: price in PLN with the
amount in EUR and the "i" icon explaining the NBP rate and that payment is made
in PLN.⌉[
Product page: price in PLN with the amount in EUR and the “i” icon explaining the
NBP rate and that payment is made in PLN.
[⌊Block-based cart with amounts in EUR for each item, the coupon, shipping and the
VAT breakdown.⌉⌊Block-based cart with amounts in EUR for each item, the coupon,
shipping and the VAT breakdown.⌉[
Block-based cart with amounts in EUR for each item, the coupon, shipping and the
VAT breakdown.
[⌊Order email with amounts in EUR and the currency conversion line with the NBP
table number.⌉⌊Order email with amounts in EUR and the currency conversion line
with the NBP table number.⌉[
Order email with amounts in EUR and the currency conversion line with the NBP table
number.
[⌊Settings: enabled currencies, fallback currency and "PLN only" countries.⌉⌊Settings:
enabled currencies, fallback currency and "PLN only" countries.⌉[
Settings: enabled currencies, fallback currency and “PLN only” countries.
[⌊NBP rates: tables A and B, last and next fetch, and the rates of enabled currencies.⌉⌊
NBP rates: tables A and B, last and next fetch, and the rates of enabled currencies
.⌉[
NBP rates: tables A and B, last and next fetch, and the rates of enabled currencies.
## Blocks
This plugin provides 1 block.
* NBP currency switcher
## Installation
1. Install and activate the plugin from _Plugins Add New_, or upload the ZIP file.
2. Make sure the store currency is set to PLN in _WooCommerce Settings General_.
3. Go to _WooCommerce Settings NBP rates_ and choose the currencies and where foreign
amounts should be shown.
4. In the _NBP rates_ section click _Fetch rates now_ (the first fetch also runs automatically
after activation).
5. Optional: if your store runs behind Cloudflare, enable _Cloudflare_ in _Currency
detection_ and make sure _Network IP Geolocation_ is on in your Cloudflare zone.
6. Optional: add the currency switcher — the _NBP currency switcher_ block, the `[
nbpx_currency_switcher]` shortcode or the widget.
## FAQ
### Will customers pay in their own currency?
No. Prices, cart totals and payments stay in PLN. The plugin only shows the equivalent
amount in the customer’s currency, for information.
### Which currencies are supported?
All currencies published by the NBP in tables A and B (around 150). You choose which
ones are enabled.
### Which exchange rate is used?
The NBP average exchange rate (kurs średni) from the latest published table. The
table number and date are shown next to the price and saved with each order.
### Does it work with page caching and Cloudflare?
Yes. The page HTML is the same for everyone; foreign prices are loaded separately
with caching disabled.
### Can I set my own price in a foreign currency?
Yes. Each product (and each variation) has _Currency prices_ fields. A manual price
takes precedence over the converted price.
### Does it work with other multi-currency plugins?
It is not designed to work together with plugins that change the store currency (
e.g. WPML WooCommerce Multilingual currencies, CURCY, Aelia). When the active currency
is not PLN, the plugin does not show conversions.
### Where can I get help?
Use the support forum on WordPress.org.
## Reviews
There are no reviews for this plugin.
## Contributors & Developers
“Kargadann’s PLN Price Converter for WooCommerce” is open source software. The following
people have contributed to this plugin.
Contributors
* [ kargadann ](https://profiles.wordpress.org/kargadann/)
“Kargadann’s PLN Price Converter for WooCommerce” has been translated into 1 locale.
Thank you to [the translators](https://translate.wordpress.org/projects/wp-plugins/kargadanns-pln-price-converter/contributors)
for their contributions.
[Translate “Kargadann’s PLN Price Converter for WooCommerce” into your language.](https://translate.wordpress.org/projects/wp-plugins/kargadanns-pln-price-converter)
### Interested in development?
[Browse the code](https://plugins.trac.wordpress.org/browser/kargadanns-pln-price-converter/),
check out the [SVN repository](https://plugins.svn.wordpress.org/kargadanns-pln-price-converter/),
or subscribe to the [development log](https://plugins.trac.wordpress.org/log/kargadanns-pln-price-converter/)
by [RSS](https://plugins.trac.wordpress.org/log/kargadanns-pln-price-converter/?limit=100&mode=stop_on_copy&format=rss).
## Changelog
#### 1.0.0
* First release.
## Meta
* Version **1.0.0**
* Last updated **17 hours ago**
* Active installations **Fewer than 10**
* WordPress version ** 6.5 or higher **
* Tested up to **7.1.3**
* PHP version ** 8.1 or higher **
* Languages
* [English (US)](https://wordpress.org/plugins/kargadanns-pln-price-converter/)
and [Polish](https://pl.wordpress.org/plugins/kargadanns-pln-price-converter/).
* [Translate into your language](https://translate.wordpress.org/projects/wp-plugins/kargadanns-pln-price-converter)
* Tags
* [currency converter](https://wordpress.org/plugins/tags/currency-converter/)[currency switcher](https://wordpress.org/plugins/tags/currency-switcher/)
[exchange rates](https://wordpress.org/plugins/tags/exchange-rates/)[pln](https://wordpress.org/plugins/tags/pln/)
[Poland](https://wordpress.org/plugins/tags/poland/)
* [Advanced View](https://wordpress.org/plugins/kargadanns-pln-price-converter/advanced/)
## Ratings
No reviews have been submitted yet.
[Your review](https://wordpress.org/support/plugin/kargadanns-pln-price-converter/reviews/#new-post)
[See all reviews](https://wordpress.org/support/plugin/kargadanns-pln-price-converter/reviews/)
## Contributors
* [ kargadann ](https://profiles.wordpress.org/kargadann/)
## Support
Got something to say? Need help?
[View support forum](https://wordpress.org/support/plugin/kargadanns-pln-price-converter/)