Additional Settings of Currency Per Product

Currency per Product for WooCommerce Pro plugin allows you to set and  display product prices in different currencies. There are various scenarios in which you can display the product prices in different currencies on Shop page, Cart and Checkout page:

1. Setting product prices in different currencies and displaying them on shop in different currencies.
2. Setting product prices in different currencies, but displaying them on shop in one currency which is converted using exchange rates.
3. Setting product prices in different currencies and displaying them on shop in different currencies. But it is converted to one currency and displayed in cart and checkout.

The behaviours of Shop, Cart, and Checkout pages can be set using the Behaviour options of this plugin.

Firstly, go to WooCommerce -> Settings -> Currency per Product -> General link and enable the Currency per Product for WooCommerce option. Then go to Behaviour link and the default Behaviour page will appear as shown below:

Default Behaviour settings page

This page consists of 3 sections:

1. Shop Behaviour Options
2. Cart and Checkout Behaviour Options
3. Reset Settings

In this section, we will discuss how you can set the prices to be shown on the shop page which are set for WooCommerce products.

Shop Behaviour options

Shop Behaviour option allows you to display product prices in either shop default currency or different currencies. You can choose from the following 2 options to set your shop’s behaviour.

Setting the shop behaviour

The 2 options that appear under Shop behaviour dropdown are:

1. Show prices in different currencies (and set cart and checkout behaviour separately)
2. Convert to shop default currency (including cart and checkout)

Show prices in different currencies (and set cart and checkout behaviour separately)

When you select this option from the dropdown, it will display your products in their assigned currencies on the Shop page.

To know how to assign different currency to different products, refer the General Settings post.

Products with different currencies on Shop page

This shows currency set for Canon Camera product is Pound sterling and its lens is Euros. Whereas Choco lava cake and Chocolate Cake are both assigned currency Malaysian Ringgit. Because Shop behaviour setting is set to Show prices in different currencies (and set cart and checkout behaviour separately) option, the Shop page displays prices for these products in their assigned currencies.

To set the cart and checkout behaviour separately, you need to select the options under Cart and Checkout Behaviour Options section which we will discuss in our next section.

Show prices in different currencies (and set cart and checkout behaviour separately) option is a default option for Shop behaviour setting.

Convert to shop default currency (including cart and checkout)

When you select this option for Shop behaviour setting, product prices with different currencies will be converted to the base currency that is set in global settings. This means prices for all WooCommerce products on the Shop page will be converted as per the base currency and displayed in the base currency on Shop page.

Note – The currencies will be converted to base currency as per the exchange rate which are set in Exchange Rates link which we will discuss in our next post.

Let us consider the above example where you can see products in 3 different currencies like Pound sterling, Euros and Malaysian Ringgit. Say the base currency for your products is Pound sterling and you select the option Convert to shop default currency (including cart and checkout) for Shop behaviour setting.

In this case, the Shop page will display all WooCommerce products in Pound sterling which is the shop’s default currency (base currency).

Products showing base currency on Shop page

Hence the product prices get converted as per exchange rate and are displayed in the base currency.

When you have your products with different currencies, you can choose to display same currency for them on the Shop page using this setting.

This setting allows you to enable display of original price of your products on Shop page and Admin product’s list along with shop default currency. This setting is used when a product price was converted to the shop default currency and you wish to show its original price as well on the front end. If Shop behaviour setting is set to Show prices in different currencies (and set cart and checkout behaviour separately) option then Add original price in shop will not be considered.

By default this option is disabled and to enable it, tick the Enable checkbox of Add original price in shop setting.

Enabling the option

You can also add a price template using short codes like %price%, %price_raw%, %currency_code% etc. The actual values will replace these short codes while displaying the product prices on the front end.

By default, Original price template uses short code <br>%price%.

Original price template

Let us consider the same example as above. Hence when you enable Add original price in shop setting and Shop behaviour is set to Convert to shop default currency (including cart and checkout), products with converted product prices will show their original prices.

Product prices with base currency and original prices

This shows 2 prices for the products, prices converted to base currency as well as its original prices on the Shop page.

Also, since the price template is using short code %price%, it displays currency and price. Say for instance you add Original price template as <br>%currency_code%%price% then the products will show prices with currency code.

