{"id":385373,"date":"2026-10-13T14:50:22","date_gmt":"2026-10-13T14:50:22","guid":{"rendered":"https:\/\/wordpress.org\/plugins\/przelicznik-walut-nbp-for-woocommerce\/"},"modified":"2026-10-13T14:49:58","modified_gmt":"2026-10-13T14:49:58","slug":"kargadanns-pln-price-converter","status":"publish","type":"plugin","link":"https:\/\/wordpress.org\/plugins\/kargadanns-pln-price-converter\/","author":23584583,"comment_status":"closed","ping_status":"closed","template":"","meta":{"version":"1.0.0","stable_tag":"1.0.0","tested":"7.1.3","requires":"6.5","requires_php":"8.1","requires_plugins":null,"header_name":"Kargadann's PLN Price Converter for WooCommerce","header_author":"Kargadann","header_description":"Shows informational prices in the customer's currency at the current National Bank of Poland (NBP) average exchange rate (tables A and B) \u2014 on product pages, in the cart, checkout and order emails. Payment stays in PLN.","assets_banners_color":"9a978a","last_updated":"2026-10-13 14:49:58","external_support_url":"","external_repository_url":"","donate_link":"","header_plugin_uri":"https:\/\/wordpress.org\/plugins\/kargadanns-pln-price-converter\/","header_author_uri":"https:\/\/github.com\/Kargadann","rating":0,"author_block_rating":0,"active_installs":0,"downloads":58,"num_ratings":0,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":{"1.0.0":{"tag":"1.0.0","author":"kargadann","date":"2026-10-13 14:49:58","revision":3744243}},"upgrade_notice":[],"ratings":[],"assets_icons":{"icon-128x128.png":{"filename":"icon-128x128.png","revision":3744243,"resolution":"128x128","location":"assets","locale":"","width":128,"height":128},"icon-256x256.png":{"filename":"icon-256x256.png","revision":3744243,"resolution":"256x256","location":"assets","locale":"","width":256,"height":256}},"assets_banners":{"banner-1544x500.png":{"filename":"banner-1544x500.png","revision":3744243,"resolution":"1544x500","location":"assets","locale":"","width":1544,"height":500},"banner-772x250.png":{"filename":"banner-772x250.png","revision":3744243,"resolution":"772x250","location":"assets","locale":"","width":772,"height":250}},"assets_blueprints":{},"all_blocks":{"nbpx\/currency-switcher":{"name":"nbpx\/currency-switcher","title":"NBP currency switcher"}},"tagged_versions":["1.0.0"],"block_files":[],"assets_screenshots":{"screenshot-1.png":{"filename":"screenshot-1.png","revision":3744243,"resolution":"1","location":"assets","locale":"","width":1280,"height":860},"screenshot-2.png":{"filename":"screenshot-2.png","revision":3744243,"resolution":"2","location":"assets","locale":"","width":1280,"height":860},"screenshot-3.png":{"filename":"screenshot-3.png","revision":3744243,"resolution":"3","location":"assets","locale":"","width":600,"height":907},"screenshot-4.png":{"filename":"screenshot-4.png","revision":3744243,"resolution":"4","location":"assets","locale":"","width":1280,"height":900},"screenshot-5.png":{"filename":"screenshot-5.png","revision":3744243,"resolution":"5","location":"assets","locale":"","width":1280,"height":900}},"screenshots":{"1":"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.","2":"Block-based cart with amounts in EUR for each item, the coupon, shipping and the VAT breakdown.","3":"Order email with amounts in EUR and the currency conversion line with the NBP table number.","4":"Settings: enabled currencies, fallback currency and \"PLN only\" countries.","5":"NBP rates: tables A and B, last and next fetch, and the rates of enabled currencies."}},"plugin_section":[],"plugin_tags":[12584,21294,21292,258746,194202],"plugin_category":[],"plugin_contributors":[286476],"plugin_business_model":[],"class_list":["post-385373","plugin","type-plugin","status-publish","hentry","plugin_tags-currency-converter","plugin_tags-currency-switcher","plugin_tags-exchange-rates","plugin_tags-pln","plugin_tags-poland","plugin_contributors-kargadann","plugin_committers-kargadann"],"banners":{"banner":"https:\/\/ps.w.org\/kargadanns-pln-price-converter\/assets\/banner-772x250.png?rev=3744243","banner_2x":"https:\/\/ps.w.org\/kargadanns-pln-price-converter\/assets\/banner-1544x500.png?rev=3744243","banner_rtl":false,"banner_2x_rtl":false},"icons":{"svg":false,"icon":"https:\/\/ps.w.org\/kargadanns-pln-price-converter\/assets\/icon-128x128.png?rev=3744243","icon_2x":"https:\/\/ps.w.org\/kargadanns-pln-price-converter\/assets\/icon-256x256.png?rev=3744243","generated":false},"screenshots":[{"src":"https:\/\/ps.w.org\/kargadanns-pln-price-converter\/assets\/screenshot-1.png?rev=3744243","caption":"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."},{"src":"https:\/\/ps.w.org\/kargadanns-pln-price-converter\/assets\/screenshot-2.png?rev=3744243","caption":"Block-based cart with amounts in EUR for each item, the coupon, shipping and the VAT breakdown."},{"src":"https:\/\/ps.w.org\/kargadanns-pln-price-converter\/assets\/screenshot-3.png?rev=3744243","caption":"Order email with amounts in EUR and the currency conversion line with the NBP table number."},{"src":"https:\/\/ps.w.org\/kargadanns-pln-price-converter\/assets\/screenshot-4.png?rev=3744243","caption":"Settings: enabled currencies, fallback currency and \"PLN only\" countries."},{"src":"https:\/\/ps.w.org\/kargadanns-pln-price-converter\/assets\/screenshot-5.png?rev=3744243","caption":"NBP rates: tables A and B, last and next fetch, and the rates of enabled currencies."}],"raw_content":"<!--section=description-->\n<p>Polish stores often sell abroad but keep prices and payments in Polish z\u0142oty (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). <strong>Prices, totals and payments in your store stay in PLN<\/strong> \u2014 the foreign amounts are for information only.<\/p>\n\n<h4>Features<\/h4>\n\n<ul>\n<li><strong>Daily automatic rate updates<\/strong> from the NBP Web API \u2014 table A on business days (around 12:30 Warsaw time) and table B on Wednesdays, with automatic retries until 16:30.<\/li>\n<li><strong>Exact amounts<\/strong> 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 <em>My account<\/em>.<\/li>\n<li><strong>Totals calculated from line items<\/strong>, including coupons, shipping, fees and VAT broken down by tax rate.<\/li>\n<li><strong>Manual prices<\/strong> per currency (regular and sale) for simple products, variations and subscriptions \u2014 they take precedence over the converted price.<\/li>\n<li><strong>Automatic currency<\/strong> based on the customer's country (Cloudflare <code>CF-IPCountry<\/code> header, WooCommerce geolocation or browser language), with a currency switcher (block, shortcode <code>[nbpx_currency_switcher]<\/code> and widget).<\/li>\n<li><strong>\"PLN only\" countries<\/strong> (Poland by default): customers from these countries see PLN only. Store administrators can always switch currencies and simulate a customer's country for testing.<\/li>\n<li><strong>Cache-friendly<\/strong>: foreign prices are loaded separately and never cached, so page caching (WP Rocket, LiteSpeed, Cloudflare, WP-Optimize\u2026) does not mix up customers' currencies.<\/li>\n<li><strong>Order snapshot<\/strong>: the currency, rate and NBP table number are saved with every order and shown in emails and in the order screen.<\/li>\n<li><strong>Rate anomaly protection<\/strong>: a large rate change between tables is held for your approval.<\/li>\n<li>An <strong>\"i\" icon<\/strong> next to the foreign price explains the rate, the NBP table and that payment is made in PLN.<\/li>\n<li>Compatible with <strong>HPOS<\/strong>, the <strong>block-based cart and checkout<\/strong>, WooCommerce Subscriptions and email template builders such as YayMail.<\/li>\n<\/ul>\n\n<h4>Requirements<\/h4>\n\n<ul>\n<li>WooCommerce 9.0 or later with the store currency set to <strong>PLN<\/strong>. With any other store currency the plugin disables foreign prices and shows a notice.<\/li>\n<li>PHP 8.1 or later.<\/li>\n<\/ul>\n\n<h4>Source code<\/h4>\n\n<p>All PHP, JavaScript and CSS code is included in the plugin in its original, readable and unminified form \u2014 there is no build step. The only generated files are translations: <code>languages\/*.mo<\/code> and <code>languages\/*.json<\/code> are compiled from the included <code>languages\/*.po<\/code> files with WP-CLI (<code>wp i18n make-mo<\/code> and <code>wp i18n make-json<\/code>).<\/p>\n\n<h4>Disclaimer<\/h4>\n\n<p>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.<\/p>\n\n<h3>External services<\/h3>\n\n<p>This plugin connects to the <strong>NBP Web API<\/strong> (Narodowy Bank Polski \u2014 National Bank of Poland) to download the official average exchange rates of foreign currencies. This is required for the plugin to work.<\/p>\n\n<ul>\n<li><strong>What is requested:<\/strong> the latest exchange rate tables A and B, from <code>https:\/\/api.nbp.pl\/api\/exchangerates\/tables\/A\/<\/code> and <code>https:\/\/api.nbp.pl\/api\/exchangerates\/tables\/B\/<\/code>.<\/li>\n<li><strong>When:<\/strong> right after activation, once a day on business days around 12:30 (Warsaw time) with retries until 16:30, and when an administrator clicks <em>Fetch rates now<\/em>.<\/li>\n<li><strong>What is sent:<\/strong> a standard HTTPS GET request from your server with the user agent <code>NbpExchangeRate\/&lt;version&gt;<\/code>. No personal data, no customer data and no store address are sent. As with any web request, NBP receives your server's IP address.<\/li>\n<li><strong>Service documentation and terms:<\/strong> https:\/\/api.nbp.pl\/en.html (NBP's privacy policy is linked from that page).<\/li>\n<\/ul>\n\n<p>No other external services are contacted. Country detection uses the <code>CF-IPCountry<\/code> header that Cloudflare adds to requests (if you enable it), WooCommerce's local geolocation database, or the browser language \u2014 the plugin itself does not send visitor data anywhere.<\/p>\n\n<!--section=installation-->\n<ol>\n<li>Install and activate the plugin from <em>Plugins \u2192 Add New<\/em>, or upload the ZIP file.<\/li>\n<li>Make sure the store currency is set to PLN in <em>WooCommerce \u2192 Settings \u2192 General<\/em>.<\/li>\n<li>Go to <em>WooCommerce \u2192 Settings \u2192 NBP rates<\/em> and choose the currencies and where foreign amounts should be shown.<\/li>\n<li>In the <em>NBP rates<\/em> section click <em>Fetch rates now<\/em> (the first fetch also runs automatically after activation).<\/li>\n<li>Optional: if your store runs behind Cloudflare, enable <em>Cloudflare<\/em> in <em>Currency detection<\/em> and make sure <em>Network \u2192 IP Geolocation<\/em> is on in your Cloudflare zone.<\/li>\n<li>Optional: add the currency switcher \u2014 the <em>NBP currency switcher<\/em> block, the <code>[nbpx_currency_switcher]<\/code> shortcode or the widget.<\/li>\n<\/ol>\n\n<!--section=faq-->\n<dl>\n<dt id=\"will%20customers%20pay%20in%20their%20own%20currency%3F\"><h3>Will customers pay in their own currency?<\/h3><\/dt>\n<dd><p>No. Prices, cart totals and payments stay in PLN. The plugin only shows the equivalent amount in the customer's currency, for information.<\/p><\/dd>\n<dt id=\"which%20currencies%20are%20supported%3F\"><h3>Which currencies are supported?<\/h3><\/dt>\n<dd><p>All currencies published by the NBP in tables A and B (around 150). You choose which ones are enabled.<\/p><\/dd>\n<dt id=\"which%20exchange%20rate%20is%20used%3F\"><h3>Which exchange rate is used?<\/h3><\/dt>\n<dd><p>The NBP average exchange rate (kurs \u015bredni) from the latest published table. The table number and date are shown next to the price and saved with each order.<\/p><\/dd>\n<dt id=\"does%20it%20work%20with%20page%20caching%20and%20cloudflare%3F\"><h3>Does it work with page caching and Cloudflare?<\/h3><\/dt>\n<dd><p>Yes. The page HTML is the same for everyone; foreign prices are loaded separately with caching disabled.<\/p><\/dd>\n<dt id=\"can%20i%20set%20my%20own%20price%20in%20a%20foreign%20currency%3F\"><h3>Can I set my own price in a foreign currency?<\/h3><\/dt>\n<dd><p>Yes. Each product (and each variation) has <em>Currency prices<\/em> fields. A manual price takes precedence over the converted price.<\/p><\/dd>\n<dt id=\"does%20it%20work%20with%20other%20multi-currency%20plugins%3F\"><h3>Does it work with other multi-currency plugins?<\/h3><\/dt>\n<dd><p>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.<\/p><\/dd>\n<dt id=\"where%20can%20i%20get%20help%3F\"><h3>Where can I get help?<\/h3><\/dt>\n<dd><p>Use the support forum on WordPress.org.<\/p><\/dd>\n\n<\/dl>\n\n<!--section=changelog-->\n<h4>1.0.0<\/h4>\n\n<ul>\n<li>First release.<\/li>\n<\/ul>","raw_excerpt":"Shows informational prices in your customer's currency at the official National Bank of Poland (NBP) rate. Payment stays in PLN.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/385373","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=385373"}],"author":[{"embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/kargadann"}],"wp:attachment":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=385373"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=385373"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=385373"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=385373"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=385373"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=385373"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}