=== X-Currency - The Ultimate WooCommerce currency switcher for a smoother shopping experience ===
Contributors: crafium, doatkolom, mdalaminbey
Donate link: https://crafium.com/
Tags: currency switcher, woocommerce currency switcher, currency switcher plugin, multi currency, woocommerce
Requires at least: 6.5
Tested up to: 7.0
Requires PHP: 7.4
Stable tag: 2.5.1
License: GPLv3 or later
License URI: http://www.gnu.org/licenses/gpl-3.0.html

Woo Currency Switcher lets you handle multi-currency seamlessly, allowing customers to switch currencies on your WooCommerce store easily.

== Description ==

X-Currency Switcher is a free WooCommerce multi currency switcher for WordPress sites. With this plugin, you can create multiple custom currencies with flags, custom codes, money symbols, extra fees, money sign positions, and many more. X-currency also has the most powerful customizer available in the currency switcher market. You can create modern and unlimited switchers for your site. We provide 6 different readymade switcher templates so that you can create a beautiful currency switcher on the fly.  You can show approximate product prices on shop, single, cart, and checkout pages. You can set up different coupons, and shipping rates for each currency. It allows you to exchange currency rates automatically and pay in the selected currency. 

X-Currency is a WooCommerce Currency Switcher tool that is available as a shortcode and sticky.