Product prices with currency code

This setting allows you to select an appropriate option for displaying products with its price and currency on the Cart and Checkout page. There are various Cart and Checkout behaviour options to show product prices in different currencies on the front end.

Different cart and checkout behaviour options

Let us understand how each of these options work.

Convert to shop default currency

This setting will convert the price to the set exchange rate and display product prices as per the price of the base currency on the cart and the checkout page.

Convert to shop default currency option

Consider the base currency as Pound sterling and you select the Convert to shop default currency option for Cart and checkout behaviour setting and the currency for product Choco lava cake is Malaysian Ringgit.

Currency of Choco lava cake product is Malaysian Ringgit

Because of the settings, price of this product on Cart page and Checkout page will display a converted price to Pound sterling.

Cart page

Prices in base currency

Checkout page

Prices in base currency on Checkout page

Thus you can use this setting for displaying prices in single currency on the Cart and Checkout page despite of any currency set for the products.

Leave product currency (allow only one product to be added to cart)

This setting will allow you to add only one product to the cart. If you try to add more than one product then it will display a message restricting you from adding another product.

Selecting the option for cart and checkout behaviour setting

Let us take an instance where you already have a product in the cart and you try adding another product Chocolate Cake to the cart. Then a message will show up notifying you to either finish the order or clear the cart to add a new product.

Message on the Cart page 

This message that you see on the Cart page is the text you add in the Message: Leave product currency (allow only one product to be added to cart) option.

Add text for displaying message

Hence you can add any text in this field that you want to display on the Cart page restricting the customer from adding more than one product to cart.

By default, this message is Only one product can be added to the cart. Clear the cart or finish the order, before adding another product to the cart.

Note – If your Shop Behaviour option is set to Convert to shop default currency, then this option will be ignored and Cart and checkout behaviour option is needed to be set to Convert to shop default currency.

Leave product currency (allow only same currency products to be added to cart)

This setting will allow you to add products with same currency to the cart. If you try to add a product whose currency is not same as the already added product in the cart, then it will display a message restricting you from adding product of different currency.

Selecting the option for cart and checkout behaviour setting

Let us take an instance where you already have a product Chocolate Cake with currency Pound sterling in the cart. Now if you try adding another product Canon Camera Lens to the cart whose currency is Euros, then a message will be displayed. This message will notify you to either clear the cart or finish the order before adding product with different currency.

Message on the Cart page 

The message on the Cart page is the text you add in the Message: Leave product currency (allow only same currency products to be added to cart) option.

Add text for displaying message

Hence this way you can restrict the customer from adding products with different currencies in the cart. Cart will only accept products with same currency before proceeding to the Checkout page otherwise will display a notification message.

The default notification message for this setting is Only products with same currency can be added to the cart. Clear the cart or finish the order, before adding products with different currency to the cart.

Note – If Shop Behaviour option is set to Convert to shop default currency, then this option will be ignored and Cart and checkout behaviour option is always needed to be set to Convert to shop default currency option.

Convert to currency of last product in cart

When you have more than one product of different currencies in the cart, this setting will consider the currency of the last product. It will convert the currency of all products in the cart to the currency of the last product and accordingly convert the product prices as well.

Selecting Convert to currency of last product in cart option

So let us understand this setting using an instance. Consider the cart has product Choco lava cake whose currency is Malaysian Ringgit. Now say you add product Canon Camera Lens in the cart whose currency is Euros.

Products with different currencies

So when you select the Convert to currency of last product in cart option for Cart and checkout behaviour setting, the product price and currency of Choco lava cake will change to Euros. This is because the last product in the cart is Canon Camera Lens and its currency is Euros.

Hence all the products in the cart will show product prices in Euros and this will reflect on Cart and Checkout pages.

Cart page

Product price and currency change on Cart page

Checkout page

Change in Product price and currency 

Thus you can use this setting when you want to display prices in the currency of the last product, on Cart and Checkout page.

Note – If you set your Shop Behaviour option to Convert to shop default currency, then this option will not be considered. Also the Cart and checkout behaviour option is needed to be set to Convert to shop default currency option.

Convert to currency of first product in cart

