WooCommerce Multi Currency


Created: 11/2017

Latest updated: 3/2022 – Updated version: 2.1.30

By: VillaTheme

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:

 

CURRENCY OPTIONS

The plugin is flexible with many currency options for front-end display, update exchange rates option

  • Auto-update exchange rate: The plugin automatically updates exchange rates. You can set the time for the automatic update: every 30 minutes, 1 hour, 6 hours, 1 day, 2 days, 3 days, 1 week, 1 month.
  • Successful update exchange rate email: The plugin will send a notification email whenever it updates the exchange rate.
  • Set the exchange rate manually: The plugin also allows you to set up the exchange rate manually.
  • Exchange fee: Every time you exchange money from one currency to another, the bank or money transfer operator may apply a currency exchange fee. The difference between the exchange rate they decide to apply and the real exchange rate traded in the market is the currency exchange fee. WooCommerce Multi-Currency allows you to add permanent exchange fees to exchange rates.
  • Price formatting: Design position for currency symbol
  • Custom currency symbol: You can customize currency symbols. Example: United States Dollar can be displayed as USD, US$, $…
  • Fixed Price: This allows you to set up custom prices in different currencies in every product. The fixed prices will overwrite the prices calculated by exchange rates.
  • Hidden Currency: The plugin allows you to hide currencies that you do not want to be shown on the front-end.
  • Select currency exchange rate sever: You can select to update the exchange rate from VillaTheme.com, Google Finance, Yahoo Finance. More exchange rate servers will be added in the future.
  • Use SESSION: The plugin will use the session instead of cookies to save the selected currency.
  • Currency Price Switcher: A switcher appears under the product price. Allow customers to switch the price between currencies.

AUTO-DETECT CURRENCY

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.

  • Detect currency based on customers’ country: The plugin will detect customers’ country based on their IP address, then select their currency to display prices.

* Note: This option can be applied to detect at the country level, not working for states or provinces and regions within a country.

  • Currency by country: You can select which currency will be displayed to customers from which country.
  • Approximate Price: With this feature, prices will be displayed in the default currency. But under that, there will be approximate prices that are displayed in the customer’s native currency.  Help customers know how expensive/cheap products are.
  • Auto-select currency based on Polylang language: The plugin will select a currency to display prices base on your site language. For example, there are 2 languages on your site English and Spanish, you can select to display prices in GBP on the English site and in EUR on the Spanish site.
  • Auto-select currency based on WPML language: Similar to Polylang, but prices will be selected based on WPML’s language.

CHECKOUT CURRENCY

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.

  • Allow multi-currency payment: Customers can purchase in their selected currency. In order to use this feature, you need a payment gateway enabled on your site that supports the customer-selected currency.
  • Selected check-out currencies: The plugin allows you to select check-out currencies. For example, you can display prices in 4 different currencies on your shop but accept payment in 2 currencies only.
  • Display payment methods based on currency: You can select which payment gateway will appear on the checkout page based on the currency.
  • Checkout Currency on Cart page: Change the currency on the Cart page to check out currency.

PRICE FORMAT

This setting allows you to make beauty prices, you can set the rules to your product price

  • Accept lower bound: Enable if you accept making price beautiful for both lower bound and upper bound price. Disable this function will be applied for upper bound price only.
  • Add rules: Set the rules to display beauty prices on the front-end. You can read the guidance here.

 

SHORTCODES

The plugin provides you shortcodes to display currencies exchange widgets, exchange rates on the front-end.

 

DESIGN

The plugin can be displayed on the front-end as a widget or a currency bar.

  • Currencies bar design: – Type in your currencies bar title, it is “Select your currency” by default. – Select currencies bar position left or right. – Style: there are 5 styles for you to select currency code, currency symbol, flag, flag + currency code, flag + currency symbol. – Color and background color.
  • Conditional tags: Select which page where the bar will appear by using WordPress conditional tags, WooCommerce condition tags.
  • Widget design: You can customize the widget title and widget styles are available to be selected.
  • Custom flag: Some countries use the same flag, this option will help you to display the country as a currency right.
  • Custom CSS: All of these options are not enough? You can add your own CSS to design your widget and currencies bar.
  • Collapse Currencies Bar: Allow to minimize the currencies bar on the front-end. The currencies will appear as one currency and display fully when customers hover their mouse on it.

