=== Multi Currency for WooCommerce ===
Contributors: catcodestudio
Tags: woocommerce, multi-currency, currency converter, exchange rate, nbu
Requires at least: 5.6
Tested up to: 7.1
Requires PHP: 7.4
Stable tag: 1.1.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Store prices shown in the customer's currency at the National Bank of Ukraine rate. Order and payment always share one currency.

== Description ==

Product prices stay stored in your store's base currency; the customer sees them converted into their own. Rates are pulled from the National Bank of Ukraine (NBU) twice a day.

The key guarantee: the order's currency is locked in at checkout, and the payment gateway takes both the amount and the currency from that same order. "Amount in one currency, signature in another" cannot happen — a common failure mode in currency-switcher plugins that convert on display only.

* Automatic NBU exchange rates, refreshed twice daily
* Currency switcher shortcode `[catcode_currency_switcher]` (dropdown or list)
* WooCommerce reports and analytics are converted back to the base currency, so totals stay comparable across currencies
* Cache-friendly: the chosen currency is added to the cache vary-cookies (works with LiteSpeed Cache and WP Super Cache out of the box)

= Free vs Pro =

**Free** gives you one additional currency next to your store's base currency, always priced from the live NBU rate.

**Pro** unlocks:

* Unlimited additional currencies
* A markup percentage on top of the NBU rate, per currency
* A manual (fixed) exchange rate instead of the automatic NBU feed
* Automatic currency selection by visitor's country

Settings saved while on the free tier are never discarded — extra currencies, a markup, or a manual rate you configured during a trial or a past subscription stay stored and start working again the moment Pro is active.

== Installation ==

1. Upload the plugin to `/wp-content/plugins/` and activate it.
2. Go to WooCommerce → Settings → Multi Currency, add the currencies you need and click "Update rates now".
3. Place the `[catcode_currency_switcher]` shortcode where you want the switcher (menu, header widget, footer).

== Frequently Asked Questions ==

= Can a customer end up paying in the wrong currency? =

No. The currency is fixed on the order at the moment of checkout, and the payment gateway reads the amount and the currency straight from that order — there is no separate conversion step where the two could drift apart.

= Where do the exchange rates come from? =

The National Bank of Ukraine's public exchange rate service, refreshed automatically twice a day. A manual/fixed rate per currency is available on Pro.

= Does this affect my WooCommerce sales reports? =

No — orders placed in a foreign currency are converted back to your base currency for Analytics and reports, using the rate that was locked in on that order.

== External services ==

This plugin connects to the National Bank of Ukraine's public exchange rate service so the store can show live, accurate currency conversion.

**NBU (National Bank of Ukraine) Exchange Rate Service** (https://bank.gov.ua)

* When: automatically twice a day (background cron), and whenever a store manager clicks "Update rates now" in the settings screen.
* What is sent: nothing beyond a standard HTTP request to a public, unauthenticated endpoint — no store or customer data is transmitted.
* What is received: the daily currency exchange rates published by the National Bank of Ukraine.
* Terms of service: https://bank.gov.ua/ua/faq/questions-answers-nbustatservice

The National Bank of Ukraine is a third party. This plugin is an independent integration built by CatCode; it is not affiliated with, endorsed by or sponsored by the National Bank of Ukraine.

== Changelog ==

= 1.1.0 =
* Free / Pro split: free tier keeps the base currency plus 1 additional currency at the live NBU rate; Pro adds unlimited currencies, a per-currency markup, a manual rate override and currency-by-country detection.
* License activation, 7-day trial and daily license re-check added to the settings screen.

= 1.0.0 =
* First release.