Similar to Convert to currency of last product in cart option, this setting will allow you to convert the product price and change the currency of all products in the cart to that of the first product.

So if the currency of the first product in your cart is Pound Sterling, then this setting will change the currencies of all other products in the cart to Pound sterling. Also, it will convert the product prices of all products as per Pound sterling exchange rate.

Setting Convert to currency of first product in cart option

To understand this better, consider the same above example where product Choco lava cake with currency Malaysian Ringgit is the first product in the cart. The second product in the cart is Canon Camera Lens whose currency is Euros.

So when you set the Cart and checkout behaviour to Convert to currency of first product in cart option, the Canon Camera Lens product price will get converted and currency will show in Malaysian Ringgit. This change takes place on Cart and Checkout page.

Cart page

Currency and price change on Cart page 

Checkout page

Currency and price change on Checkout page 

This way you can have same currency for all products in your cart. It makes payment process easy and convenient for shop owners as well as customers.

Note – Order currency will be converted either to shop default currency or to the currency of some product in cart depending on what is selected in Cart and Checkout Behaviour option. It is not possible to have an order in different currencies simultaneously.

When you enable this option, then the original price of the product will be displayed in Emails and on the Cart & Checkout pages. If your ‘Shop behaviour’ option is set to ‘Show prices in different curriences’ then this setting will be ignored. 

After enabling it, you can make changes to the original price template using values such as %price%, %price_raw%, %currency_code%. By default, the template will have <br>%price% inserted in it. 

For instance, let’s say that for a product called a T-shirt, you have set the product currency as Indian Rupees (INR). If you have enabled this setting, then here’s how the Cart page will appear once the product has been added:

As you can see, the original price which is ₹ 800 will also appear with the converted price. Similarly, the Checkout page will also have the same price as the Cart Page:

Finally, the email that your customer will receive will also have the original price as you can see in the below image:

Reset settings will allow you to reset the Shop as well as Cart and Checkout Behaviour options to its default settings. In order to do so, tick the Reset checkbox of Reset section settings and click on Save changes button.

Reset Settings option

So when you reset the Behaviour settings, the following action will take place:

1. Shop behaviour will be set to Show prices in different currencies (and set cart and checkout behaviour separately) option.
2. Add original price in shop will be disabled and original price template will show <br>%price%
3. Cart and checkout behaviour will show Convert to shop default currency option.
4. Message for Leave product currency (allow only one product to be added to cart) will be Only one product can be added to the cart. Clear the cart or finish the order, before adding another product to the cart.
5. Message for Leave product currency (allow only same currency products to be added to cart) will be Only products with same currency can be added to the cart. Clear the cart or finish the order, before adding products with another currency to the cart.

There will be an impact on the front end as well, when you reset the Behaviour settings.

For instance, say you had selected the Convert to shop default currency (including cart and checkout) option for Shop behaviour setting. Hence the front end will be displaying converted prices in base currency.

But when you reset the Behaviour settings, Shop behaviour setting will be set to Show prices in different currencies (and set cart and checkout behaviour separately). Therefore product prices in different currencies will be displayed on the front end instead of base currency.

The Behaviour settings of Currency per Product for WooCommerce Pro plugin help you to set and display product prices in different currencies on the shop, cart, and checkout pages. Sometimes you need to show converted prices as per the selected currency on these pages.

Therefore we need to use the Exchange rates settings to show converted product prices on your online store.

To understand Exchange Rates settings, go to WooCommerce -> Settings -> Currency per Product -> Exchange Rates link.

The default Exchange Rates settings page appears as shown below:

This page consists of 3 sections:

1. Exchange Rate Options
2. Exchange Rates
3. Reset Settings

There are 3 Exchange rate options which together help you to set the exchange rate updates automatically.

Exchange Rates options

Exchange rates updates

There are 2 ways in which you can update the exchange rates – Automatically and Manually.

Selecting option from the dropdown

When you select Update rates automatically option and click the Save changes button, Update Rates Now button will appear.

You can click on this button to update the exchange rates automatically.

This exchange rates update will take place automatically depending upon the Update rate option set.

You can select to update the exchange rates manually by clicking the Enter rates manually option from the Exchange rates updates dropdown.

When you do so, you will be able to add an exchange rate for the currency manually under the Exchange Rates section.

