# WooCommerce Multi Currency

Support Purchase

Thank you for using 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!

Created: 11/06/2017
Latest update: 22/05/2020

**IMPORTANT AND REQUIREMENT**

- Requires WordPress Version: 4.4 or higher
- Requires WooCommerce Version: 3.2.x
- We have tested WooCommerce Multi Currency with many WordPress themes, plugins and 3rd party WooCommerce extensions, but it’s impossible to test them all, so some may still have compatibility issues. Please read the Compatibility documentation section. Should you notice any problem, please contact us with the details and screenshots. We’ll do our best to find the solution!

Updated to WooCommerce Multi Currency ver 2.1.9.3

By: VillaTheme

### FILE INCLUDES

- The plugin zip files woocommerce-multi-currency.zip

### Instruction

Do you want to display price as multi currencies on your shop page? Do you want your site to autodetect customer’s country and display price as their native currency? Do you want to accept payment in customer’s native currency? Woo Multi Currency will help you with all these things.

### INSTALLATION

#### System Requires

It is recommended using

1. Plugin WooCommerce 3.2 or newer is installed and activated.

2. Make sure that those limits to a minimum as follows in order 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 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.

### How to use

After installing the plugin, please go to Dashboard/ Multi Currency/ General to set up your currencies and exchange rates. Then there should be a currencies bar to appear on your site, allowing customers to switch between currencies.

### HOW DOES IT WORK

#### General

In General, you can set up the main features of WooCommerce Multi Currency

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.
3. Use SESSION: By default, the selected currency will be saved in cookies. Turn 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, allow customers to switch the price between currency. There are 4 options for you to select
   No – disable this option.
   Flag – display
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 Cache plugin on Currencies changing/converting on your WooCommerce.
7. Default Currency: The default currency will appear on your site if no auto-select option is enabled.
8. Hidden: This option allows you to hide some currencies which you don’t want to appear on front-end. By selecting Yes, you will hide that currency on front-end.
9. Currency: Select currencies here
10. Position: Select how will prices be displayed on the front-end. The price before the symbol, the symbol before the price, with or without space.
11. Rate and exchange fee: Rate can be entered by yourself or the plugin will automatically fill in. The exchange fee can be changed by you only.
12. Number of decimals: Select how many numbers will be displayed after the command in each currency.
13. Custom symbol: This option allows you to enter a custom symbol for each currency. Example America Dollar can be displayed as $, USD, $ US…
14. Action: Allow you to update the exchange rate of a specific currency or remove that currency
15. Update All Rates: Update exchange rates of all your currencies.
16. Add Currency: This button will duplicate your last currency, then you back to option 8-Currency to select a new currency.
17. Add All Currencies: Add all currencies on your settings.
18. Remove All Currencies: Remove all existing currencies.

#### Location

In Location tab, you can set up the plugin to automatically select currency base on customers’ country or language.

Auto Detect: Auto select currency

1. Auto Detect: There are 4 option for you to select
– No: Turn off the auto detect currency option, customers will select currency by themselves
– Auto select: Auto detect currency base on the country of customers. The plugin will detect customers’ countries base on their IP Address. Then select the currency which you assign in option 4 of this tab.
– Approximate Price: The plugin will detect customers’ country then display an approximate price in their native country under WooCommerce price
– Polylang: Auto select currency base on Polylang language.
2. Geo API: The Geo API you want to use to detect customers’ countries. There are 2 options WooCommerce and External.
3. Currency by Country: Work with Auto Detect turned on. Currencies will be displayed base on customers ‘s countries.
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 to display the approximately price based on Customers’s country.

1. Auto Detect: Choose the option Approximate Price.
2. Approximate position: Choose the positions which you want to show approximate price in order preview.
3. Approximately label: Enter the label for approximate price.
4. Approximate priority: Choose the priority for approximate price: below original price or above original price.

#### 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 will the currencies bar appear by using WP conditionals Tags.
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.

- 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:

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

### Shortcode

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

- 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]` |

- - Exchange rate shortcodes allow you to display live exchange rates on the front-end.
    `[woo_multi_currency_rates currencies="GBP,EUR"]` This shortcodes will display the exchange rate between GBP, EUR and your default currency on front-end. You can change to other currencies by change the currencies codes GBP, EUR
    ``[woo_multi_currency_exchange price="100" currency="EUR”]`` Example I have USD as my default currency, this shortcode will display the EUR amount converted from 100 USD.
  - Shortcode for configuring the size of flag: adding the short code flag_size= value[0-1] to the shortcode of currency selector widget. Example: `[woo_multi_currency_layout4 flag_size=0.4]`

### 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
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
WooCommerce 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

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