Latest updated: 10/2023 – Updated version: 2.3.1
Thank you for purchasing our plugin. If you have any questions that are beyond the scope of this documentation, please feel free to request support at our Support Forum. Thanks so much!
**IMPORTANCE AND REQUIREMENT**
WooCommerce Multi-Currency is a currency converter plugin for WooCommerce, which allows you to display prices and accept payments in multiple currencies. The plugin can detect customers’ countries and languages, and apply prices as their native currency. It is also convenient for users to switch between different currencies with currencies bar, to find the currency they want, among the available options.
THE PLUGIN FEATURES:
The plugin is flexible with many currency options for front-end display, update exchange rates option
WooCommerce Multi Currency can automatically detect customers’ native currency based on their country or language.
*Important: Please take note that the auto-detect county features may not work properly with websites/servers that have a cache. Please try out the free version to check if it works fine on your website.
* Note: This option can be applied to detect at the country level, not working for states or provinces and regions within a country.
WooCommerce Multi-Currency allows you to select checkout currencies. You can select one or more checkout currencies.
*Important: Please take note that in order to display a payment gateway on the checkout page, that payment gateway must support your default currency. Example: If you have South African Rand ZAR as your default currency, then it is not possible for you to enable PayPal on your checkout page. Because PayPal does not support ZAR, even if you used Multi-Currency to change ZAR to USD on the front-end.
This setting allows you to make beauty prices, you can set the rules to your product price
The plugin provides you shortcodes to display currencies exchange widgets, exchange rates on the front-end.
The plugin can be displayed on the front-end as a widget or a currency bar.
1. Plugin WooCommerce 4.0 or newer is installed and activated.
2. Make sure that those limits are to a minimum as below for free trouble while installing.
Get the plugin installation package from your account download page and save it to your desktop.
Go to Plugins/ Add New/ Upload Plugin/ Choose file/ Select woo-multi-currency.zip file/ click “Install Now“/ click “Active plugin“.
Install and Set up Video
Done! Let’s start using the plugin.
After installing the plugin, please go to Dashboard/ Multi Currency/ General >> Enable the plugin to start using the plugin.
Make sure to click “Save” to save the settings.
After activating the plugin, start building a list of currencies in the General settings. This is an important part as the currency list is the basis, all other functions of the plugin will work based on this list.
This needs to be done in the “Currency Options” table at the end of the tab.
Step 1: Go to the General tab of the plugin settings
Step 2: In the “Currency Options” table, click “Add currency” to add more currencies you need.
Step 4: Configure each currency.
Step 5: Click “Save settings“.
Please regard this documentation – part (9) Currency option – for a specific explanation of each option.
CURCY allows the admin to add a fixed price to the product price for each currency you have on your list. Follow the steps below to achieve:
Now, there will be fields to add the price in different currencies in the product data. The fixed price of the product in each currency can be added, it will overwrite the price converted using the exchange rate when users switch currencies.
1. To add fixed prices for particular products, follow these steps below:
With the “Simple product” type:
With the “Variable product” type:
Add the fixed price for all variations of the product as below:
Another way, you can add a fixed price in one currency for ALL variations of that product:
Go to Product data > Variations > In the “Add variation” option > Scroll down to see the option to set regular/sale prices in each currency of Multi Currency
2. To add fixed prices in bulk using a CSV file, visit this documentation for specific steps.
After an order is placed, the admin can change the currency order in the Orders settings, following these steps below:
CURCY provides you an element to show the Currency Selector for users to switch currencies when you build/design a page with the Elementor plugin.
In General tab, you can set up the main features of CURCY
In the Location tab, you can set up the plugin to automatically select currency based on customers’ country or language.
Auto Detect: Auto select currency
1. Auto Detect: There are 4 options for you to select
– No: Turn off the auto-detect currency option, customers will select currency by themselves
– Auto select currency: Auto detect currency based on the country of customers. The plugin will detect customers’ countries based on their IP Addresses. Then select the currency which you assign in option 4 of this tab.
– Approximate Price: The plugin will detect customers’ country based on their IP, then display an approximate price in their native country under WooCommerce price
– Polylang: Auto-select currency based on Polylang language.
You can refer to this video guide:
– TranslatePress Multilingual: This option helps to set up the currency by language.
2. Geo API: The Geo API you want to use to detect customers’ countries. There are 3 options WooCommerce and External.
3. Currency by Country: With Auto Detect being set as “Auto select country” when this option is turned on, currencies will be displayed based on customers’ countries.
If the Auto Detect feature is set to be “Approximate price’
– Enable: Plugin will detect the customer’s IP address, and the approximate price will be shown with currency based on the country’s respective currency as in the table below the option
– Disable: Approximate price will be detected based on the country’s official currency
4. Countries: Select which currency will be displayed for customers from which countries.
– Select all: Select all countries for displaying a specific currency.
– Remove all: Remove all existing countries.
6. Get country by currency: Automatically enter the countries that use the corresponding currencies.
Auto detect: Approximate Price
This option allows displaying the approximate price based on Customers’ country.
With Auto Detect feature being set as Approximate Price, there will be options:
Other options have the same function as above.
In Checkout tab, you can select which currencies will be able to check out. And which payment methods are able to check out with each currency.
Design tab, where you can configure the front-end interface of the plugin.
Design Currencies Bar
Other settings of Design
This setting allows you to make your price more beautiful, you will set the rules to create your desired product price.
* Note: This feature is not applied for shipping.
In Update, you can find options about the auto-update currency exchange rate and the plugin.
From version 2.1.13 of this plugin, the Bulk Fixed Price feature is updated that allows to bulk add fixed prices for products. This helps you to save time for adding fixed prices for products in multiple currencies.
Important note: You can’t edit price in default currency with Bulk fixed price function. This price in CSV file is for view only. If you edit it and import back, it will not change the default currency price.
Step 1: Go to Multi Currency settings > Bulk Fixed Price
Step 2: Export product file in CSV format
Step 3: Fill or change the fixed regular/sale price of each currency
Step 4: Upload the same file in CSV format to import.
The plugin provides you shortcodes to display currencies exchange widgets, exchange rates on the front-end.
[woo_multi_currency_rates currencies="GBP,EUR"]This shortcode will display the exchange rate between GBP, EUR, and your default currency on the front-end. You can change to other currencies by changing the currencies codes GBP, EUR
[woo_multi_currency_exchange product_id="" currency="" price="" original_price=""]
Note: This is applied for specific product pages built with Elementor or other page builders.
|Plugin||Author||Converted Price||Fixed Price|
|WooCommerce Product Bundles||SomewhereWarm||Yes||No|
|WooCommerce PDF Invoices & Packing Slips||Ewout Fernhout||Yes||No|
|Printful Integration for WooCommerce plugin||Printful||Yes||No|
|Table Shipping Rate||WooCommerce||Yes||No|
|LearnPressWooCommerce Dynamic Pricing & Discounts plugin||RightPress||Yes||No|
|Polylang||Frédéric Demarle||Change currencies base on language|
|WPML||OnTheGoSystems||Change currencies base on language|
|TranslatePress – Multilingual||Cozmoslabs, Razvan Mocanu, Madalin Ungureanu, Cristophor Hurduban||Change currencies base on language|
|Autoptimize||Frank Goossens (futtta)||Require to change WooCommerce settings|
|WP Fastest Cache||Emre Vona||Require to change WooCommerce settings|
|WP Super Cache||Automattic||Require a free plugin|
|WP Rocket||WP Media||Fully compatible|
|W3 Total Cache||Frederick Townes||Fully compatible|
|Extra Product Options for WooCommerce||Themehigh||Fully compatible|
|WooCommerce TM Extra Product Options||themeComplete||Fully compatible|
|Event Tickets||Modern Tribe, Inc.||Fully compatible|
|The Events Calendar||Modern Tribe, Inc.||Fully compatible|
|Name Your Price||Kathy Darling||Fully compatible|
|WooCommerce PDF Invoices, Packing Slips, Delivery Notes & Shipping Labels||WebToffee||Fully compatible|
|Subscriptio – WooCommerce Subscriptions||RightPress||Fully compatible|
|Woo Discount Rules||Flycart||Bulk discount (percentage + fixed), Product adjustment (percentage + fixed), Cart adjustment (percentage discount only)|
|WooCommerce Product Add-ons||WooCommerce||Fully compatible|
|Catna – WooCommerce Name Your Price and Offers||Villatheme||Convert price + support fixed price for Name your price fields|
|WooCommerce Boost Sales||Villatheme||Dynamic price and discount for bundle|
|WooCommerce Product Add-Ons Ultimate||Plugin Republic||Fully compatible|
|CTX Feed Pro||WebAppick||Fully compatible|
|WooCommerce Wholesale prices||Rymera Web Co||Fixed price and Converted price|
|Advanced Free Shipping||Jeroen Sormani||Partial compatible|
|DHL Express Shipping for WooCommerce – Live Rates||Octolize||Partial compatible|
|Fancy Product Designer||Radykal||Partial compatible|
|Google Listings and Ads||WooCommerce||Partial compatible|
|Litespeed Cache||LiteSpeed Technologies||Partial compatible|
|Product Designer for WooCommerce WordPress | Lumise||King-Theme||Partial compatible|
|Smart Bundle For WooCommerce||WooCommerce||Partial compatible|
|Subscriptions for WooCommerce||WebToffee||Partial compatible|
|Visual Product Configurator for Woocommerce Lite||ORION||Partial compatible|
|WCFM||WC Lovers||Partial compatible|
|WooCommerce Payments||Automattic||Partial compatible|
|WooCommerce Product Bundles||WooCommerce||Partial compatible|
|Woofunnels Order Bump||FunnelKit||Partial compatible|
|Advanced Product Fields For Woocommerce Pro||StudioWombat||Partial compatible|
|WooCommerce Google Product Feed||Ademti Software Ltd||Partial compatible|
|WPC Product Bundles||WPClever||Partial compatible|
|Wallet System for WooCommerce||WP Swings||Partial compatible|
|PPOM for WooCommerce by N-MEDIA||Najeeb Ahmad||Partial compatible|
|WooCommerce Subscriptions||WooCommerce||Partial compatible|
|Yith Frequently Bought Together||YITH||Partial compatible|
|Yith WooCommerce Points And Rewards Premium||YITH||Partial compatible|
|YITH WooCommerce Product Add-Ons||YITH||Partial compatible|
|YITH WooCommerce Dynamic Pricing and Discounts||YITH||Partial compatible|
|YITH WooCommerce Product Bundles||YITH||Partial compatible|
|Advanced Dynamic Pricing for WooCommerce||AlgolPlus||Partial compatible|
|Germanized for WooCommerce||vendidero||Partial compatible|
|Envia Shipping and Fulfillment||WooCommerce||Partial compatible|
|Extra Product Options & Add-Ons for WooCommerce||ThemeComplete||Partial compatible|
|WooCommerce Checkout||CheckoutWC||Partial compatible|
|WPC Product Bundles for WooCommerce||WPClever||Partial compatible|
|WooCommerce Loyalty Points and Rewards||Flycart||Partial compatible|
Currency converter functions:
// get settings
$wmcCurrencies = $multiCurrencySettings->get_list_currencies();//get list currency
$currentCurrency = $multiCurrencySettings->get_current_currency();// get current currency
= floatval( $wmcCurrencies[ $currentCurrency ]['rate'] );// get rate of current currency
$currentCurrencyRate = 1;
$multiCurrencySettings = WOOMULTI_CURRENCY_Data::get_ins();
$wmcCurrencies = $multiCurrencySettings->get_list_currencies();
$currentCurrency = $multiCurrencySettings->get_current_currency();
$currentCurrencyRate = floatval( $wmcCurrencies[ $currentCurrency ]['rate'] );
It’s crucial to understand that once an order is made, the currencies might switch to those supported by the chosen payment method. Here are some prevalent payment methods and the currencies they accommodate:
Note: For some payment methods, the supported currencies might vary based on the country and the type of advertising account you have. For the most accurate and updated information on supported currencies for each payment method, it’s recommended to visit the official payment method website or the support documentation specific to the service you’re inquiring about:
|Payment methods||Supported currencies||Official Sources|
|PayPal||AUD, BRL, CAD, CNY, CZK, DKK, EUR, HKD, HUF, ILS, JPY, MYR, MXN, TWD, NZD, NOK, PHP, PLN, GBP, SGD, SEK, CHF, THB, USD||Link|
|Stripe||USD, AED, AFN, ALL, AMD, ANG, AOA, ARS, AUD, AWG, AZN, BAM, BBD, BDT, BGN, BIF, BMD, BND, BOB, BRL, BSD, BWP, BYN, BZD, CAD, CDF, CHF, CLP, CNY, COP, CRC, CVE, CZK, DJF, DKK, DOP, DZD, EGP, ETB, EUR, FJD, FKP, GBP, GEL, GIP, GMD, GNF, GTQ, GYD, HKD, HNL, HTG, HUF, IDR, ILS, INR, ISK, JMD, JPY, KES, KGS, KHR, KMF, KRW, KYD, KZT, LAK, LBP, LKR, LRD, LSL, MAD, MDL, MGA, MKD, MMK, MNT, MOP, MUR, MVR, MWK, MXN, MYR, MZN, NAD, NGN, NIO, NOK, NPR, NZD, PAB, PEN, PGK, PHP, PKR, PLN, PYG, QAR, RON, RSD, RUB, RWF, SAR, SBD, SCR, SEK, SGD, SHP, SLE, SOS, SRD, STD, SZL, THB, TJS, TOP, TRY, TTD, TWD, TZS, UAH, UGX, UYU, UZS, VND, VUV, WST, XAF, XCD, XOF, XPF, YER, ZAR, ZMW||Link|
|Squarespace||ARS, AUD, BRL, GBP, CAD, COP, CZK, DKK, EUR, HKD, INR, IDR, ILS, MYR, MXN, NZD, NOK, PHP, PLN, RUB, SGD, ZAR, SEK, CHF, THB, USD||Link|
|Authorize.net||USD, CAD, GBP, EUR, CHF, DKK, NOK, PLN, SEK||Link|
|Apple pay||Africa: Morocco, South Africa
Asia-Pacific: Australia, China mainland*, Hong Kong, Japan, Macao, Malaysia, New Zealand, Singapore, South Korea, Taiwan, Vietnam.
Europe: Armeniam, Austria, Azerbaijan, Belarus, Belgium, Bulgaria, Croatia, Cyprus, Czech Republic, Denmark, Estonia, Faroe Islands, Finland, France, Georgia, Germany, Greece, Greenland, Guernsey, Hungary, Iceland, Ireland, Isle of Man, Italy, Kazakhstan, Jersey, Latvia, Liechtenstein, Lithuania, Luxembourg, Malta, Moldova, Monaco, Montenegro, Netherlands, Norway, Poland, Portugal, Romania, San Marino, Serbia, Slovakia, Slovenia, Spain, Sweden, Switzerland, Ukraine, United Kingdom, Vatican City.
Latin America and the Caribbean: Argentina, Brazil, Chile, Colombia, Costa Rica, El Salvador, Guatemala, Honduras, Mexico, Panama, Peru.
Middle East: Bahrain, Israel, Jordan, Kuwait, Palestine, Qatar, Saudi Arabia, United Arab Emirates.
North America: Canada.
|Amazon pay||AUD, GBP, DKK, EUR, HKD, JPY, NZD, NOK, ZAR, SEK, CHF, USD.||Link|
Thank you for your attention!
If you have any question, please create a topic at our FORUM, we will support within 24 hours.