Enter exchange rates manually

The default option for this setting is Enter rates manually.

Update rate

This setting lets you select how often currency exchange rates should be updated. When you set the Exchange rates updates option to Update rates automatically, Update rate options will be applicable.

There are 3 options under Update rate dropdown. You can choose to update the exchange rates daily, hourly, or twice daily.

Update rate dropdown

If you select the Update Daily option, the exchange rates update will take place at the same time every day.

Similarly, when you select the option Update Hourly, the exchange rate will automatically update every hour and when you select Update Twice Daily, the update will take place twice a day.

There is an indication of the number of hours remaining until the next update under the Exchange rates updates dropdown.

Time remaining for the next update

The default option for the Update rate setting is Update Daily.

Update server

It allows you to select a server for updating the currency exchange rates.

There are 3 servers to select from the Update server dropdown – European Central Bank, TCMB, Free Currency Converter API (free.currencyconverterapi.com), Coinbase and CoinMarketCap (for Cryptocurrencies).

Update server dropdown

By default, the server selected is European Central Bank.

If you choose Free Currency Converter API then you can fill in the API Key in the Free Currency Converter API Key setting as shown below:

Entering API Key

If you wish to add the exchange rate server for cryptocurrency, then choose CoinMarketCap (for Cryptocurrencies) as shown below:

Next, you can fill in the API Key in the CoinMarketCap API Key setting.

In order to find the API Key, login to your account here: https://pro.coinmarketcap.com/login/ 

Find the key under the Dashboard:

Copy it, paste it into the settings, and click Save Changes.

Additional/Discount Exchange Fees Types On Automatic Exchange Rates

With this setting, you can automatically allow additions or deductions to be calculated for your Exchange rate currency. 

Please note that this setting will only work when the ‘Update rates automatically’ is selected in the ‘Exchange rates updates’ setting,

Once you choose to go with this setting, the dropdown will give you four options. They are: 

Fee Types options

You choose to provide the additions by using either ‘Markup with Flat Rates’ or ‘Markup with Percentage’ options. 

Additional exchange fee types

If you wish to provide deductions, then you can either choose ‘Discount with Flat Rates’ or ‘Discount with Percentage’ options. 

Discount exchange fee types

After choosing, you will have to enter the Additional/Discount Exchange Fee. Enter it in the field right beside the setting name as shown below:

Entering the exchange fee

For instance, let’s say that you wish to charge a 10% additional fee on the exchange rate. For this, you will select (+) Markup with Percentage from the dropdown and enter the exchange rate as 10: 

Example of Markup with Percentage Fee Type

Save these settings. On the frontend, when your customer has selected a product then they will see:

Product Page price

Let us see how it was calculated:

1 USD Rate for INR is 77.79. 

The Exchange Fees is set to 10.

The Product Price in INR is 1000.

Thus, the calculation takes place like this using the formula

