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.

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.

–  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.
– You choose “MaxMind Geolocation” if you want to retrieve customer data directly from the data detected by WooCommerce. Upon configuring the MaxMind License Key, our plugin fetches details automatically. It’s crucial to understand that this process is managed by WooCommerce, and our plugin does not interfere with it.

3. Currency by Country:

With Auto Detect being set as “Auto select country” and this option is turned on, this option controls whether the currency is displayed based on specific countries listed in the table or as a universal setting

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

  • 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”

General

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

  1. Enable: Enable/Disable the plugin
  2. Fixed Price: Activate the “Fixed Price” function to control product prices independently of exchange rates, adding and using your product prices in each currency.
    After enabling this option, follow the steps in this documentation, as well as the note while using “Fixed price”
  3. Don’t use exchange rate: This option makes the price not automatically converted to the exchange rate, even if the fixed price in some currencies is empty.
  4. Use SESSION: By default, CURCY marks the selected currency, using cookies, on the browser. Activating this option will let the plugin save this information on the server.
  5. Switch Currency by JS: When you change the currency using switcher/selector/etc…, it adds this query to the URL: ?wmc-currency={currency}. Enable this option to remove the query. It is good for SEO.
    Note: If you use a multilingual plugin – like TranslatePress – and have the currency changed by the language, this option doesn’t work. It’s the param added for compatibility and can’t be changed otherwise.
  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.
    • AJAX: Sends a request to the server to get the correct price in a particular currency, to overwrite the cached price. Using this option will cause a bit of delay before showing the correct price. It has to work that way to get the correct currency when your site is cached
      • Reload filter price: Enable this option to reset the price filter when loading via AJAX
    • JSON: Enabling this option to directly convert the price to all other currencies, and hide the conversion in HTML. Then CURCY detects the cookie currency, looks for the JSON string to see what the currency code is, and overwrites it.
  7. Loading price mask: When you use “Override by AJAX” for cache, there’s a while before the correct price is shown. This option adds a “mask” to cover the cached price for the delay
  8. Bot currency: Enable this if you are using a caching plugin and currency does not remain after being switched by customers in the frontend
  9. Currency option:
    • Default Currency: The currency your store will be priced in.
    • Hidden: This option allows you to hide some currencies that 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 the Rate + Exchange fee can be added in fixed/percentage value. It’s the total value of the exchange rate and the exchange fee added 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. For example, the American dollar can be displayed as $, USD, $ US…
    • Thousand separator: This option allows you to specify whether you want to use a comma or a dot to separate thousands when displaying numerical values. For example, with the comma option selected, a number like 1,000 would be formatted as 1,000, while with the dot option, it would be formatted as 1.000.
    • Decimal separation: This option allows you to define the symbol used to separate decimal values when displaying numerical figures. You can choose between a comma or a dot to indicate the decimal point. For instance, with the comma option selected, a decimal value like 3.14 might be formatted as 3,14, while with the dot option, it would be displayed as 3.14.
    • Action: Allow you to update the exchange rate of a specific currency, or remove that currency
  10. Update All Rates: Update the exchange rates of all your currencies.
  11. Add Currency: This button will duplicate your last currency, then you back to option 8-Currency to select a new currency.
  12. Add All Currencies: Add all currencies to your settings.
  13. Remove All Currencies: Remove all existing currencies.