System Requires

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.

max_execution_time 60
memory_limit 256M
post_max_size 64M
upload_max_filesize 64M

Download Plugin

Get the plugin installation package from your account download page and save it to your desktop.

Install & Active plugin

Go to PluginsAdd NewUpload PluginChoose 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.

 

 

Configure the currency list

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 for a specific explanation of each option.

 

 

How to set fixed price

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:

  • Enable the “Fixed Price” option in the plugin settings. Regard this documentation for a specific explanation.

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:

  • Go to Dashboard > Products > Select a product
  • Scroll down to the Product data of that product
  • Add fixed prices according to necessity.

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.

 

Note:

  1. If the fixed price of some particular products/in some specific currencies is not added, it’ll show the price converted using the exchange rate when users switch currencies. So you still need to configure the exchange rate.
  2. If an item has sale prices in non-default currencies, its sale price in the default currency must be set so the sale price in other currencies can be available.
  3. “Fixed price” is not applied to the WooCommerce Coupon value.

 

 

Change currency of created orders

After an order is placed, the admin can change the currency order in the Orders settings, following these steps below:

  • Go to Dashboard > Orders > find the order you need to change currency
  • On the Order editing page, select the currency you want to change to in the “Change currency” option
  • Click “Update
  • (Must do) After the currency of the order is changed successfully, click “Recalculate
  • Click “Update” again

Note:

  1. Only orders whose payment has not been completed can be changed the currency.
  2. Only orders whose initial currency is the default can be changed the currency.

 

 

CURCY with Elementor

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.

  • Drag and drop the “Multi Currency” element

 

  • Now select the style for the Currency Selector

HOW DOES IT WORK


General

In General tab, you can set up the main features of CURCY

  1. Enable: Enable/Disable the plugin
  2. Fixed Price: The plugin allows you to enter custom prices in different currencies for each product. This custom price will overwrite the price calculated by the exchange rate. You can enter fixed prices in product edit pages.
    • Note: To make fixed shipping costs apply to a specific currency, you have to explicitly set all available cost fields in that currency if the respective field in the default currency is not empty. Then go to the Shipping tab in WooCommerce Settings > Set fixed shipping fee for the shipping methods
    • Important: Even if you enable this option, you still have to Update/Config currency rates properly because rates will be used in case fixed product price/shipping cost is not set for a currency
  3. Use SESSION: By default, the selected currency will be saved in cookies. Turning on this option will let the plugin save this information in session instead of cookies. This option is useful for websites with cache, where the selected currency change back to the default currency after reloads.
  4. Currency Price Switcher: Display a price switcher under product price on product pages, allowing customers to switch the price between currencies.
  5. Switch Currency by JS: Enable it to make currency will be changed, but it does not use URL. It is good for SEO. Now it is not compatible with Caching plugin
  6. Use Cache plugin: Enable this option when you are using any cache plugin on your site to remove the negative impacts of the Cache plugin on Currencies changing/converting on your WooCommerce.
  7. Bot currency: Enable this if you are using a caching plugin and currency does not remain after being switched by customers in the frontend
  8. Currency option:
    • Default Currency: The currency your store will be priced in.
    • Hidden: This option allows you to hide some currencies which you don’t want to appear on the front-end. By selecting Yes, you will hide that currency on the front-end.
    • Currency: Select currencies here
    • Position: Select the position for the currency symbol.
    • Rate + exchange fee: Rate is the global exchange rate between the default currency and the others. The value of Rate + Exchange fee can be added in fixed/percentage value. It’s the total value of the exchange rate and the exchange fee adding to the product price when users switch currencies.
    • Number of decimals: Choose the number of digits to appear after the decimal separator.
    • Custom symbol: This option allows you to enter a custom symbol for each currency. Example America Dollar can be displayed as $, USD, $ US…
    • Action: Allow you to update the exchange rate of a specific currency, or remove that currency
  9. Update All Rates: Update the exchange rates of all your currencies.
  10. Add Currency: This button will duplicate your last currency, then you back to option 8-Currency to select a new currency.
  11. Add All Currencies: Add all currencies to your settings.
  12. Remove All Currencies: Remove all existing currencies.

 

