=== Codeuna Currency Switcher ===
Contributors: codeuna, dinohalavac
Tags: woocommerce, currency switcher, multicurrency, exchange rates, flags
Requires at least: 6.3
Tested up to: 7.1
Requires PHP: 7.4
Requires Plugins: woocommerce
Stable tag: 2.0.9
WC tested up to: 9.9
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Multi-currency switcher for WooCommerce with exchange rates, geolocation, custom pricing, checkout rules, and flexible display controls.

== Description ==

Codeuna Currency Switcher helps WooCommerce stores manage currency conversion and presentation. Configure exchange rates, currency formatting, country assignments, fixed product prices, checkout behavior, payment methods, and switcher display options.

Automatic exchange rates are available through ExchangeRate-API Open Access. Additional providers, including FawazCurrency CDN and Yahoo Finance, can be selected in the plugin settings.

The plugin is developed and maintained by Codeuna.

Author and developer information:
https://codeuna.com/

= Main Features =

* Currency conversion and automatic exchange rates
* Manual exchange rates
* Automatic WP-Cron rate updates
* Per-currency fees
* Custom currency symbols and formatting
* Currency flags
* Country and geolocation assignment
* Currency-specific payment gateways
* Checkout currency rules
* Fixed product and variation prices
* Approximate secondary prices
* Currency and country notices
* Header and single-product currency switchers
* WordPress widget and shortcode support
* Currency converter
* Header Only mode
* Small, medium and large switcher sizes

= Automatic Exchange Rates =

Exchange rates can be refreshed automatically through WordPress WP-Cron. Store administrators can also configure or override rates manually.

= External services =

This plugin can connect to public exchange-rate services to provide automatic rate updates.

- ExchangeRate-API Open Access receives the store base currency and requested currency codes when rates are refreshed. Terms: https://www.exchangerate-api.com/terms and Privacy: https://www.exchangerate-api.com/privacy.
- FawazCurrency (optional, selectable in settings) receives the store base currency when rates are refreshed. Project documentation: https://github.com/fawazahmed0/currency-api.
- Yahoo Finance (optional, selectable in settings) receives currency pair codes when rates are refreshed. Terms: https://legal.yahoo.com/us/en/yahoo/terms/product-atos/apiforydn/index.html and Privacy: https://legal.yahoo.com/us/en/yahoo/privacy/index.html.

Currency flag icons are bundled locally with the plugin (no external requests). Flag artwork is provided by the flag-icons project (https://github.com/lipis/flag-icons), MIT licensed.

== Shortcodes ==

Basic currency switcher:

[codeuna_currency_switcher]

Button-style currency switcher:

[codeuna_currency_switcher style="buttons"]

Currency converter:

[codeuna_currency_converter]

== WooCommerce Compatibility ==

WooCommerce must be installed and activated before using the plugin.

== Installation ==

1. Upload the Codeuna Currency Switcher plugin folder to `/wp-content/plugins/`.
2. Activate the plugin from the WordPress Plugins screen.
3. Open Codeuna Currency in the WordPress admin menu.
4. Configure currencies, rates, display options, and checkout behavior.

== Frequently Asked Questions ==

= Does this plugin require an API key? =

No API key is required for the included public exchange-rate providers.

= Can I use manual exchange rates? =

Yes. Each configured currency can use an automatic or manual rate.

= Can I force a specific currency during checkout? =

Yes. Checkout settings include fallback and payment-method currency controls.

= Where can I learn more about Codeuna Pro? =

Visit:
https://codeuna.com/getproversion

== Changelog ==

= 2.0.9 =

* Added a documented three-currency limit to the free version.
* Replaced invalid external-service Terms and Privacy URLs with valid provider information.
* Renamed stored option, cron, cookie, and form identifiers with a unique plugin prefix.

= 2.0.8 =

* Fixed a PHP warning ("headers already sent") caused by stray byte-order-mark characters in plugin files.
* Bundled flag icons locally instead of loading them from an external CDN or relying on emoji (which did not render as flags on some systems).
* Switched exchange-rate CDN reference to a non-CDN fallback domain.
* Improved output escaping, input sanitization, and nonce-verification coverage throughout the plugin.
* Renamed internal widget class to include a plugin-specific prefix.

= 2.0.7 =

* Currency configuration supports up to three currencies in the free version.
* Improved currency management and display controls.
* Added checkout fallback and forced-currency options.
