LWSDOCUMENTATION

WooCurrency

Welcome to the Long Watch Studio Document Centre dedicated to WooCurrency. This plugin offers a powerful currency switching solution for WooCommerce

This documentation is divided in several sections :

  1. WooCurrency Standard
  2. WooCurrency Pro

 

WOOCURRENCY STANDARD

WooCurrency is a currency switcher plugin. The currency is automatically switched so that customers allways see the currency you chose for them. With the standard version, you can setup an unlimited amount of currencies. Price will be calculated thanks to change rates updated daily.

With WooCurrency Pro, you get access to many other functionalities. You'll be able to change the way your prices are shown for each currency and choose the rules for each product.

Here we will go over the various features of this plugin. You can access the WooCurrency admin panel through the WooCommerce->WooCurrency menu in your WordPress administration. The first section of this documentation will be dedicated to the Standard version of WooCurrency. To view the Pro version documentation, click here.

General Settings

Currency List

In this section, you can define the currencies you want to use on your WooCommerce Shop. To add a new currency, click the Add button on the bottom-right of the currency list. Fill in the following values :

  • Currency : The new currency you want to use.
  • Countries : The countries in which you want to use this currency.
  • Price rounding : The rounding rule you want to apply to the prices once the change rate has been applied.

Once you're finished, click the Save button to add the new currency to the list of available currencies. You can add as many currencies as you want.

If a country is not selected at all in the currency list, the default WooCommerce currency will be used.

The currency list will always present the following informations when shown on the list :

  • Symbol : Currency symbol.
  • Currency : Currency name.
  • Associated countries : All the countries selected for this currency

IP Testing

We've added a way for you to test some IP addresses to see if WooCurrency will work as expected. Fill in the Tested IP field and click the Test IP button to see the result.

Both ipv4 and ipv6 address are available for testing.

The result will show the following information :

  • Tested IP : The IP address that was tested
  • Country : The country code associated with the IP address
  • Country currency : The currency used in the country
  • Selling currency : The currency that will be used in your shop according to your WooCommerce/WooCurrency settings.

WooCurrency PRO

The WooCurrency Pro features are only available to licence owners. The documentation below is regularly updated and always matches the latest available version.

If some features presented below are not available in your version of WooCurrency, then you don't have the latest version. Please update to the last version or subscribe a maintenance to get access to it.

General Settings

Currency List

In this section, you can define the currencies you want to use on your WooCommerce Shop. To add a new currency, click the Add button on the bottom-right of the currency list. Fill in the following values :

  • Currency : The new currency you want to use. When you select a new currency, all countries using this actual currency will automatically be selected in the countries list.
  • Countries : The countries in which you want to use this currency.
  • Price rounding : The rounding rule you want to apply to the prices once the change rate has been applied.
  • Price formatting : The price formatting helps you change the way prices in that currency will be shown to your customers. You can adapt 4 values :
    • Symbol Alignment
    • Thousand Separator
    • Decimal Separator
    • Visible decimals

Once you're finished, click the Save button to add the new currency to the list of available currencies. You can add as many currencies as you want.

If a country is not selected at all in the currency list, the default WooCommerce currency will be used.

The currency list will always present the following informations when shown on the list :

  • Symbol : Currency symbol.
  • Currency : Currency name.
  • Associated countries : All the countries selected for this currency
  • Price Format : An example of how the price would be presented in that currency.

Price Shortcode

You can use the shortcode n/c to display the price of your products outside of WooCommerce default Controls.
Replace yourProductId by the product id that you can find on WooCommerce's Products page.

IP Testing

We've added a way for you to test some IP addresses to see if WooCurrency will work as expected. Fill in the Tested IP field and click the Test IP button to see the result.

Both ipv4 and ipv6 address are available for testing.

The result will show the following information :

  • Tested IP : The IP address that was tested
  • Country : The country code associated with the IP address
  • Country currency : The currency used in the country
  • Selling currency : The currency that will be used in your shop according to your WooCommerce/WooCurrency settings.

Change Rates

In this Tab, you can see all the change rates relative to your default WooCommerce Currency. You cannot change the values. You can navigate the list pages to see all values.

The change rates are updated daily by default. You can change the number of days between two updates by changing the Change rate cache expiration in day. The value can't be lower than 1.

Product Rules

When you edit a WooCommerce Product, a new set of fields is available to manage currencies for that product. In the general Tab, you can now see a Per currency price section. You can click the arrow button to fold/unfold the currency fields.

For each currency set in the WooCurrency settings, you will have 3 choices :

  • Use change rate : Default behavior. The price will be calculated using the daily updated change rates
  • Fixed price : You can set fixed prices for both regular and sale values. This is useful if you don't want prices to change daily on your website.
  • Not purchasable : The product isn't purchasable in that currency. Visitors will still be able to see the product on your website, but they won't have and Add to cart button.

You can have different rules for each currency of each product. If you don't set rules on a product, the general rule (Use change rate) will apply.