= { ( 1 / ( Exchange rate + percentage of exchange ) } * price

= { ( 1 / ( 77.79 + 7.77 ) } * 1000

= 0.01168 * 1000

USD Price = 11.687704 or 11.69

Frontend behaviour

Let us look at another example. 

Let’s say that you wish to provide a discount of 20 on the exchange rate. For this, you will select (-) Discount with Flat Rate from the dropdown and enter the exchange rate as 20. 

Example of Discount with Flat Rates Fee Type

The calculation will be as follows: 

1 USD Rate for INR is 77.79.

The Exchange Fees is set to 20.

The Product Price in INR is 1000.

Thus, the calculation takes place like this using the formula

= { ( 1 / ( Exchange rate – discount of exchange ) } * price

= { ( 1 / ( 77.79 – 20 ) } * 1000

= 0.01730 * 1000

USD Price = 17.3040

Frontend behaviour

In a similar manner, for discount with percentage, you will subtract the percentage from the exchange rate in the formula and add the flat rate to the exchange rate if it is Markup with Flat Rates setting.

This section allows you to enter exchange rates manually for all currencies listed. All currencies that you add on the Currencies settings page will appear under the Exchange Rates section.

This part will be effective when you select the Enter rates manually option for the Exchange rates updates setting.

Exchange Rates section

Remember that Exchange rate options will only be applicable if one of the options under the Behaviour settings page is set to Convert to Shop default currency option or if you enable the Sorting by converted price or Filtering by converted price option on the Advanced Settings page.

This setting allows you to reset the Exchange Rates Options and Exchange Rates section to its default value.

For this, click on the Reset checkbox of the Reset section settings and click the Save changes button.

Reset Settings option

This will reset the Exchange rates updates to Enter rates manually option, Update rate to Update Daily option, and Update server to European Central Bank (ECB).

In the Exchange Rates section, the base currency and additional currencies added under the Currencies settings page will appear with the value 1 set for all currencies.

Advanced settings of Currency per Product for WooCommerce Pro plugin allows you to fix the mini cart issue or sort and filter products by converted prices or re-calculate prices for the products.

Let us understand the different options under Advanced Settings. To go to Advanced Settings page, follow the path WooCommerce -> Settings -> Currency per Product -> Advanced link. The default Advanced settings page appears as shown below:

Default Advanced settings page

This page consists of 3 sections:

1. Advanced Options
2. Tools
3. Reset Settings

Under this section you can enable various settings as per the requirements. Let us understand each of these in detail.

Fix mini cart

A mini cart is a widget that usually appears in the upper-right corner of the Shop page. The mini cart displays selected products in the cart with its details and shows options to either View full cart or Go to Checkout.

Mini cart on Shop page

So when you enable the Fix mini cart option under Advanced Options, it will recalculate the cart total on each page load and fix any currrency symbol issue in mini cart.

Enabling the Fix mini cart option

By default, this option is disabled.

Sorting by converted price

A product price when calculated using the exchange rate of the currency is called the converted price of the product. So when you enable Sorting by converted price option, the ‘Sort by price’ sorting on the Shop page will be done using the converted price of the product.

Enabling the Sorting by converted price option

Therefore say the shop’s default currency (base currency) is set to Pound sterling and the products are set to Indian rupee. Hence, as per the exchange rate of Indian rupee, the product prices will be converted and sorting of all WooCommerce products will take place on the Shop page using this converted price.

Say for instance, you select Sort by Price:low to high, then all products will appear in ascending order starting with products having lower price.

Sorting as per converted price

By default, Sorting by converted price option is disabled.

Filtering by converted price

Similarly, you can also filter products on the front end as per converted price. To do so, you can enable the Filtering by converted price option.

Enabling the option

When you select the price range on the Filter by price widget, the products will be filtered as per converted prices as shown below:

Filtering as per converted price

By default, Filtering by converted price option is disabled.

Save products prices

Many a times, you use different plugins for your online store. But due to compatibility issues, the prices on the store may be displayed inaccurately. Therefore when you enable Save product prices option, the prices are converted only once and displayed on the store.

This way you can ensure that multiple calculations do not occur when other plugins are used. By default, this option is disabled.

There are some advanced tools in this plugin which allows you to re-calculate product prices for sorting and filtering purpose and delete plugin’s data if required.

Advanced tools

Re-calculate prices

This option allows you to re-calculate product prices automatically and manually. You can re-calculate (convert) all product prices and save them to use in Sort by Price sorting and Filter Products by Price widget using this option.

Re-calculation take place automatically either when a product is saved or when a scheduled exchange rates update occurs or periodically which is 58 mins until the next update. But if you wish to re-calculate prices manually then you can do so by clicking the Re-calculate prices button. This will re-calculate product prices at that moment.

Delete all plugin’s data

This option will allow you to delete all the stored data of the plugin from the database like plugin’s options and products meta. When you click the Delete all plugin’s data button, it will delete all the data permanently which will not be retrieved using any undo action. Hence it is necessary to be careful while using this option.

This setting allows you to reset the Advanced Options settings to its default value. To do so, tick the Reset checkbox of Reset section settings.

Reset section settings 

This will disable all the settings under Advanced Options section, if enabled. It will not be applicable for Tools section as these have buttons to perform the action and are independent of all settings. However, the Reset setting will have an impact on the front end. For instance, say you have enabled the option Sorting by converted price and so the products were sorted on the front end. Now when you reset the Advanced settings, this option will be disabled and sorting of products will not take place on the front end.