=== Themex Currency Manager for WooCommerce ===
Contributors: themexplosion, mominkhan08, arafatjamil01
Tags: woocommerce, currency, exchange rate, switcher, multicurrency
Requires at least: 6.0
Tested up to: 7.0
Requires PHP: 7.4
Stable tag: 1.0.1
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Let customers view and switch currencies on your WooCommerce store.

== Description ==

Themex Currency Manager lets customers view and switch currencies on your WooCommerce store.

**Features**

* Admin settings: General, Location, Checkout, Design, Update
* Unlimited currencies with manual or live exchange rates
* Custom currency symbol, decimal, and thousand separators per currency
* Optional exchange fee (fixed or percent)
* Geolocation auto-detect (WooCommerce Geo API and external providers)
* Approximate price auto-detect
* Country-to-currency mapping
* Floating currencies bar with custom colors, positions, and desktop collapse mode
* Conditional tags for floating bar visibility
* Single product page currency switcher (multiple positions)
* AJAX currency switch with optional loading mask
* WooCommerce price, cart, and variable product support
* Checkout currency support
* Fixed price per currency via product meta `_themx_wcmc_price_{CODE}`
* Cache plugin support: WP Super Cache, W3 Total Cache, WP Rocket
* Widget and shortcode `[themx_currency_switcher]`

== Installation ==

1. Install and activate WooCommerce.
2. Upload and activate **Themex Currency Manager for WooCommerce**.
3. Go to **Themex Currency Manager → Settings**, enable the plugin, add currencies, and save.

== Frequently Asked Questions ==

= How many currencies can I add? =

As many as you need. There is no limit.

= Shortcode? =

`[themx_currency_switcher style="list"]` or `style="bar"`.

= Caching? =

Enable **Use cache plugin** under General settings.

= Is there a commercial add-on? =

An optional Pro add-on with finance API rate automation, session storage, advanced checkout rules, and integrations is available separately from the plugin author. It is not required for the free plugin to work.

== External services ==

This plugin connects to third-party services to fetch live exchange rates and detect visitor location. Data is sent only when an administrator updates rates (manually or via scheduled tasks) or when geolocation is enabled.

**Exchange rate APIs**

When rates are updated, the plugin requests the latest rates for a base currency code from these providers (in order of fallback):

* ExchangeRate-API — https://open.er-api.com/ (terms: https://www.exchangerate-api.com/terms, privacy: https://www.exchangerate-api.com/privacy)
* Frankfurter — https://frankfurter.dev/ (terms and privacy: https://frankfurter.dev/)
* fawazahmed0 currency API via jsDelivr — https://github.com/fawazahmed0/exchange-api (CDN: https://www.jsdelivr.com/terms/privacy-policy)

Only the base currency code is included in the request URL. No personal user data is sent to these services.

**Geolocation API**

When **Geo API → External** is enabled, the plugin may send the visitor's IP address to:

* ip-api.com — https://ip-api.com/ (terms: https://ip-api.com/docs/legal, privacy: https://ip-api.com/docs/legal)

The response country code is cached locally for up to 24 hours.

**WooCommerce Geolocation**

When **Geo API → WooCommerce** or **MaxMind** is selected, country detection uses WooCommerce's built-in geolocation (see WooCommerce privacy policy).

== Development ==

Source code: https://github.com/themexplosion

== Changelog ==

= 1.0.1 =
Version bump for wordpress.org submission.

= 1.0.0 =
Initial public release.