Location

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.
– 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.

–  If you choose “WooCommerce”, the 3rd service WooCommerce uses:
‘ipinfo.io’ => ‘https://ipinfo.io/%s/json‘,
ip-api.com‘ => ‘http://ip-api.com/json/%s‘,
– If you choose “External”, we use: http://www.geoplugin.net
– If you choose “Inherited from server“: This option helps to use Geo API as inherited from the server. Please regard the note under this option before selecting.

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.
5. Select all: Select all countries for displaying a specific currency.
6. Remove all: Remove all existing countries.
7. 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:

  • Show Approximate price for: Select where you want to show approximate price, other than only show with product price
  • Approximate price’s label: Add label for Approximate price if you want
  • Approximate price’s position: Choose a position for the approximate price

Other options have the same function as above.

As in the image below, the approximate price is displayed below the original price, with the label “Approximately”

Checkout

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.

  1. Enable/Disable: the option to change currency to available checkout currency in the checkout page.
  2. Enable Cart Page: Change currency in the Cart page to check out currency.
  3. Default currency: The default currency on the checkout page. When the selected currency is not available for checkout. The currency on the checkout page will be forced to the default checkout currency.
  4. Checkout Curency: Select which currency is available for checkout.
  5. Payment methods: Select which payment methods will be available on the checkout page for each currency.
  6. Currency by Payment method: Use this option if you want to put a mandatory currency with the respective pament gateway after clicking on the “Place order”
  7. Change currency follow: the currency on checkout pagre can choose to change follow to : Shipping address, Billing address or None.
  8. Display multi currencies: Enable to display both in store pages and checkout page if they are different at the check out page.

Design

Design tab, where you can configure the front-end interface of the plugin.

Design Currencies Bar

  1. Enable/Disable the currencies bar: The bar float on a sidebar of your site, allows customers to switch currencies.
  2. Title: Enter the title of the currencies bar.
  3. Position: Select currencies bar position.
  4. Desktop: Enable it to allow Currencies Bar Collapse on desktop,  this option allows you to minimize the currencies bar on desktop. The currencies bar will appear as 1 selected currency and will display full when customers hover their mouse on it.
  5. Mobile: Enable it to allow Currencies Bar Collapse on mobile.
  6. Max height(px): Enter the max height for currencies bar.
  7. Text color: Select the color of currency bar text.
  8. Style: Select the style of the currencies bar, there are 4 options for you to select: Default (Currency code), Symbol, Flag,  Flag & Currency Code, Flag & Currency symbol.
  9. Main color: Configure the color of the currencies bar.
  10. Background color: Configure te background color of currencies bar.

Conditional Tags and Widget

  1. Check out page: Enable to hide currencies bar on the checkout page.
  2. Cart Page: Enable to hide currencies bar on the cart page.
  3. Other pages: Configure where the currencies bar will appear by using WP conditionals Tags.

    Important note: 

    To handle WP’s Conditional Tags, this plugin uses eval() which is very dangerous because it allows the execution of arbitrary PHP code. Therefore, please only fill this field with proper conditional tags which are validated and/or provided by trusted developers

  4. Flag Custom: The option for you to replace a flag with your own flag.

 

Shortcode and Custom CSS

  1. Text color:
  2. Background color:
  3. Activate text color:
  4. Activate background color:
  5. Custom CSS: Allow you to add your own CSS code to design the currencies bar or widget.

 

Price Format

This setting allows you to make your price more beautiful, you will set the rules to create your desired product price.