> **[Demo](https://demo.crafium.com/x-currency)** |  **[Get Support/Contact Us](https://crafium.com/x-currency)** | **[Roadmap](https://app.loopedin.io/x-currency)** | **[Make A Feature Request](https://app.loopedin.io/x-currency#/ideas)**


https://youtu.be/jghDa342DSc


## 🔥 Custom Currency Support ##

Our currency switcher allows you to create unlimited currency including custom currency like Bitcoin and many more.

## 🔥 Update Base Currency ##

From our dashboard, you can change the default currency used by your WooCommerce store. You will also find many helpful options here

## 🔥 Currency Custom Flag ##

Our currency switcher allows you to design what you want. Like, drop-down, flags. For each currency it is possible to set its own flag.

## 🔥 Specific product price for each currency ##

You can set different product price for each currency. Your site visitors can add them into cart and pay with the amount you will define for each currency.

## 🔥 Currency Base Payment Gateways ##

Allow your site visitors to pay in the selected currency. You can also disable payment gateways for any specific currency

## 🔥 User Geo Ip Welcome Currency ##
You have the control to let the site visitors see prices in their country currency! You can set what currency to display to each country

## 🔥 Readymade Switcher Demo ##

For currency swithcer style, we're giving you template system. You can create unlimited template with our powerful customizer. [Watch the video](https://youtu.be/jghDa342DSc) to know more about it.


## 🔥 Currency Auto Update ##

Update currency rate manually or automatically. We allows you to set time duration based on that currency rate can be auto updated

## 🔥 No Get Data in Link ##

You can remove selected currency code from the url. It's an optional feature that can help you to keep your site url clean

## 🚀 Switcher Sticky Template ##

You can create sticky/sidebar switcher style with our powerful customizer. Show your currency switcher at any corner of the screen

## 🚀 Specific shipping amount for each currency ##

You can set a fixed shipping amount for each shipping method and each currency.

## 🚀 Specific coupon amount for each currency ##

You can set a fixed coupon amount for each coupon code and each currency.

## 🚀 Approximate product price ##

Shows approximate product price on the shop page, single page, cart page and checkout page. Page condition settings also added with this feature.

## 🚀 Update All Product Price According To Base Currency ##

You can change default product price currency. It's a powerful feature that can help you to entirely change your base currency

## 🚀 Custom Css ##

Make your currency switcher style more beautiful than before. It's a powerful feature for the guy who can write css code.

## 🚀 Hooks For Developers - Coming soon ##

We allows you to change any prices out of WooCommerce. Like pricing table or any other places where switching currency is important

## ⏰ Modal Dropdown Style - coming soon ##

It's a modern style where currency list will appear into a modal with a bigger view. It helps to create better user experice 

<h4>🚀 Compatibility And Tested With</h4>
<ul>
<li><a href="https://wordpress.org/plugins/optincraft/" target="_blank"><strong>OptinCraft</strong></a> The Powerful Drag & Drop Popup Builder for WordPress</li>
<li><a href="https://wordpress.org/plugins/shopengine/" target="_blank"><strong>ShopEngine</strong></a> Elementor WooCommerce Builder Addons, Variation Swatches, Wishlist, Products Compare – All in One Solution</li>
<li><a href="https://crocoblock.com/plugins/jetwoobuilder/" target="_blank"><strong>JetWooBuilder</strong></a> Top-rated Elementor WooCommerce plugin</li>
<li><a href="https://wordpress.org/plugins/breeze/" target="_blank"><strong>Breeze</strong></a> WordPress Cache Plugin</li>
<li><a href="https://wordpress.org/plugins/packeta/" target="_blank"><strong>Packeta</strong></a></li>
<li><a href="https://wordpress.org/plugins/woocommerce-product-addon/" target="_blank"><strong>PPOM</strong></a> - Product Addons & Custom Fields for WooCommerce</li>
<li><a href="https://wordpress.org/plugins/yith-woocommerce-product-add-ons/" target="_blank"><strong>YITH</strong></a> WooCommerce Product Add-Ons</li>
<li><a href="https://wordpress.org/plugins/variation-monster/" target="_blank"><strong>Variation Monster</strong></a> - Variation Tables, Swatches & Quick View for WooCommerce</li>
</ul>

## Privacy Policy 
X-Currency uses [Appsero](https://appsero.com) SDK to collect some telemetry data upon user's confirmation. This helps us to troubleshoot problems faster & make product improvements.

Appsero SDK **does not gather any data by default.** The SDK only starts gathering basic telemetry data **when a user allows it via the admin notice**. We collect the data to ensure a great user experience for all our users. 

Integrating Appsero SDK **DOES NOT IMMEDIATELY** start gathering data, **without confirmation from users in any case.**

Learn more about how [Appsero collects and uses this data](https://appsero.com/privacy-policy/).

== Frequently Asked Questions ==

= Does it work with any WordPress theme? =

Yes, it will work with any standard WordPress theme.

= Will it work with Gutenberg and Elementor? =

Yes, it will work.

== Screenshots ==
= 2.5.1 - 23 May 2026 =
* Fixed: Welcome Currency popup demo import issue.

= 2.5.0 - 01 Apr 2026 =
* New: Added a currency selection field on the order edit page (PRO).
* New: Introduced additional options for currency rounding (PRO).

== Changelog ==
= 2.4.2 - 17 Mar 2026 =
* Fixed: Currency not switching to the base currency when the base currency was already selected.

= 2.4.1 - 11 Mar 2026 =
* New: Added advanced rounding options (Nearest 10, 100, 1000) for currency conversions (PRO).

= 2.4.0 - 20 Feb 2026 =
* Improved: Restored PHP 7.4 support.
* Fixed: Product sale price conflict with rounded price.

= 2.3.1 - 08 Jan 2025 =
* Fixed: Compatibility issue with Visual composer Builder.

= 2.3.0 - 31 Dec 2025 =
* Improved: Fix pro version update not working issue.

= 2.2.3 - 30 Dec 2025 =
* Improved: Updated minimum PHP requirement to 8.1. PHP 7.4 is no longer supported.

= 2.2.2 - 11 Dec 2025 =
* Fixed: Subtract amount migration issue.

= 2.2.1 - 10 Dec 2025 =
* Fixed: Coupon exclude sale items feature not working issue.

= 2.2.0 - 08 Dec 2025 =
* New: Integrate X-Currency with OptinCraft plugin.

= 2.1.3 - 06 Dec 2025 =
* Tweak: Removed OptinCraft notice.

= 2.1.2 - 03 Dec 2025 =
* Improved: Added WordPress 6.9 compatibility.

= 2.1.1 - 27 Nov 2025 =
* Improved: Updated currency rate sample data.

= 2.1.0 - 23 Nov 2025 =
* New: Added product price subtract amount feature (PRO).
* Improved: Enhanced dashboard UI and overall user experience.

= 2.0.6 - 29 Sep 2025 =
* Fixed: Updated date issue in currencies table.

= 2.0.5 - 20 Sep 2025 =
* New: Added z-index control for currency switcher.

= 2.0.4 - 30 Aug 2025 =
* Improved: Tweak php and js code.

= 2.0.3 - 16 Aug 2025 =
* New: YITH WooCommerce Product Add-Ons compatibility.
* New: PPOM – Product Addons & Custom Fields for WooCommerce compatibility.

= 2.0.2 - 5 Aug 2025 =
* Fixed: Improve currency switcher dropdown positioning with responsive logic and optimizations.

= 2.0.1 - 5 July 2025 =
* Added: Packetery plugin compatibility.

= 2.0.0 - 1 Jun 2025 =
* New: Introduced the ability to set a specific currency for the checkout page, with optional country-based conditions.
* Improved: Enhanced dashboard UI and overall user experience.
* Improved: Optimized performance for faster load times.

= 1.6.8 - 24 May 2025 =
* Improved: Optimized JS and PHP.

= 1.6.7 - 04 December 2024 =
* Added: Coupon min and max restriction amount exchange support.

= 1.6.6 - 03 December 2024 =
* Added: WordPress 6.7 compatibility.

= 1.6.5 - 28 August 2024 =
* Fixed: JavaScript click event issue for the switcher.
* Fixed: Conditionally closed PHP session if x-currency was initiating a session.

= 1.6.4 - 30 July 2024 =
* Improved: Eliminated the call to session_write_close function in the SettingsServiceProvider.

= 1.6.3 - 30 July 2024 =
* Fixed: PHP warning: cannot modify header information.
* Fixed: Uncaught Error in $order->get_currency() function.

= 1.6.2 - 16 June 2024 =
* Fixed: Page refreshing issue with /setcurrency=1

= 1.6.1 - 14 June 2024 =
* Fixed: Switchers style loading issue.

= 1.6.0 - 8 June 2024 =
* Added: Breeze plugin compatibility.
* Improved: Switchers render from the server side.

= 1.5.4 - 26 March 2024 =
* Fixed: Option data unserialize fatal error.

= 1.5.3 - 22 March 2024 =
* Fixed: Undefined array key "x-currency-pro/x-currency-pro.php" warning.

= 1.5.2 - 24 February 2024 =
* Fixed: PRO version auto update issue.

= 1.5.1 - 24 February 2024 =
* Improved: Added alt tag in currency flag img tag.
* Fixed: Switcher template modal close issue.

= 1.5.0 - 30 December 2023 =
* Fixed: ceil(): Argument #1 ($num) must be of type int|float error.

= 1.4.9 - 17 December 2023 =
* Fixed: Cloudflare rocket script loader issue.

= 1.4.8 - 16 December 2023 =
* Fixed: Switcher not working in IOS(iphone 11) issue.

= 1.4.7 - 12 December 2023 =
* Added: Rounding decimal product prices.
* Fixed: Shipping taxes amount not exchanging issues.

= 1.4.6 - 10 November 2023 =
* Added: Cloudflare rocket script loader compatibility.
* Added: Wordpress 6.4 compatibility.

= 1.4.5 - 16 October 2023 =
* Improved: Triggering x-currency loader event once dom is ready.

= 1.4.4 - 14 October 2023 =
* Improved: Replaced switcher react component to web-component.
* Improved: Replaced react-sortable-hoc npm package to @dnd-kit npm package.
* Improved: Stop loading assets out of x-currency dashboard page.

= 1.4.3 - 21 August 2023 =
* Improved: To get the user country code using WC_Geolocation class instead of third-party API.
* Removed: Browser push notification.

= 1.4.2 - 12 August 2023 =
* Fixed: Shipping price conflicting issue with PrintFul.
* Fixed: Product specific price display issue.

= 1.4.1 - 10 June 2023 =
* Fixed: Browser multiple history creating issue.
* Fixed: Currency in_array fatal error.

= 1.4.0 - 23 May 2023 =
* Fixed: Currency rate type not working issue.
* Improved: Database queries are reducing 10X.
* Improved: Call session_write_close() function after write session.
* Improved: Move plugin structure to MVC Framework structure.

= 1.3.5 - 13 April 2023 =
* Fixed: 0 can not be selected for decimal value for currency settings

= 1.3.4 - 04 February 2023 =
* Added: Approximate price type control feature.
* Added: Show approximate currency code.
* Improved: Admin dashboard UI.

= 1.3.3 - 09 January 2023 =
* Added: Notice close button.

= 1.3.2 - 27 November 2022 =
* Added: X-Currency pro version release admin notice

= 1.3.1 - 19 November 2022 =
* Fixed: Base currency not found issue
* Improved: Optimized JS and PHP

= 1.3.0 - 12 November 2022 =
* Fixed: Currencies rates auto refresh not working issue.
* Fixed: Free shipping amount for each currency exchange issue.
* Fixed: Simple product price for each currency exchange issue.
* Fixed: Approximately cart and checkout total issue
* Improved: Optimized js and PHP

= 1.2.9 - 30 October 2022 =
* Fixed: Disable payment gateways setting not working issue

= 1.2.8 - 18 October 2022 =
* Fixed: Navbar markup destroying issue

= 1.2.7 - 17 October 2022 =
* Fixed: Subscription Issue
* Improved: Upgrade the entire frontend with Gutenberg.

= 1.2.6 - 03 September 2022 =
* Fixed: Sale discount percent issue.
* Fixed: Specific product price for each currency not working issue.
* Fixed: Currency not switching issue.

= 1.2.5 - 14th Aug 2022 =
* Added: Fixer Api Layer aggregator.
* Added: Currency order info metabox inside order details page.
* Fixed: Currency rates are not updated issue, when the base currency is updated.
* Fixed: Notification package issue with react version.
* Improved: optimized animate js file.

= 1.2.4 - 13th July 2022 =
* Fixed: Shortcode switcher scroll chaining issue
* Improved: Shortcode dropdown height
* Optimized: Scrolling related JS and css code

= 1.2.3 - 13th June 2022 =
* Fixed: Switcher preview issue on customizer
* Improved: Optimize JS and Css
* Improved: Compatible with the wordpress latest version 6.0

= 1.2.2 - 14th May 2022 =
* Added: Filter report by currencies
* Improved: Switcher shortcode Dropdown

= 1.2.1 - 25th April 2022 =
* Fixed: Product is_type() method undefined fatal error
* Fixed: Routing issue with FluentCRM plugin
* Fixed: Gutenberg editor page's Button background issue
* Improved: Initial loading time
* Improved: Side Sticky demo design

= 1.2.0 - 23th April 2022 =
* Added: Auto Fill option while creating a new currency.
* Added: Specific product price for each currency
* Fixed: Currency base payment gateways disable settings.
* Improved: Optimized JS Code.
* Improved: Improved Geo IP.
* Improved: Transition and Plugin UI.

= 1.1.1 - 16th April 2022 =
* Fixed: Multisite not working issue.
* Fixed: Currency aggregator not working issue
* Fixed: Price without cents not working issue.
* Improved: Approximate product, cart and checkout amount.
* Improved: Some global settings controls have been added for cart total extra fee.

= 1.1.0 - 14th April 2022 =
* Added: Specific coupon amount for each currency
* Added: Specific shipping amount for each currency
* Added: Approximate product price
* Added: Approximate cart and checkout amount
* Added: Sticky switcher
* Added: 3 new demos for sticky switcher
* Added: Full width controls for shortcode switcher

= 1.0.0 - 30th March 2022 =
* Initial release