=== FOX - Currency Switcher Professional for WooCommerce ===
Contributors: RealMag777
Tags: woocommerce, currency, switcher, currency switcher, multi currency
Requires at least: 6.0.0
Tested up to: 7.0
Requires PHP: 7.4
Requires Plugins: woocommerce
Stable tag: 2.4.7
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

FOX is a professional multi-currency plugin for WooCommerce. Add any currency, switch prices in real time, customers pay in their selected currency.

== Description ==

**FOX - Currency Switcher Professional for WooCommerce** (former name: WOOCS) is a flexible multi-currency plugin that allows store visitors to switch product prices between currencies in real time and optionally pay in their selected currency.

FOX is available as a shortcode **[[woocs]](https://currency-switcher.com/shortcode/woocs/)** and as a widget. It supports any currency from the [ISO 4217 active codes list](https://en.wikipedia.org/wiki/ISO_4217#Active_codes).

Latest PHP 8.x – COMPATIBLE!

* [Demo](https://demo.currency-switcher.com/)
* [Documentation / API](https://currency-switcher.com/codex/)
* [FAQ](https://currency-switcher.com/faq/)

---

### Features:

**Representation**
Currency Switcher is available as a widget and works in any widgetized area. The shortcode [woocs] can be inserted anywhere on the site, including the top menu.

**Design**
3 display modes: drop-down, flags, side switcher. Set a flag per currency. Use the built-in Smart Designer to create fully custom drop-down designs.

**Checkout**
Customers can pay in their selected currency (option: "Is multiple allowed").

**Rates**
7+ currency aggregators for automatic rate updates. Manual rate entry is also available. Admin can receive email notifications about rate changes.

**Rates Auto Update**
Hourly, twice daily, daily, weekly, monthly, or custom intervals (5, 15, 30, 45 minutes).

**Price Formatting**
Set decimals count, money sign, sign position, thousand and decimal separators per currency. Hide cents per currency. Supports non-standard currencies including BTC.

**Custom Money Signs**
Create and use your own currency symbols.

**Smart Designer**
Interactive front-end builder for custom multi-currency drop-down switchers. Unlimited designs for different site areas.

**Statistics**
Collects currency switching data (currency, country, time). No personal customer data collected. Order currency statistics also available.

**Currency Visibility**
Set currencies as Public or Private. Private currencies are hidden from switchers and cannot be set via URL.

**Payments Rules**
Show or hide payment gateways on checkout depending on the active currency.

**Welcome Currency**
Set a different default display currency for first-time visitors.

**User Role Pricing**
Set different base-currency prices per user role (loyalty programs, wholesale, etc.).

**GeoIP Rules**
Automatically switch currency based on visitor IP. Per-product country/currency rules. "Checkout by GeoIP rules" forces local currency on purchase.

**Fixed Prices Per Product**
Override rate-based conversion with a fixed price per currency per product.

**Fixed Amounts for Shipping, Coupons, Free Delivery Threshold**
Set per-currency fixed values instead of rate-calculated amounts.

**Approximate Price Display**
Show approximate local currency price near the product price and in cart/checkout (GeoIP + rates mode).

**Cache Plugin Compatibility**
"I am using cache plugin" option ensures correct currency switching on cached sites.

**Order Storage**
Each order is stored in the currency the customer paid (when "Is multiple allowed" is enabled).

**Price Info Icon**
Hover icon near prices showing all currency equivalents.

**Currency Storage Mechanisms**
Session, Transient, Memcached, Redis, FOX Session — choose based on hosting architecture.

**Shortcodes**
[[woocs]](https://currency-switcher.com/shortcode/woocs/) — switcher widget
[[woocs_price]](https://currency-switcher.com/shortcode/woocs_price/) — switchable product price in articles
[woocs_converter] — currency converter widget
[woocs_rates] — currency rates widget
[woocs_show_current_currency] — display current currency
[woocs_show_custom_price] — show custom amount in current currency

**No GET Parameters in URL** (optional)
Switch currency without appending ?currency=USD to links.

**WPML & Polylang**
Switch currency automatically when the site language changes.

**REST API**
[REST API documentation](https://currency-switcher.com/function/rest-api/)

**Wide Developer API**
Hooks and functions for price manipulation, rate logic, and display customization. [Full API docs](https://currency-switcher.com/codex/).

**Compatibility**
Compatible with WPML, Polylang, WooCommerce Products Filter (HUSKY), CTX Feed, RnB Booking, WebToffee Product Feed, Points and Rewards by WP Swings. 95% compatibility with payment gateways in multi-currency mode.

---

== Screenshots ==
1. Currency options


== Changelog ==

= 2.4.6 =
* Small fixes
* 2 security issues fixed (Patchstack bounty program, reported by Que Thanh Tuan and timomangcut)
* 1 security issue fixed (Wordfence bounty program, reported by Ren Voza)

= 2.4.5 =
* Added hook woocs_sheduler_rates_updated

= 2.4.4 =
* Set of small fixes
* New hook woocs_price_html
* New REST API endpoint

= 2.4.3.1 =
* Small fixes
* Fix related to new coupon creation in WooCommerce

= 2.4.3 =
* Small fixes
* New option: Rate floor/ceil - set min/max rate boundaries per currency to protect against sharp rate fluctuations
* New hook woocs_init_compatibility_woo_subscriptions: enables compatibility with WooCommerce Subscriptions

= 2.4.2.3 =
* 1 security issue fixed (Wordfence bounty program, reported by mikemyers)

= 2.4.2.2 =
* 1 security issue fixed (Wordfence, reported by Arkadiusz Hydzik)

= 2.4.2.1 =
* 1 security issue fixed (Patchstack, reported by Ananda Dhakal)

= 2.4.2 =
* Bunch of small fixes
* Improved code security

= 2.4.1.9 =
* 1 security issue fixed (Wordfence, reported by stealthcopter)

= 2.4.1.8 =
* 1 security issue fixed (Patchstack, reported by Dhabaleshwar Das)
* New feature: update order rates from order edit screen; analytics table data is updated accordingly

= 2.4.1 =
* New storage type: FOX Session
* New function convert_from_to_currency - convert an amount between any two currencies directly

= 2.4.0 =
* Heap of small fixes
* New storage type FOX Session
* New function convert_from_to_currency

== Upgrade Notice ==
Always backup before updating. See full changelog at https://currency-switcher.com/changelog