price format

  • Enable: To activate the option.
  • Accept lower bound: Enable if you accept making price beautiful for both lower bound and upper bound price. Disable this function will be applied for upper bound price only.
  • Add rule: You can add rule for price format following two rules below:

BEAUTY PRICE

* Note: This feature is not applied for shipping. 

 

 

Update

In Update, you can find options about the auto-update currency exchange rate and the plugin.

  1. Auto update exchange rate: Select the time when the plugin will update exchange rates. Every 30 minutes, 1 hour…
  2. Finance API: Select where exchange rate will be got. From Google, Yahoo, Transferwise and Cuex.
  3. Rate decimals: Select the exchange rate decimals
  4. Emails: Enable this option to receive an email whenever exchange rates are updated successfully.
  5. Email Custom: When you don’t want to receive updated exchange rate email in admin email.
  6. Auto Update Key: Fill in your key what you get from https://villatheme.com/my-download to automatically update WooCommerce multicurrency plugin. You can follow this guide.

Bulk Fixed Price


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.

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.

 

 

Shortcode


The plugin provides you shortcodes to display currencies exchange widgets, exchange rates on the front-end.

  • Exchange rate shortcodes allow you to display live 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
    For example, I have USD as my default currency, this shortcode will display the rate of GBP and EUR per 1 USD.
  • Shortcode for configuring the size of flag: adding the shortcode flag_size= value[0-1] to the shortcode of currency selector widget. Example: [woo_multi_currency_layout4 flag_size=0.4]
  • To display product price in a particular currency:
    • On a single product page: [woo_multi_currency_exchange]
    • Other than on a single product page: [woo_multi_currency_exchange product_id="" currency="" price="" original_price=""]
      • Product ID: add the ID of the product you want to convert currency
      • Currency: Add the currency you want to convert the product price, leave blank and the price will be converted the currency that is currently applied to customers
      • Price: Product price
      • Original price: Add this value if the item is on sale

 

  • Currency Selector widgets with different front-end styles.
Shortcode Description
[woo_multi_currency]
[woo_multi_currency_plain_horizontal]
[woo_multi_currency_plain_vertical]
[woo_multi_currency_layout3]
[woo_multi_currency_layout4]
[woo_multi_currency_layout5]
[woo_multi_currency_layout6]
[woo_multi_currency_layout7]
[woo_multi_currency_layout8]
[woo_multi_currency_layout9]
[woo_multi_currency_layout10]
[woo_multi_currency_product_price_switcher]

Note: This is applied for specific product pages built with Elementor or other page builders.

 

Shortcode Description
[woo_multi_currency]
[woo_multi_currency_plain_horizontal]
[woo_multi_currency_plain_vertical]
[woo_multi_currency_plain_vertical_2]
[woo_multi_currency_layout3]
[woo_multi_currency_layout4]
[woo_multi_currency_layout5]
[woo_multi_currency_layout6]
[woo_multi_currency_layout7]
[woo_multi_currency_layout8]
[woo_multi_currency_layout9]
[woo_multi_currency_layout10]

[woo_multi_currency_product_price_switcher]

Note: This is applied for specific product pages built with Elementor or other page builders.

COMPATIBILITY


 

Plugin Author Converted Price Fixed Price
WooCommerce Product Bundles SomewhereWarm Yes No
WooCommerce PDF Invoices & Packing Slips Ewout Fernhout Yes No
WooCommerce Bookings WooCommerce Yes No
Printful Integration for WooCommerce plugin Printful Yes No
Table Shipping Rate WooCommerce Yes No
WooCommerce Wholesale prices Rymera Web Co Yes No
LearnPress ThimPress Yes No
WooCommerce Dynamic Pricing & Discounts plugin RightPress Yes No

 

 

Plugin Author Compatible
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
Elementor Elementor.com 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

DEVELOPERS


Templates

Template Usage
/woo-multi-currency-selector.php [woo_multi_currency],[woo_multi_currency_plain_vertical_2] shortcode

Extra Information


Thank you for your attention!

If you have any question, please create a topic at our FORUM, we will support within 24 hours.