Templates
| Template | Usage |
| /woo-multi-currency-selector.php | [woo_multi_currency],[woo_multi_currency_plain_vertical_2] shortcode |
Follow this guide on how to override VillaTheme plugins’ templates via a theme.
page_section Category: woocommerce-multi-currency
Supported Currencies of Payment Methods
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. |
Link |
| Amazon pay | AUD, GBP, DKK, EUR, HKD, JPY, NZD, NOK, ZAR, SEK, CHF, USD. | Link |
DEVELOPERS
Currency converter functions:
$multiCurrencySettings= WOOMULTI_CURRENCY_Data::get_ins();
$wmcCurrencies = $multiCurrencySettings->get_list_currencies();//get list currency
$currentCurrency = $multiCurrencySettings->get_current_currency();// get current currency
$currentCurrencyRate= floatval( $wmcCurrencies[ $currentCurrency ]['rate'] );// get rate of current currency
-
To get the current currency rate:
$currentCurrencyRate = 1;
if(class_exists('WOOMULTI_CURRENCY_Data')) {
$multiCurrencySettings = WOOMULTI_CURRENCY_Data::get_ins();
$wmcCurrencies = $multiCurrencySettings->get_list_currencies();
$currentCurrency = $multiCurrencySettings->get_current_currency();
$currentCurrencyRate = floatval( $wmcCurrencies[ $currentCurrency ]['rate'] );
}
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.
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.
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 |
| LearnPress | ThimPressYesNo | Yes | No |
| LearnPressWooCommerce 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 |
| REDIS – WooCommerce Dynamic Pricing and Discounts | Villatheme | |
| 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 |
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.
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
- On a single product page:
- To display a currency converter to convert specific value among currencies, use this shortcode:
[woo_multi_currency_convertor]
- Currency Selector widgets with different front-end styles.
| Shortcode | Description |
| [woo_multi_currency] |  |
| [woo_multi_currency_plain_horizontal] |  |
| [woo_multi_currency_plain_vertical direction=’top’] |  |
| [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_layout11] |  |
|
[woo_multi_currency_product_price_switcher] Note: This is applied for specific product pages built with Elementor or other page builders. |
 |
Update
In Update, you can find options about the auto-update currency exchange rate and the plugin.
- Auto update exchange rate: Select the time when the plugin will update exchange rates. Every 30 minutes, 1 hour…
- Finance API: Select where the exchange rate will be obtained. Supported APIs are:
- Default
- Google Finance
- Yahoo Finance
- Cuex
- Wise: Go to Wise Sandbox to create an account, create an API Token, and insert the API token to the “Wise Api token” field under CURCY’s Update settings.
- Xe
- Open exchange rates: Go to Open exchange rates to create an account, create an App ID, and paste it to the “Open exchange rates App ID” field.
- Exchangerate API: Go to Exchagerate API to create an account, create an API Access Key, and paste it to the “Exchagerate API Access Key” field.
- Currencyapi: Go to Currency API to create an account, create an API Key, and paste it to the “Currencyapi API Key” field.
- Custom: If you select “Custom”, you can custom exchange rate via “wmc_get_currency_exchange_rates” hook
- Rate decimals: Select the exchange rate decimals
- Emails: Enable this option to receive an email whenever exchange rates are updated successfully.
- Email Custom: When you don’t want to receive updated exchange rate email in admin email.
- Auto Update Key: Fill in the key that you get from https://villatheme.com/my-download to automatically update the WooCommerce multicurrency plugin. You can follow this guide.
Design
Go to Dashboard >> Multi Currency >> Design, this is where you can configure the front-end interface of the plugin.
Currencies Bar
Settings for Currencies Bar – the sidebar currency list, displayed in the left or right middle section of the site, on any pages
- Enable/Disable the currencies bar: The bar float on a sidebar of your site, and allows customers to switch currencies.
- Checkout page: Enable to hide currencies bar on the checkout page.
- Cart Page: Enable to hide currencies bar on the cart page.
- Conditional Tags: Configure where the currencies bar will appear by using WooCommerce conditionals Tags and WordPress Conditional 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 that are validated and/or provided by trusted developers - Title: Enter the title of the currencies bar.
- Position: Select currencies bar position – Left or Right
- Desktop: Collapse the currencies bar on desktop. It shows only one selected currency and expands on hover. Disabling this will turn off all related settings – from option 8 to 11 – below.
- Click to expand currencies bar: Allows users to expand the Currencies Bar upon clicking the (+) button
- Expand button color: Set the icon color for expanding-the-bar button
- Expand button background: Set the background color of the expand icon
- Expand button opacity: Adjust the transparency of the expand icon
- Mobile: Enable it to allow Currencies Bar Collapse on mobile.
- Top position: Set the distance from the sidebar center to the top of the screen (use % or px).
- Max height(px): Enter the max height for the currencies bar.
- Text color: Select the color of the currency bar text.
- Sidebar layout: 3 layouts
- Curved border and no split space: Displays each currency in a dropdown with no gaps between lines, and rounded corners on the dropdown box
- Split currency line with space: Displays each currency in a dropdown with blank space separating each line for a more spaced-out look
- Single slide select
- Curved border and no split space: Displays each currency in a dropdown with no gaps between lines, and rounded corners on the dropdown box
- Style: Select the style of the currencies bar, there are 4 options for you to select: Default (Currency code), Symbol, Flag, Flag & Currency Code, and Flag & Currency symbol.
- Main color: Configure the color of the currencies bar.
- Currency name background: If “Sidebar layout” is “Single slide select”, set up this background color for the currency name when Currencies Bar is collapsed.
- Hover color: Currencies bar changes to this color when you hover
- Background color: Configure the background color of the currencies bar.
Currency selector
Settings for the Currency Price Switcher, which is visible on single product pages only.
- Currency Price Switcher: Display a price switcher under product price on product pages, allowing customers to switch the price between currencies. There can be some selections:
- Not show
- Flag
- Flag + Currency code
- Flag + Price
- Currency Symbol
- Switcher layout: 2 layouts
- Curved border and no split space: Displays each currency in a dropdown with no gaps between lines, and rounded corners on the dropdown box
- Split currency line with space: Displays each currency in a dropdown with blank space separating each line for a more spaced-out look
- Price Switcher Positions: Support the following positions on the single product pages, including:
- Below title
- Below price
- Below excerpt
- Below add to cart
- Below meta
- Below sharing
- Click to expand the currency selector: By default, dropdown currency selector including product price switcher, Currency selector widgets(except the Default layout) and Currency selector shortcodes(except [woo_multi_currency]) will expand on hovering. Enable this option if you want them to only expand when clicking on.
Currency price collate
- This feature displays prices in all available currencies except the one currently selected (since it’s already shown).
- This feature works on both single product pages and product list.
- This feature uses exchange rates to convert prices and doesn’t support Fixed price feature
- Enable: Enable this feature
- Price collate layout: Adjusts the layout style of prices with multiple currencies displayed together
- Inline: All currencies in one line
- Split line: Each currency a line
- Single product position: Sets the position of the grouped prices in all currencies on single product pages. Note: this option can be affected by your theme or product template if you use page builder.
- After title
- After price
- After excerpt
- After add to cart
- After meta
- After sharing
- Archive position: Sets the position of the grouped prices in all currencies on archive pages
Widget, Flag Custom: The option for you to replace a flag with your flag.
Settings for currency tool created by dragging widget under Appearance.
Shortcode
Settings for Currency Selectors created by shortcodes.
- Text color: Change the text color of the currency shortcode
- Background color: Change the background color of the currency shortcode
- Activate text color: Change the text color of the currency shortcode when activating
- Activate background color: Change the background color of the currency shortcode when activating
Custom CSS: Allows you to add your own CSS code to design the currencies bar or widget.
Checkout
This is the video version of configuration guide.
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.
- Enable: Enable the multicurrency payment function.
- Enable Cart Page: Change currency in the Cart page to check out currency.
- Checkout currency: Enable specific currency for checkout and Force currency on payment method
- Currency: List of your currencies
- Default: There must always be a currency always available for checkout. Choose one with this option, it does not have to be the site default currency
- Checkout Currency: Make particular currency available/unavailable in checkout. The selected one in the “Default” option above will always be “Yes”
- Payment method: Select particular payment method for each currency if you want. The valid payment method will show up correspondingly on the Checkout page. If this field is blank for all currencies, all payment methods will be applied depending on their supported currencies.
- Yes/No: Bulk change checkout status of all currencies
- Currency by Payment method: Assign the currency to the payment method if needed. Currency – after the customer clicks the “Place order” button – will become the corresponding selected one in this table, except for PayPal (there’s a note for this payment method if you enable it)
- Option to change currency belong to payment gateway as soon as customer select payment gateway
- Option to make currency change work without reloading page
- Change currency follow: Make the currency on the Checkout page change based on customer’s shipping/billing country
- Sync checkout currency: When currency is switched on cart/checkout page by the “Change currency follow” option above, also switch currency of the whole current customer session
- Display multi currencies: Enable to display both in store pages and checkout page if they are different at the check out page.